diff --git a/src/Layers/Generated.php b/src/Layers/Generated.php index aebaeb3..cde461b 100644 --- a/src/Layers/Generated.php +++ b/src/Layers/Generated.php @@ -66,6 +66,7 @@ use Telepath\Telegram\Update; use Telepath\Telegram\User; use Telepath\Telegram\UserChatBoosts; +use Telepath\Telegram\UserProfileAudios; use Telepath\Telegram\UserProfilePhotos; use Telepath\Telegram\WebhookInfo; use Telepath\Types\Enums\ChatActionType; @@ -953,7 +954,7 @@ public function sendPoll( * @param bool $protect_content Protects the contents of the sent message from forwarding and saving * @param string $message_effect_id Unique identifier of the message effect to be added to the message * @param ReplyParameters $reply_parameters A JSON-serialized object for description of the message to reply to - * @param InlineKeyboardMarkup $reply_markup A JSON-serialized object for an inline keyboard + * @param InlineKeyboardMarkup $reply_markup A JSON-serialized object for an inline keyboard * * @throws TelegramException */ @@ -1006,7 +1007,7 @@ public function sendDice( } /** - * 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. + * Use this method to stream a partial message to a user while the message is being generated. Returns True on success. * * @param int $chat_id Unique identifier for the target private chat * @param int $draft_id Unique identifier of the message draft; must be non-zero. Changes of drafts with the same identifier are animated @@ -1080,6 +1081,20 @@ public function getUserProfilePhotos(int $user_id, ?int $offset = null, ?int $li return $this->raw('getUserProfilePhotos', func_get_args()); } + /** + * Use this method to get a list of profile audios for a user. Returns a UserProfileAudios object. + * + * @param int $user_id Unique identifier of the target user + * @param int $offset Sequential number of the first audio to be returned. By default, all audios are returned. + * @param int $limit Limits the number of audios to be retrieved. Values between 1-100 are accepted. Defaults to 100. + * + * @throws TelegramException + */ + public function getUserProfileAudios(int $user_id, ?int $offset = null, ?int $limit = null): UserProfileAudios + { + return $this->raw('getUserProfileAudios', func_get_args()); + } + /** * Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess. Returns True on success. * @@ -1184,6 +1199,7 @@ public function restrictChatMember( * @param bool $can_pin_messages Pass True if the administrator can pin messages; for supergroups only * @param bool $can_manage_topics Pass True if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only * @param bool $can_manage_direct_messages Pass True if the administrator can manage direct messages within the channel and decline suggested posts; for channels only + * @param bool $can_manage_tags Pass True if the administrator can edit the tags of regular members; for groups and supergroups only * * @throws TelegramException */ @@ -1206,6 +1222,7 @@ public function promoteChatMember( ?bool $can_pin_messages = null, ?bool $can_manage_topics = null, ?bool $can_manage_direct_messages = null, + ?bool $can_manage_tags = null, ): bool { return $this->raw('promoteChatMember', func_get_args()); } @@ -1224,6 +1241,20 @@ public function setChatAdministratorCustomTitle(int|string $chat_id, int $user_i return $this->raw('setChatAdministratorCustomTitle', func_get_args()); } + /** + * Use this method to set a tag for a regular member in a group or a supergroup. The bot must be an administrator in the chat for this to work and must have the can_manage_tags administrator right. Returns True on success. + * + * @param int|string $chat_id Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) + * @param int $user_id Unique identifier of the target user + * @param string $tag New tag for the member; 0-16 characters, emoji are not allowed + * + * @throws TelegramException + */ + public function setChatMemberTag(int|string $chat_id, int $user_id, ?string $tag = null): bool + { + return $this->raw('setChatMemberTag', func_get_args()); + } + /** * Use this method to ban a channel chat in a supergroup or a channel. Until the chat is unbanned, the owner of the banned chat won't be able to send messages on behalf of any of their channels. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns True on success. * @@ -1597,7 +1628,7 @@ public function getForumTopicIconStickers(): array } /** - * Use this method to create 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. Returns information about the created topic as a ForumTopic object. + * Use this method to create 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 right. Returns information about the created topic as a ForumTopic object. * * @param int|string $chat_id Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) * @param string $name Topic name, 1-128 characters @@ -1924,6 +1955,18 @@ public function getMyShortDescription(?string $language_code = null): BotShortDe return $this->raw('getMyShortDescription', func_get_args()); } + /** + * Changes the profile photo of the bot. Returns True on success. + * + * @param InputProfilePhoto $photo The new profile photo to set + * + * @throws TelegramException + */ + public function setMyProfilePhoto(InputProfilePhoto $photo): bool + { + return $this->raw('setMyProfilePhoto', func_get_args()); + } + /** * Use this method to change the bot's menu button in a private chat, or the default menu button. Returns True on success. * @@ -2594,7 +2637,7 @@ public function stopMessageLiveLocation( * @param int $chat_id Unique identifier for the target chat * @param int $message_id Unique identifier for the target message * @param InputChecklist $checklist A JSON-serialized object for the new checklist - * @param InlineKeyboardMarkup $reply_markup A JSON-serialized object for the new inline keyboard for the message + * @param InlineKeyboardMarkup $reply_markup A JSON-serialized object for the new inline keyboard for the message * * @throws TelegramException */ diff --git a/src/Telegram/ChatAdministratorRights.php b/src/Telegram/ChatAdministratorRights.php index 301f67c..81be26f 100644 --- a/src/Telegram/ChatAdministratorRights.php +++ b/src/Telegram/ChatAdministratorRights.php @@ -61,6 +61,9 @@ class ChatAdministratorRights extends Type /** Optional. True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only */ public ?bool $can_manage_direct_messages = null; + /** Optional. True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can_pin_messages. */ + public ?bool $can_manage_tags = null; + /** * @param bool $is_anonymous True, if the user's presence in the chat is hidden * @param bool $can_manage_chat True, if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages, ignore slow mode, and send messages to the chat without paying Telegram Stars. Implied by any other administrator privilege. @@ -78,6 +81,7 @@ class ChatAdministratorRights extends Type * @param bool $can_pin_messages Optional. True, if the user is allowed to pin messages; for groups and supergroups only * @param bool $can_manage_topics Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only * @param bool $can_manage_direct_messages Optional. True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only + * @param bool $can_manage_tags Optional. True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can_pin_messages. */ public static function make( bool $is_anonymous, @@ -96,6 +100,7 @@ public static function make( ?bool $can_pin_messages = null, ?bool $can_manage_topics = null, ?bool $can_manage_direct_messages = null, + ?bool $can_manage_tags = null, ): static { return new static([ 'is_anonymous' => $is_anonymous, @@ -114,6 +119,7 @@ public static function make( 'can_pin_messages' => $can_pin_messages, 'can_manage_topics' => $can_manage_topics, 'can_manage_direct_messages' => $can_manage_direct_messages, + 'can_manage_tags' => $can_manage_tags, ]); } } diff --git a/src/Telegram/ChatFullInfo.php b/src/Telegram/ChatFullInfo.php index 2c092b6..a49f494 100644 --- a/src/Telegram/ChatFullInfo.php +++ b/src/Telegram/ChatFullInfo.php @@ -165,6 +165,9 @@ class ChatFullInfo extends Type /** Optional. For private chats, the rating of the user if any */ public ?UserRating $rating = null; + /** Optional. For private chats, the first audio added to the profile of the user */ + public ?Audio $first_profile_audio = null; + /** Optional. The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews */ public ?UniqueGiftColors $unique_gift_colors = null; @@ -220,6 +223,7 @@ class ChatFullInfo extends Type * @param int $linked_chat_id Optional. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. This identifier may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier. * @param ChatLocation $location Optional. For supergroups, the location to which the supergroup is connected * @param UserRating $rating Optional. For private chats, the rating of the user if any + * @param Audio $first_profile_audio Optional. For private chats, the first audio added to the profile of the user * @param UniqueGiftColors $unique_gift_colors Optional. The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews * @param int $paid_message_star_count Optional. The number of Telegram Stars a general user have to pay to send a message to the chat */ @@ -272,6 +276,7 @@ public static function make( ?int $linked_chat_id = null, ?ChatLocation $location = null, ?UserRating $rating = null, + ?Audio $first_profile_audio = null, ?UniqueGiftColors $unique_gift_colors = null, ?int $paid_message_star_count = null, ): static { @@ -324,6 +329,7 @@ public static function make( 'linked_chat_id' => $linked_chat_id, 'location' => $location, 'rating' => $rating, + 'first_profile_audio' => $first_profile_audio, 'unique_gift_colors' => $unique_gift_colors, 'paid_message_star_count' => $paid_message_star_count, ]); diff --git a/src/Telegram/ChatMemberAdministrator.php b/src/Telegram/ChatMemberAdministrator.php index a471fc9..925b380 100644 --- a/src/Telegram/ChatMemberAdministrator.php +++ b/src/Telegram/ChatMemberAdministrator.php @@ -65,6 +65,9 @@ class ChatMemberAdministrator extends ChatMember /** Optional. True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only */ public ?bool $can_manage_direct_messages = null; + /** Optional. True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can_pin_messages. */ + public ?bool $can_manage_tags = null; + /** Optional. Custom title for this user */ public ?string $custom_title = null; @@ -87,6 +90,7 @@ class ChatMemberAdministrator extends ChatMember * @param bool $can_pin_messages Optional. True, if the user is allowed to pin messages; for groups and supergroups only * @param bool $can_manage_topics Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only * @param bool $can_manage_direct_messages Optional. True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only + * @param bool $can_manage_tags Optional. True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can_pin_messages. * @param string $custom_title Optional. Custom title for this user */ public static function make( @@ -108,6 +112,7 @@ public static function make( ?bool $can_pin_messages = null, ?bool $can_manage_topics = null, ?bool $can_manage_direct_messages = null, + ?bool $can_manage_tags = null, ?string $custom_title = null, ): static { return new static([ @@ -129,6 +134,7 @@ public static function make( 'can_pin_messages' => $can_pin_messages, 'can_manage_topics' => $can_manage_topics, 'can_manage_direct_messages' => $can_manage_direct_messages, + 'can_manage_tags' => $can_manage_tags, 'custom_title' => $custom_title, ]); } diff --git a/src/Telegram/ChatMemberMember.php b/src/Telegram/ChatMemberMember.php index 8e147cf..19b1fa7 100644 --- a/src/Telegram/ChatMemberMember.php +++ b/src/Telegram/ChatMemberMember.php @@ -14,17 +14,22 @@ class ChatMemberMember extends ChatMember /** The member's status in the chat, always “member” */ public string $status = 'member'; + /** Optional. Tag of the member */ + public ?string $tag = null; + /** Optional. Date when the user's subscription will expire; Unix time */ public ?int $until_date = null; /** * @param User $user Information about the user + * @param string $tag Optional. Tag of the member * @param int $until_date Optional. Date when the user's subscription will expire; Unix time */ - public static function make(User $user, ?int $until_date = null): static + public static function make(User $user, ?string $tag = null, ?int $until_date = null): static { return new static([ 'user' => $user, + 'tag' => $tag, 'until_date' => $until_date, ]); } diff --git a/src/Telegram/ChatMemberRestricted.php b/src/Telegram/ChatMemberRestricted.php index d8cfece..4fcc19e 100644 --- a/src/Telegram/ChatMemberRestricted.php +++ b/src/Telegram/ChatMemberRestricted.php @@ -47,6 +47,9 @@ class ChatMemberRestricted extends ChatMember /** True, if the user is allowed to add web page previews to their messages */ public bool $can_add_web_page_previews; + /** True, if the user is allowed to edit their own tag */ + public bool $can_edit_tag; + /** True, if the user is allowed to change the chat title, photo and other settings */ public bool $can_change_info; @@ -62,6 +65,9 @@ class ChatMemberRestricted extends ChatMember /** Date when restrictions will be lifted for this user; Unix time. If 0, then the user is restricted forever */ public int $until_date; + /** Optional. Tag of the member */ + public ?string $tag = null; + /** * @param User $user Information about the user * @param bool $is_member True, if the user is a member of the chat at the moment of the request @@ -75,11 +81,13 @@ class ChatMemberRestricted extends ChatMember * @param bool $can_send_polls True, if the user is allowed to send polls and checklists * @param bool $can_send_other_messages True, if the user is allowed to send animations, games, stickers and use inline bots * @param bool $can_add_web_page_previews True, if the user is allowed to add web page previews to their messages + * @param bool $can_edit_tag True, if the user is allowed to edit their own tag * @param bool $can_change_info True, if the user is allowed to change the chat title, photo and other settings * @param bool $can_invite_users True, if the user is allowed to invite new users to the chat * @param bool $can_pin_messages True, if the user is allowed to pin messages * @param bool $can_manage_topics True, if the user is allowed to create forum topics * @param int $until_date Date when restrictions will be lifted for this user; Unix time. If 0, then the user is restricted forever + * @param string $tag Optional. Tag of the member */ public static function make( User $user, @@ -94,11 +102,13 @@ public static function make( bool $can_send_polls, bool $can_send_other_messages, bool $can_add_web_page_previews, + bool $can_edit_tag, bool $can_change_info, bool $can_invite_users, bool $can_pin_messages, bool $can_manage_topics, int $until_date, + ?string $tag = null, ): static { return new static([ 'user' => $user, @@ -113,11 +123,13 @@ public static function make( 'can_send_polls' => $can_send_polls, 'can_send_other_messages' => $can_send_other_messages, 'can_add_web_page_previews' => $can_add_web_page_previews, + 'can_edit_tag' => $can_edit_tag, 'can_change_info' => $can_change_info, 'can_invite_users' => $can_invite_users, 'can_pin_messages' => $can_pin_messages, 'can_manage_topics' => $can_manage_topics, 'until_date' => $until_date, + 'tag' => $tag, ]); } } diff --git a/src/Telegram/ChatOwnerChanged.php b/src/Telegram/ChatOwnerChanged.php new file mode 100644 index 0000000..5d858b2 --- /dev/null +++ b/src/Telegram/ChatOwnerChanged.php @@ -0,0 +1,28 @@ + $new_owner, + ]); + } +} diff --git a/src/Telegram/ChatOwnerLeft.php b/src/Telegram/ChatOwnerLeft.php new file mode 100644 index 0000000..5dd421f --- /dev/null +++ b/src/Telegram/ChatOwnerLeft.php @@ -0,0 +1,28 @@ +Optional. The user which will be the new owner of the chat if the previous owner does not return to the chat */ + public ?User $new_owner = null; + + /** + * @param User $new_owner Optional. The user which will be the new owner of the chat if the previous owner does not return to the chat + */ + public static function make(?User $new_owner = null): static + { + return new static([ + 'new_owner' => $new_owner, + ]); + } +} diff --git a/src/Telegram/ChatPermissions.php b/src/Telegram/ChatPermissions.php index 06147aa..bca401a 100644 --- a/src/Telegram/ChatPermissions.php +++ b/src/Telegram/ChatPermissions.php @@ -43,6 +43,9 @@ class ChatPermissions extends Type /** Optional. True, if the user is allowed to add web page previews to their messages */ public ?bool $can_add_web_page_previews = null; + /** Optional. True, if the user is allowed to edit their own tag */ + public ?bool $can_edit_tag = null; + /** Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups */ public ?bool $can_change_info = null; @@ -66,6 +69,7 @@ class ChatPermissions extends Type * @param bool $can_send_polls Optional. True, if the user is allowed to send polls and checklists * @param bool $can_send_other_messages Optional. True, if the user is allowed to send animations, games, stickers and use inline bots * @param bool $can_add_web_page_previews Optional. True, if the user is allowed to add web page previews to their messages + * @param bool $can_edit_tag Optional. True, if the user is allowed to edit their own tag * @param bool $can_change_info Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups * @param bool $can_invite_users Optional. True, if the user is allowed to invite new users to the chat * @param bool $can_pin_messages Optional. True, if the user is allowed to pin messages. Ignored in public supergroups @@ -82,6 +86,7 @@ public static function make( ?bool $can_send_polls = null, ?bool $can_send_other_messages = null, ?bool $can_add_web_page_previews = null, + ?bool $can_edit_tag = null, ?bool $can_change_info = null, ?bool $can_invite_users = null, ?bool $can_pin_messages = null, @@ -98,6 +103,7 @@ public static function make( 'can_send_polls' => $can_send_polls, 'can_send_other_messages' => $can_send_other_messages, 'can_add_web_page_previews' => $can_add_web_page_previews, + 'can_edit_tag' => $can_edit_tag, 'can_change_info' => $can_change_info, 'can_invite_users' => $can_invite_users, 'can_pin_messages' => $can_pin_messages, diff --git a/src/Telegram/InlineKeyboardButton.php b/src/Telegram/InlineKeyboardButton.php index 9eb9f71..77dbf64 100644 --- a/src/Telegram/InlineKeyboardButton.php +++ b/src/Telegram/InlineKeyboardButton.php @@ -9,13 +9,19 @@ use Telepath\Types\Type; /** - * This object represents one button of an inline keyboard. Exactly one of the optional fields must be used to specify type of the button. + * This object represents one button of an inline keyboard. Exactly one of the fields other than text, icon_custom_emoji_id, and style must be used to specify the type of the button. */ class InlineKeyboardButton extends Type { /** Label text on the button */ public string $text; + /** Optional. Unique identifier of the custom emoji shown before the text of the button. Can only be used by bots that purchased additional usernames on Fragment or in the messages directly sent by the bot to private, group and supergroup chats if the owner of the bot has a Telegram Premium subscription. */ + public ?string $icon_custom_emoji_id = null; + + /** Optional. Style of the button. Must be one of “danger” (red), “success” (green) or “primary” (blue). If omitted, then an app-specific style is used. */ + public ?string $style = null; + /** Optional. HTTP or tg:// URL to be opened when the button is pressed. Links tg://user?id= can be used to mention a user by their identifier without using a username, if this is allowed by their privacy settings. */ public ?string $url = null; @@ -48,6 +54,8 @@ class InlineKeyboardButton extends Type /** * @param string $text Label text on the button + * @param string $icon_custom_emoji_id Optional. Unique identifier of the custom emoji shown before the text of the button. Can only be used by bots that purchased additional usernames on Fragment or in the messages directly sent by the bot to private, group and supergroup chats if the owner of the bot has a Telegram Premium subscription. + * @param string $style Optional. Style of the button. Must be one of “danger” (red), “success” (green) or “primary” (blue). If omitted, then an app-specific style is used. * @param string $url Optional. HTTP or tg:// URL to be opened when the button is pressed. Links tg://user?id= can be used to mention a user by their identifier without using a username, if this is allowed by their privacy settings. * @param string $callback_data Optional. Data to be sent in a callback query to the bot when the button is pressed, 1-64 bytes * @param WebAppInfo $web_app Optional. Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Available only in private chats between a user and the bot. Not supported for messages sent on behalf of a Telegram Business account. @@ -61,6 +69,8 @@ class InlineKeyboardButton extends Type */ public static function make( string $text, + ?string $icon_custom_emoji_id = null, + ?string $style = null, ?string $url = null, ?string $callback_data = null, ?WebAppInfo $web_app = null, @@ -74,6 +84,8 @@ public static function make( ): static { return new static([ 'text' => $text, + 'icon_custom_emoji_id' => $icon_custom_emoji_id, + 'style' => $style, 'url' => $url, 'callback_data' => $callback_data, 'web_app' => $web_app, diff --git a/src/Telegram/InlineQueryResultDocument.php b/src/Telegram/InlineQueryResultDocument.php index e1b9c88..a5bc0c6 100644 --- a/src/Telegram/InlineQueryResultDocument.php +++ b/src/Telegram/InlineQueryResultDocument.php @@ -60,7 +60,7 @@ class InlineQueryResultDocument extends InlineQueryResult * @param string $parse_mode Optional. Mode for parsing entities in the document caption. See formatting options for more details. * @param MessageEntity[] $caption_entities Optional. List of special entities that appear in the caption, which can be specified instead of parse_mode * @param string $description Optional. Short description of the result - * @param InlineKeyboardMarkup $reply_markup Optional. Inline keyboard attached to the message + * @param InlineKeyboardMarkup $reply_markup Optional. Inline keyboard attached to the message * @param InputMessageContent $input_message_content Optional. Content of the message to be sent instead of the file * @param string $thumbnail_url Optional. URL of the thumbnail (JPEG only) for the file * @param int $thumbnail_width Optional. Thumbnail width diff --git a/src/Telegram/KeyboardButton.php b/src/Telegram/KeyboardButton.php index 7d6e3e7..38a203d 100644 --- a/src/Telegram/KeyboardButton.php +++ b/src/Telegram/KeyboardButton.php @@ -9,13 +9,19 @@ use Telepath\Types\Type; /** - * This object represents one button of the reply keyboard. At most one of the optional fields must be used to specify type of the button. For simple text buttons, String can be used instead of this object to specify the button text. + * This object represents one button of the reply keyboard. At most one of the fields other than text, icon_custom_emoji_id, and style must be used to specify the type of the button. For simple text buttons, String can be used instead of this object to specify the button text. */ class KeyboardButton extends Type { - /** Text of the button. If none of the optional fields are used, it will be sent as a message when the button is pressed */ + /** Text of the button. If none of the fields other than text, icon_custom_emoji_id, and style are used, it will be sent as a message when the button is pressed */ public string $text; + /** Optional. Unique identifier of the custom emoji shown before the text of the button. Can only be used by bots that purchased additional usernames on Fragment or in the messages directly sent by the bot to private, group and supergroup chats if the owner of the bot has a Telegram Premium subscription. */ + public ?string $icon_custom_emoji_id = null; + + /** Optional. Style of the button. Must be one of “danger” (red), “success” (green) or “primary” (blue). If omitted, then an app-specific style is used. */ + public ?string $style = null; + /** Optional. If specified, pressing the button will open a list of suitable users. Identifiers of selected users will be sent to the bot in a “users_shared” service message. Available in private chats only. */ public ?KeyboardButtonRequestUsers $request_users = null; @@ -35,7 +41,9 @@ class KeyboardButton extends Type public ?WebAppInfo $web_app = null; /** - * @param string $text Text of the button. If none of the optional fields are used, it will be sent as a message when the button is pressed + * @param string $text Text of the button. If none of the fields other than text, icon_custom_emoji_id, and style are used, it will be sent as a message when the button is pressed + * @param string $icon_custom_emoji_id Optional. Unique identifier of the custom emoji shown before the text of the button. Can only be used by bots that purchased additional usernames on Fragment or in the messages directly sent by the bot to private, group and supergroup chats if the owner of the bot has a Telegram Premium subscription. + * @param string $style Optional. Style of the button. Must be one of “danger” (red), “success” (green) or “primary” (blue). If omitted, then an app-specific style is used. * @param KeyboardButtonRequestUsers $request_users Optional. If specified, pressing the button will open a list of suitable users. Identifiers of selected users will be sent to the bot in a “users_shared” service message. Available in private chats only. * @param KeyboardButtonRequestChat $request_chat Optional. If specified, pressing the button will open a list of suitable chats. Tapping on a chat will send its identifier to the bot in a “chat_shared” service message. Available in private chats only. * @param bool $request_contact Optional. If True, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only. @@ -45,6 +53,8 @@ class KeyboardButton extends Type */ public static function make( string $text, + ?string $icon_custom_emoji_id = null, + ?string $style = null, ?KeyboardButtonRequestUsers $request_users = null, ?KeyboardButtonRequestChat $request_chat = null, ?bool $request_contact = null, @@ -54,6 +64,8 @@ public static function make( ): static { return new static([ 'text' => $text, + 'icon_custom_emoji_id' => $icon_custom_emoji_id, + 'style' => $style, 'request_users' => $request_users, 'request_chat' => $request_chat, 'request_contact' => $request_contact, diff --git a/src/Telegram/Message.php b/src/Telegram/Message.php index 251723e..d88be6f 100644 --- a/src/Telegram/Message.php +++ b/src/Telegram/Message.php @@ -33,6 +33,9 @@ class Message extends MaybeInaccessibleMessage /** Optional. The bot that actually sent the message on behalf of the business account. Available only for outgoing messages sent on behalf of the connected business account. */ public ?User $sender_business_bot = null; + /** Optional. Tag or custom title of the sender of the message; for supergroups only */ + public ?string $sender_tag = null; + /** Optional. Unique identifier of the business connection from which the message was received. If non-empty, the message belongs to a chat of the corresponding business account that is independent from any potential bot chat which might share the same identifier. */ public ?string $business_connection_id = null; @@ -75,7 +78,7 @@ class Message extends MaybeInaccessibleMessage /** Optional. True, if the message is a paid post. Note that such posts must not be deleted for 24 hours to receive the payment and can't be edited. */ public ?bool $is_paid_post = null; - /** Optional. The unique identifier of a media message group this message belongs to */ + /** Optional. The unique identifier inside this chat of a media message group this message belongs to */ public ?string $media_group_id = null; /** Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator */ @@ -184,6 +187,12 @@ class Message extends MaybeInaccessibleMessage /** Optional. A member was removed from the group, information about them (this member may be the bot itself) */ public ?User $left_chat_member = null; + /** Optional. Service message: chat owner has left */ + public ?ChatOwnerLeft $chat_owner_left = null; + + /** Optional. Service message: chat owner has changed */ + public ?ChatOwnerChanged $chat_owner_changed = null; + /** Optional. A chat title was changed to this value */ public ?string $new_chat_title = null; @@ -332,7 +341,7 @@ class Message extends MaybeInaccessibleMessage /** Optional. Service message: data sent by a Web App */ public ?WebAppData $web_app_data = null; - /** Optional. Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons. */ + /** Optional. Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons. */ public ?InlineKeyboardMarkup $reply_markup = null; /** @@ -345,6 +354,7 @@ class Message extends MaybeInaccessibleMessage * @param Chat $sender_chat Optional. Sender of the message when sent on behalf of a chat. For example, the supergroup itself for messages sent by its anonymous administrators or a linked channel for messages automatically forwarded to the channel's discussion group. For backward compatibility, if the message was sent on behalf of a chat, the field from contains a fake sender user in non-channel chats. * @param int $sender_boost_count Optional. If the sender of the message boosted the chat, the number of boosts added by the user * @param User $sender_business_bot Optional. The bot that actually sent the message on behalf of the business account. Available only for outgoing messages sent on behalf of the connected business account. + * @param string $sender_tag Optional. Tag or custom title of the sender of the message; for supergroups only * @param string $business_connection_id Optional. Unique identifier of the business connection from which the message was received. If non-empty, the message belongs to a chat of the corresponding business account that is independent from any potential bot chat which might share the same identifier. * @param MessageOrigin $forward_origin Optional. Information about the original message for forwarded messages * @param bool $is_topic_message Optional. True, if the message is sent to a topic in a forum supergroup or a private chat with the bot @@ -359,7 +369,7 @@ class Message extends MaybeInaccessibleMessage * @param bool $has_protected_content Optional. True, if the message can't be forwarded * @param bool $is_from_offline Optional. True, if the message was sent by an implicit action, for example, as an away or a greeting business message, or as a scheduled message * @param bool $is_paid_post Optional. True, if the message is a paid post. Note that such posts must not be deleted for 24 hours to receive the payment and can't be edited. - * @param string $media_group_id Optional. The unique identifier of a media message group this message belongs to + * @param string $media_group_id Optional. The unique identifier inside this chat of a media message group this message belongs to * @param string $author_signature Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator * @param int $paid_star_count Optional. The number of Telegram Stars that were paid by the sender of the message to send it * @param string $text Optional. For text messages, the actual UTF-8 text of the message @@ -390,6 +400,8 @@ class Message extends MaybeInaccessibleMessage * @param Location $location Optional. Message is a shared location, information about the location * @param User[] $new_chat_members Optional. New members that were added to the group or supergroup and information about them (the bot itself may be one of these members) * @param User $left_chat_member Optional. A member was removed from the group, information about them (this member may be the bot itself) + * @param ChatOwnerLeft $chat_owner_left Optional. Service message: chat owner has left + * @param ChatOwnerChanged $chat_owner_changed Optional. Service message: chat owner has changed * @param string $new_chat_title Optional. A chat title was changed to this value * @param PhotoSize[] $new_chat_photo Optional. A chat photo was change to this value * @param bool $delete_chat_photo Optional. Service message: the chat photo was deleted @@ -438,7 +450,7 @@ class Message extends MaybeInaccessibleMessage * @param VideoChatEnded $video_chat_ended Optional. Service message: video chat ended * @param VideoChatParticipantsInvited $video_chat_participants_invited Optional. Service message: new participants invited to a video chat * @param WebAppData $web_app_data Optional. Service message: data sent by a Web App - * @param InlineKeyboardMarkup $reply_markup Optional. Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons. + * @param InlineKeyboardMarkup $reply_markup Optional. Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons. */ public static function make( int $message_id, @@ -450,6 +462,7 @@ public static function make( ?Chat $sender_chat = null, ?int $sender_boost_count = null, ?User $sender_business_bot = null, + ?string $sender_tag = null, ?string $business_connection_id = null, ?MessageOrigin $forward_origin = null, ?bool $is_topic_message = null, @@ -495,6 +508,8 @@ public static function make( ?Location $location = null, ?array $new_chat_members = null, ?User $left_chat_member = null, + ?ChatOwnerLeft $chat_owner_left = null, + ?ChatOwnerChanged $chat_owner_changed = null, ?string $new_chat_title = null, ?array $new_chat_photo = null, ?bool $delete_chat_photo = null, @@ -555,6 +570,7 @@ public static function make( 'sender_chat' => $sender_chat, 'sender_boost_count' => $sender_boost_count, 'sender_business_bot' => $sender_business_bot, + 'sender_tag' => $sender_tag, 'business_connection_id' => $business_connection_id, 'forward_origin' => $forward_origin, 'is_topic_message' => $is_topic_message, @@ -600,6 +616,8 @@ public static function make( 'location' => $location, 'new_chat_members' => $new_chat_members, 'left_chat_member' => $left_chat_member, + 'chat_owner_left' => $chat_owner_left, + 'chat_owner_changed' => $chat_owner_changed, 'new_chat_title' => $new_chat_title, 'new_chat_photo' => $new_chat_photo, 'delete_chat_photo' => $delete_chat_photo, diff --git a/src/Telegram/MessageEntity.php b/src/Telegram/MessageEntity.php index 48162f8..9f55dd6 100644 --- a/src/Telegram/MessageEntity.php +++ b/src/Telegram/MessageEntity.php @@ -13,7 +13,7 @@ */ class MessageEntity extends Type { - /** Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag or #hashtag@chatusername), “cashtag” ($USD or $USD@chatusername), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers) */ + /** Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag or #hashtag@chatusername), “cashtag” ($USD or $USD@chatusername), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers), or “date_time” (for formatted date and time) */ public string $type; /** Offset in UTF-16 code units to the start of the entity */ @@ -34,14 +34,22 @@ class MessageEntity extends Type /** Optional. For “custom_emoji” only, unique identifier of the custom emoji. Use getCustomEmojiStickers to get full information about the sticker */ public ?string $custom_emoji_id = null; + /** Optional. For “date_time” only, the Unix time associated with the entity */ + public ?int $unix_time = null; + + /** Optional. For “date_time” only, the string that defines the formatting of the date and time. See date-time entity formatting for more details. */ + public ?string $date_time_format = null; + /** - * @param string $type Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag or #hashtag@chatusername), “cashtag” ($USD or $USD@chatusername), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers) + * @param string $type Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag or #hashtag@chatusername), “cashtag” ($USD or $USD@chatusername), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers), or “date_time” (for formatted date and time) * @param int $offset Offset in UTF-16 code units to the start of the entity * @param int $length Length of the entity in UTF-16 code units * @param string $url Optional. For “text_link” only, URL that will be opened after user taps on the text * @param User $user Optional. For “text_mention” only, the mentioned user * @param string $language Optional. For “pre” only, the programming language of the entity text * @param string $custom_emoji_id Optional. For “custom_emoji” only, unique identifier of the custom emoji. Use getCustomEmojiStickers to get full information about the sticker + * @param int $unix_time Optional. For “date_time” only, the Unix time associated with the entity + * @param string $date_time_format Optional. For “date_time” only, the string that defines the formatting of the date and time. See date-time entity formatting for more details. */ public static function make( string $type, @@ -51,6 +59,8 @@ public static function make( ?User $user = null, ?string $language = null, ?string $custom_emoji_id = null, + ?int $unix_time = null, + ?string $date_time_format = null, ): static { return new static([ 'type' => $type, @@ -60,6 +70,8 @@ public static function make( 'user' => $user, 'language' => $language, 'custom_emoji_id' => $custom_emoji_id, + 'unix_time' => $unix_time, + 'date_time_format' => $date_time_format, ]); } } diff --git a/src/Telegram/UniqueGift.php b/src/Telegram/UniqueGift.php index b643b86..1c0e290 100644 --- a/src/Telegram/UniqueGift.php +++ b/src/Telegram/UniqueGift.php @@ -37,6 +37,9 @@ class UniqueGift extends Type /** Optional. True, if the original regular gift was exclusively purchaseable by Telegram Premium subscribers */ public ?bool $is_premium = null; + /** Optional. True, if the gift was used to craft another gift and isn't available anymore */ + public ?bool $is_burned = null; + /** Optional. True, if the gift is assigned from the TON blockchain and can't be resold or transferred in Telegram */ public ?bool $is_from_blockchain = null; @@ -55,6 +58,7 @@ class UniqueGift extends Type * @param UniqueGiftSymbol $symbol Symbol of the gift * @param UniqueGiftBackdrop $backdrop Backdrop of the gift * @param bool $is_premium Optional. True, if the original regular gift was exclusively purchaseable by Telegram Premium subscribers + * @param bool $is_burned Optional. True, if the gift was used to craft another gift and isn't available anymore * @param bool $is_from_blockchain Optional. True, if the gift is assigned from the TON blockchain and can't be resold or transferred in Telegram * @param UniqueGiftColors $colors Optional. The color scheme that can be used by the gift's owner for the chat's name, replies to messages and link previews; for business account gifts and gifts that are currently on sale only * @param Chat $publisher_chat Optional. Information about the chat that published the gift @@ -68,6 +72,7 @@ public static function make( UniqueGiftSymbol $symbol, UniqueGiftBackdrop $backdrop, ?bool $is_premium = null, + ?bool $is_burned = null, ?bool $is_from_blockchain = null, ?UniqueGiftColors $colors = null, ?Chat $publisher_chat = null, @@ -81,6 +86,7 @@ public static function make( 'symbol' => $symbol, 'backdrop' => $backdrop, 'is_premium' => $is_premium, + 'is_burned' => $is_burned, 'is_from_blockchain' => $is_from_blockchain, 'colors' => $colors, 'publisher_chat' => $publisher_chat, diff --git a/src/Telegram/UniqueGiftModel.php b/src/Telegram/UniqueGiftModel.php index ec9267a..e6a2bda 100644 --- a/src/Telegram/UniqueGiftModel.php +++ b/src/Telegram/UniqueGiftModel.php @@ -19,20 +19,25 @@ class UniqueGiftModel extends Type /** The sticker that represents the unique gift */ public Sticker $sticker; - /** The number of unique gifts that receive this model for every 1000 gifts upgraded */ - public int $rarity_per_mille; + /** The number of unique gifts that receive this model for every 1000 gift upgrades. Always 0 for crafted gifts. */ + public int $rarity_per_mille = 0; + + /** Optional. Rarity of the model if it is a crafted model. Currently, can be “uncommon”, “rare”, “epic”, or “legendary”. */ + public ?string $rarity = null; /** * @param string $name Name of the model * @param Sticker $sticker The sticker that represents the unique gift - * @param int $rarity_per_mille The number of unique gifts that receive this model for every 1000 gifts upgraded + * @param int $rarity_per_mille The number of unique gifts that receive this model for every 1000 gift upgrades. Always 0 for crafted gifts. + * @param string $rarity Optional. Rarity of the model if it is a crafted model. Currently, can be “uncommon”, “rare”, “epic”, or “legendary”. */ - public static function make(string $name, Sticker $sticker, int $rarity_per_mille): static + public static function make(string $name, Sticker $sticker, int $rarity_per_mille, ?string $rarity = null): static { return new static([ 'name' => $name, 'sticker' => $sticker, 'rarity_per_mille' => $rarity_per_mille, + 'rarity' => $rarity, ]); } } diff --git a/src/Telegram/User.php b/src/Telegram/User.php index a570b87..11188e9 100644 --- a/src/Telegram/User.php +++ b/src/Telegram/User.php @@ -55,6 +55,9 @@ class User extends Type /** Optional. True, if the bot has forum topic mode enabled in private chats. Returned only in getMe. */ public ?bool $has_topics_enabled = null; + /** Optional. True, if the bot allows users to create and delete topics in private chats. Returned only in getMe. */ + public ?bool $allows_users_to_create_topics = null; + /** * @param int $id Unique identifier for this user or bot. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier. * @param bool $is_bot True, if this user is a bot @@ -70,6 +73,7 @@ class User extends Type * @param bool $can_connect_to_business Optional. True, if the bot can be connected to a Telegram Business account to receive its messages. Returned only in getMe. * @param bool $has_main_web_app Optional. True, if the bot has a main Web App. Returned only in getMe. * @param bool $has_topics_enabled Optional. True, if the bot has forum topic mode enabled in private chats. Returned only in getMe. + * @param bool $allows_users_to_create_topics Optional. True, if the bot allows users to create and delete topics in private chats. Returned only in getMe. */ public static function make( int $id, @@ -86,6 +90,7 @@ public static function make( ?bool $can_connect_to_business = null, ?bool $has_main_web_app = null, ?bool $has_topics_enabled = null, + ?bool $allows_users_to_create_topics = null, ): static { return new static([ 'id' => $id, @@ -102,6 +107,7 @@ public static function make( 'can_connect_to_business' => $can_connect_to_business, 'has_main_web_app' => $has_main_web_app, 'has_topics_enabled' => $has_topics_enabled, + 'allows_users_to_create_topics' => $allows_users_to_create_topics, ]); } } diff --git a/src/Telegram/UserProfileAudios.php b/src/Telegram/UserProfileAudios.php new file mode 100644 index 0000000..e939216 --- /dev/null +++ b/src/Telegram/UserProfileAudios.php @@ -0,0 +1,37 @@ + $total_count, + 'audios' => $audios, + ]); + } +} diff --git a/src/Telegram/Video.php b/src/Telegram/Video.php index b70f5b8..9fceccb 100644 --- a/src/Telegram/Video.php +++ b/src/Telegram/Video.php @@ -41,6 +41,13 @@ class Video extends Type /** Optional. Timestamp in seconds from which the video will play in the message */ public ?int $start_timestamp = null; + /** + * Optional. List of available qualities of the video + * + * @var VideoQuality[] + */ + public ?array $qualities = null; + /** Optional. Original filename as defined by the sender */ public ?string $file_name = null; @@ -59,6 +66,7 @@ class Video extends Type * @param PhotoSize $thumbnail Optional. Video thumbnail * @param PhotoSize[] $cover Optional. Available sizes of the cover of the video in the message * @param int $start_timestamp Optional. Timestamp in seconds from which the video will play in the message + * @param VideoQuality[] $qualities Optional. List of available qualities of the video * @param string $file_name Optional. Original filename as defined by the sender * @param string $mime_type Optional. MIME type of the file as defined by the sender * @param int $file_size Optional. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. @@ -72,6 +80,7 @@ public static function make( ?PhotoSize $thumbnail = null, ?array $cover = null, ?int $start_timestamp = null, + ?array $qualities = null, ?string $file_name = null, ?string $mime_type = null, ?int $file_size = null, @@ -85,6 +94,7 @@ public static function make( 'thumbnail' => $thumbnail, 'cover' => $cover, 'start_timestamp' => $start_timestamp, + 'qualities' => $qualities, 'file_name' => $file_name, 'mime_type' => $mime_type, 'file_size' => $file_size, diff --git a/src/Telegram/VideoQuality.php b/src/Telegram/VideoQuality.php new file mode 100644 index 0000000..a352827 --- /dev/null +++ b/src/Telegram/VideoQuality.php @@ -0,0 +1,59 @@ +Optional. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */ + public ?int $file_size = null; + + /** + * @param string $file_id Identifier for this file, which can be used to download or reuse the file + * @param string $file_unique_id Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. + * @param int $width Video width + * @param int $height Video height + * @param string $codec Codec that was used to encode the video, for example, “h264”, “h265”, or “av01” + * @param int $file_size Optional. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. + */ + public static function make( + string $file_id, + string $file_unique_id, + int $width, + int $height, + string $codec, + ?int $file_size = null, + ): static { + return new static([ + 'file_id' => $file_id, + 'file_unique_id' => $file_unique_id, + 'width' => $width, + 'height' => $height, + 'codec' => $codec, + 'file_size' => $file_size, + ]); + } +} diff --git a/src/Types/Enums/ChatActionType.php b/src/Types/Enums/ChatActionType.php index 37c36c7..670fa9d 100644 --- a/src/Types/Enums/ChatActionType.php +++ b/src/Types/Enums/ChatActionType.php @@ -14,16 +14,16 @@ enum ChatActionType: string /** for photos */ case UploadPhoto = 'upload_photo'; - /** for recording videos */ + /** for videos */ case RecordVideo = 'record_video'; - /** for uploading videos */ + /** for videos */ case UploadVideo = 'upload_video'; - /** for recording voice notes */ + /** for voice notes */ case RecordVoice = 'record_voice'; - /** for uploading voice notes */ + /** for voice notes */ case UploadVoice = 'upload_voice'; /** for general files */ @@ -35,9 +35,9 @@ enum ChatActionType: string /** for location data */ case FindLocation = 'find_location'; - /** for recording video notes */ + /** for video notes */ case RecordVideoNote = 'record_video_note'; - /** for uploading video notes */ + /** for video notes */ case UploadVideoNote = 'upload_video_note'; }