Add forwardMessages method for batch forwarding

tests/TgBotLib/Methods/ForwardMessagesTest.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace TgBotLib\Methods;
+
+use PHPUnit\Framework\TestCase;
+use TgBotLib\Bot;
+use TgBotLib\Enums\Types\ParseMode;
+use TgBotLib\Objects\LinkPreviewOptions;
+use TgBotLib\Objects\Message;
+use TgBotLib\Objects\MessageId;
+
+class ForwardMessagesTest extends TestCase
+{
+    const int TEST_CHAT_ID = -1001301191379;
+    private static Bot $bot;
+
+    /**
+     * @return void
+     */
+    public static function setUpBeforeClass(): void
+    {
+        self::$bot = new Bot(BOT_TOKEN);
+    }
+
+    /**
+     * Tests the `sendMessage` function of the bot instance.
+     *
+     * @return void
+     */
+    public function testForwardMessage(): void
+    {
+        $message1 = self::$bot->sendMessage(
+            chat_id: self::TEST_CHAT_ID,
+            text: 'This is a test message.'
+        );
+
+        $message2 = self::$bot->sendMessage(
+            chat_id: self::TEST_CHAT_ID,
+            text: 'This is another test message.'
+        );
+
+        $result = self::$bot->forwardMessages(
+            chat_id: self::TEST_CHAT_ID,
+            from_chat_id: self::TEST_CHAT_ID,
+            message_ids: [$message1->getMessageId(), $message2->getMessageId()]
+        );
+
+        $this->assertIsArray($result);
+        $this->assertCount(2, $result);
+        foreach ($result as $messageId)
+        {
+            $this->assertInstanceOf(MessageId::class, $messageId);
+        }
+    }
+}