Bot API 7.2

README.md

@@ -1,6 +1,6 @@
 # PHP Wrapper for Telegram Bot API
 
-[![Bot Api 7.1](https://img.shields.io/badge/Bot%20API-7.1-0088cc.svg?style=flat)](https://core.telegram.org/bots/api-changelog#february-16-2024)
+[![Bot Api 7.2](https://img.shields.io/badge/Bot%20API-7.2-0088cc.svg?style=flat)](https://core.telegram.org/bots/api-changelog#march-31-2024)
 [![PHP >=8.2](https://img.shields.io/badge/PHP->=8.2-777bb3.svg?style=flat)](https://www.php.net/releases/8.2/en.php)
 [![Tests Status](https://img.shields.io/github/actions/workflow/status/luzrain/telegram-bot-api/tests.yaml?branch=master)](../../actions/workflows/tests.yaml)
 

src/Event/BusinessConnection.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Luzrain\TelegramBotApi\Event;
+
+use Luzrain\TelegramBotApi\Event;
+use Luzrain\TelegramBotApi\Type;
+
+final class BusinessConnection extends Event
+{
+    public function executeChecker(Type\Update $update): bool
+    {
+        return $update->businessConnection !== null;
+    }
+
+    public function executeCallback(Type\Update $update): mixed
+    {
+        return $this->callback($update->businessConnection);
+    }
+}

src/Event/BusinessMessage.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Luzrain\TelegramBotApi\Event;
+
+use Luzrain\TelegramBotApi\Event;
+use Luzrain\TelegramBotApi\Type;
+
+final class BusinessMessage extends Event
+{
+    public function executeChecker(Type\Update $update): bool
+    {
+        return $update->businessMessage !== null;
+    }
+
+    public function executeCallback(Type\Update $update): mixed
+    {
+        return $this->callback($update->businessMessage);
+    }
+}

src/Event/DeletedBusinessMessage.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Luzrain\TelegramBotApi\Event;
+
+use Luzrain\TelegramBotApi\Event;
+use Luzrain\TelegramBotApi\Type;
+
+final class DeletedBusinessMessage extends Event
+{
+    public function executeChecker(Type\Update $update): bool
+    {
+        return $update->deletedBusinessMessages !== null;
+    }
+
+    public function executeCallback(Type\Update $update): mixed
+    {
+        return $this->callback($update->deletedBusinessMessages);
+    }
+}

src/Event/EditedBusinessMessage.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Luzrain\TelegramBotApi\Event;
+
+use Luzrain\TelegramBotApi\Event;
+use Luzrain\TelegramBotApi\Type;
+
+final class EditedBusinessMessage extends Event
+{
+    public function executeChecker(Type\Update $update): bool
+    {
+        return $update->editedBusinessMessage !== null;
+    }
+
+    public function executeCallback(Type\Update $update): mixed
+    {
+        return $this->callback($update->editedBusinessMessage);
+    }
+}

src/Method/AnswerInlineQuery.php

@@ -27,7 +27,7 @@ public function __construct(
         /**
          * A JSON-serialized array of results for the inline query
          *
-         * @var InlineQueryResult[]
+         * @var list<InlineQueryResult>
          */
         protected array $results,
 

src/Method/CreateInvoiceLink.php

@@ -48,7 +48,7 @@ public function __construct(
         /**
          * Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.)
          *
-         * @var LabeledPrice[]
+         * @var list<LabeledPrice>
          */
         protected array $prices,
 
@@ -66,7 +66,7 @@ public function __construct(
          * At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive,
          * passed in a strictly increased order and must not exceed max_tip_amount.
          *
-         * @var int[]|null
+         * @var list<int>|null
          */
         protected array|null $suggestedTipAmounts = null,
 

src/Method/CreateNewStickerSet.php

@@ -38,15 +38,10 @@ public function __construct(
         /**
          * A JSON-serialized list of 1-50 initial stickers to be added to the sticker set
          *
-         * @var InputSticker[]
+         * @var list<InputSticker>
          */
         protected array $stickers,
 
-        /**
-         * Format of stickers in the set, must be one of "static", "animated", "video"
-         */
-        protected string $stickerFormat,
-
         /**
          * Type of stickers in the set, pass "regular", "mask", or "custom_emoji". By default, a regular sticker set is created.
          */

src/Method/GetBusinessConnection.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Luzrain\TelegramBotApi\Method;
+
+use Luzrain\TelegramBotApi\Method;
+use Luzrain\TelegramBotApi\Type\BusinessConnection;
+
+/**
+ * Use this method to get information about the connection of the bot with a business account.
+ * Returns a BusinessConnection object on success.
+ *
+ * @extends Method<BusinessConnection>
+ */
+final class GetBusinessConnection extends Method
+{
+    protected static string $methodName = 'getBusinessConnection';
+    protected static string $responseClass = BusinessConnection::class;
+
+    public function __construct(
+        /**
+         * Unique identifier of the business connection
+         */
+        protected string $businessConnectionId,
+    ) {
+    }
+}

src/Method/GetCustomEmojiStickers.php

@@ -23,7 +23,7 @@ public function __construct(
         /**
          * List of custom emoji identifiers. At most 200 custom emoji identifiers can be specified.
          *
-         * @var string[]
+         * @var list<string>
          */
         protected array $customEmojiIds,
     ) {

src/Method/ReplaceStickerInSet.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Luzrain\TelegramBotApi\Method;
+
+use Luzrain\TelegramBotApi\Method;
+use Luzrain\TelegramBotApi\Type\InputSticker;
+
+/**
+ * Use this method to replace an existing sticker in a sticker set with a new one.
+ * The method is equivalent to calling deleteStickerFromSet, then addStickerToSet, then setStickerPositionInSet.
+ * Returns True on success.
+ *
+ * @extends Method<true>
+ */
+final class ReplaceStickerInSet extends Method
+{
+    protected static string $methodName = 'replaceStickerInSet';
+
+    public function __construct(
+        /**
+         * User identifier of the sticker set owner
+         */
+        protected int $userId,
+
+        /**
+         * Sticker set name
+         */
+        protected string $name,
+
+        /**
+         * File identifier of the replaced sticker
+         */
+        protected string $oldSticker,
+
+        /**
+         * A JSON-serialized object with information about the added sticker.
+         * If exactly the same sticker had already been added to the set, then the set remains unchanged.
+         */
+        protected InputSticker $sticker,
+    ) {
+    }
+}

src/Method/SendAnimation.php

@@ -36,6 +36,11 @@ public function __construct(
          */
         protected InputFile|string $animation,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the message will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
          */
@@ -101,7 +106,8 @@ public function __construct(
 
         /**
          * Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard,
-         * instructions to remove reply keyboard or to force a reply from the user.
+         * instructions to remove a reply keyboard or to force a reply from the user.
+         * Not supported for messages sent on behalf of a business account.
          */
         protected InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply|null $replyMarkup = null,
     ) {

src/Method/SendAudio.php

@@ -38,6 +38,11 @@ public function __construct(
          */
         protected InputFile|string $audio,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the message will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
          */
@@ -98,7 +103,8 @@ public function __construct(
 
         /**
          * Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard,
-         * instructions to remove reply keyboard or to force a reply from the user.
+         * instructions to remove a reply keyboard or to force a reply from the user.
+         * Not supported for messages sent on behalf of a business account.
          */
         protected InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply|null $replyMarkup = null,
     ) {

src/Method/SendChatAction.php

@@ -48,6 +48,11 @@ public function __construct(
          */
         protected string $action,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the action will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread; supergroups only
          */

src/Method/SendContact.php

@@ -38,6 +38,11 @@ public function __construct(
          */
         protected string $firstName,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the message will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
          */
@@ -70,7 +75,8 @@ public function __construct(
 
         /**
          * Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard,
-         * instructions to remove reply keyboard or to force a reply from the user.
+         * instructions to remove a reply keyboard or to force a reply from the user.
+         * Not supported for messages sent on behalf of a business account.
          */
         protected InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply|null $replyMarkup = null,
     ) {

src/Method/SendDice.php

@@ -29,6 +29,11 @@ public function __construct(
          */
         protected int|string $chatId,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the message will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
          */
@@ -58,7 +63,8 @@ public function __construct(
 
         /**
          * Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard,
-         * instructions to remove reply keyboard or to force a reply from the user.
+         * instructions to remove a reply keyboard or to force a reply from the user.
+         * Not supported for messages sent on behalf of a business account.
          */
         protected InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply|null $replyMarkup = null,
     ) {

src/Method/SendDocument.php

@@ -36,6 +36,11 @@ public function __construct(
          */
         protected InputFile|string $document,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the message will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
          */
@@ -86,7 +91,8 @@ public function __construct(
 
         /**
          * Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard,
-         * instructions to remove reply keyboard or to force a reply from the user.
+         * instructions to remove a reply keyboard or to force a reply from the user.
+         * Not supported for messages sent on behalf of a business account.
          */
         protected InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply|null $replyMarkup = null,
     ) {

src/Method/SendGame.php

@@ -30,6 +30,11 @@ public function __construct(
          */
         protected string $gameShortName,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the message will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
          */
@@ -53,6 +58,7 @@ public function __construct(
         /**
          * A JSON-serialized object for an inline keyboard. If empty, one 'Play game_title' button will be shown.
          * If not empty, the first button must launch the game.
+         * Not supported for messages sent on behalf of a business account.
          */
         protected InlineKeyboardMarkup|null $replyMarkup = null,
     ) {

src/Method/SendLocation.php

@@ -38,6 +38,11 @@ public function __construct(
          */
         protected float $longitude,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the message will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
          */
@@ -81,7 +86,8 @@ public function __construct(
 
         /**
          * Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard,
-         * instructions to remove reply keyboard or to force a reply from the user.
+         * instructions to remove a reply keyboard or to force a reply from the user.
+         * Not supported for messages sent on behalf of a business account.
          */
         protected InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply|null $replyMarkup = null,
     ) {

src/Method/SendMediaGroup.php

@@ -38,6 +38,11 @@ public function __construct(
          */
         protected array $media,
 
+        /**
+         * Unique identifier of the business connection on behalf of which the message will be sent
+         */
+        protected string|null $businessConnectionId = null,
+
         /**
          * Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
          */