Add Some Bounded methods

src/EventHandler/AbstractMessage.php

@@ -222,4 +222,38 @@ public function reply(
             updateStickersetsOrder: $updateStickersetsOrder
         );
     }
+
+    /**
+     * Adds the user to the blacklist.
+     *
+     * @param boolean $stories
+     * @return boolean
+     */
+    public function block(bool $stories): bool
+    {
+        return $this->getClient()->methodCallAsyncRead(
+            'contacts.block',
+            [
+                'id' => $this->senderId,
+                'my_stories_from' => $stories,
+            ]
+        );
+    }
+
+    /**
+     * Deletes the user from the blacklist.
+     *
+     * @param boolean $stories
+     * @return boolean
+     */
+    public function unblock(bool $stories): bool
+    {
+        return $this->getClient()->methodCallAsyncRead(
+            'contacts.block',
+            [
+                'id' => $this->senderId,
+                'my_stories_from' => $stories,
+            ]
+        );
+    }
 }

src/EventHandler/Media/Gif.php

@@ -43,4 +43,36 @@ public function __construct(
         }
         $this->hasStickers = $hasStickers;
     }
+
+    /**
+     * Add GIF to saved gifs list
+     *
+     * @return bool
+     */
+    public function save(): bool
+    {
+        return $this->getClient()->methodCallAsyncRead(
+            'messages.saveGif',
+            [
+                'id' => $this->botApiFileId,
+                'unsave' => false
+            ]
+        );
+    }
+
+    /**
+     * Remove GIF from saved gifs list
+     *
+     * @return bool
+     */
+    public function unsave(): bool
+    {
+        return $this->getClient()->methodCallAsyncRead(
+            'messages.saveGif',
+            [
+                'id' => $this->botApiFileId,
+                'unsave' => true
+            ]
+        );
+    }
 }

src/EventHandler/Message/ChannelMessage.php

@@ -16,8 +16,16 @@
 
 namespace danog\MadelineProto\EventHandler\Message;
 
+use AssertionError;
 use danog\MadelineProto\EventHandler\Message;
 use danog\MadelineProto\MTProto;
+use danog\MadelineProto\EventHandler\Participant;
+use danog\MadelineProto\EventHandler\Participant\Left;
+use danog\MadelineProto\EventHandler\Participant\Admin;
+use danog\MadelineProto\EventHandler\Participant\Member;
+use danog\MadelineProto\EventHandler\Participant\MySelf;
+use danog\MadelineProto\EventHandler\Participant\Banned;
+use danog\MadelineProto\EventHandler\Participant\Creator;
 
 /**
  * Represents an incoming or outgoing channel message.
@@ -32,4 +40,62 @@ public function __construct(
     ) {
         parent::__construct($API, $rawMessage, $info);
     }
+
+    /**
+     * Disable message signatures in channels
+     */
+    public function disableSignatures(): void
+    {
+        $this->getClient()->methodCallAsyncRead(
+            'channels.toggleSignatures',
+            [
+                'channel' => $this->chatId,
+                'enabled' => false,
+            ]
+        );
+    }
+
+    /**
+     * Enable message signatures in channels
+     */
+    public function enableSignatures(): void
+    {
+        $this->getClient()->methodCallAsyncRead(
+            'channels.toggleSignatures',
+            [
+                'channel' => $this->chatId,
+                'enabled' => true,
+            ]
+        );
+    }
+
+    /**
+     * Get info about a [channel/supergroup](https://core.telegram.org/api/channel) participant
+     *
+     * @param string|integer $member Participant to get info about.
+     * @return Participant 
+     * @throws AssertionError
+     */
+    public function getMember(string|int $member): Participant
+    {
+        $client = $this->getClient();
+        $member = $client->getId($member);
+        $result = $client->methodCallAsyncRead(
+            'channels.getParticipant',
+            [
+                'channel' => $this->chatId,
+                'participant' => $member,
+            ]
+        )['participant'];
+
+        return match ($result['_']) {
+            'channelParticipant' => new Member($result),
+            'channelParticipantLeft' => new Left($client, $result),
+            'channelParticipantSelf' => new MySelf($result),
+            'channelParticipantAdmin' => new Admin($result),
+            'channelParticipantBanned' => new Banned($client, $result),
+            'channelParticipantCreator' => new Creator($result),
+            default => throw new AssertionError("undefined Participant type: {$result['_']}")
+        };
+    }
 }

src/EventHandler/Message/GroupMessage.php

@@ -16,11 +16,48 @@
 
 namespace danog\MadelineProto\EventHandler\Message;
 
+use AssertionError;
 use danog\MadelineProto\EventHandler\Message;
-
+use danog\MadelineProto\EventHandler\Participant;
+use danog\MadelineProto\EventHandler\Participant\Left;
+use danog\MadelineProto\EventHandler\Participant\Admin;
+use danog\MadelineProto\EventHandler\Participant\Member;
+use danog\MadelineProto\EventHandler\Participant\MySelf;
+use danog\MadelineProto\EventHandler\Participant\Banned;
+use danog\MadelineProto\EventHandler\Participant\Creator;
 /**
  * Represents an incoming or outgoing group message.
  */
 final class GroupMessage extends Message
 {
+    /**
+     * Get info about a [channel/supergroup](https://core.telegram.org/api/channel) participant
+     *
+     * @param string|integer|null $member Participant to get info about; can be empty or null to get info about the sender of the message.
+     * @return Participant
+     * @throws AssertionError
+     */
+    public function getMember(string|int|null $member = null): Participant
+    {
+        $client = $this->getClient();
+        $member ??= $this->senderId;
+        $member = $client->getId($member);
+        $result = $client->methodCallAsyncRead(
+            'channels.getParticipant',
+            [
+                'channel' => $this->chatId,
+                'participant' => $member,
+            ]
+        )['participant'];
+
+        return match ($result['_']) {
+            'channelParticipant' => new Member($result),
+            'channelParticipantLeft' => new Left($client, $result),
+            'channelParticipantSelf' => new MySelf($result),
+            'channelParticipantAdmin' => new Admin($result),
+            'channelParticipantBanned' => new Banned($client, $result),
+            'channelParticipantCreator' => new Creator($result),
+            default => throw new AssertionError("undefined Participant type: {$result['_']}")
+        };
+    }
 }

src/EventHandler/Message/PrivateMessage.php

@@ -17,10 +17,27 @@
 namespace danog\MadelineProto\EventHandler\Message;
 
 use danog\MadelineProto\EventHandler\Message;
+use danog\MadelineProto\EventHandler\Message\Service\DialogScreenshotTaken;
 
 /**
  * Represents an incoming or outgoing private message.
  */
 final class PrivateMessage extends Message
 {
+    /**
+     * Notify the other user in a private chat that a screenshot of the chat was taken
+     *
+     * @return DialogScreenshotTaken
+     */
+    public function screenShot(): DialogScreenshotTaken
+    {
+        $result = $this->getClient()->methodCallAsyncRead(
+            'messages.sendScreenshotNotification',
+            [
+                'peer' => $this->chatId,
+                'reply_to' => [ '_' => 'inputReplyToMessage', 'reply_to_msg_id' => 0 ],
+            ]
+        );
+        return $this->getClient()->wrapMessage($this->getClient()->extractMessage($result));
+    }
 }

src/EventHandler/Message/Service/AbstractDialogCallGroup.php

@@ -0,0 +1,37 @@
+<?php declare(strict_types=1);
+
+/**
+ * This file is part of MadelineProto.
+ * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ * You should have received a copy of the GNU General Public License along with MadelineProto.
+ * If not, see <http://www.gnu.org/licenses/>.
+ *
+ * @author    Daniil Gentili <daniil@daniil.it>
+ * @copyright 2016-2023 Daniil Gentili <daniil@daniil.it>
+ * @license   https://opensource.org/licenses/AGPL-3.0 AGPLv3
+ * @link https://docs.madelineproto.xyz MadelineProto documentation
+ */
+
+namespace danog\MadelineProto\EventHandler\Message\Service;
+
+use danog\MadelineProto\EventHandler\Message\ServiceMessage;
+use danog\MadelineProto\MTProto;
+
+/** @internal */
+abstract class AbstractDialogCallGroup extends ServiceMessage
+{
+    public function __construct(
+        MTProto $API,
+        array $rawMessage,
+        array $info,
+
+        /** Group call ID */
+        public readonly int $id,
+        /** Group call access hash */
+        public readonly int $accessHash
+    ) {
+        parent::__construct($API, $rawMessage, $info);
+    }
+}

src/EventHandler/Message/Service/DialogCallGroup/Called.php

@@ -0,0 +1,41 @@
+<?php declare(strict_types=1);
+
+/**
+ * This file is part of MadelineProto.
+ * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ * You should have received a copy of the GNU General Public License along with MadelineProto.
+ * If not, see <http://www.gnu.org/licenses/>.
+ *
+ * @author    Daniil Gentili <daniil@daniil.it>
+ * @copyright 2016-2023 Daniil Gentili <daniil@daniil.it>
+ * @license   https://opensource.org/licenses/AGPL-3.0 AGPLv3
+ * @link https://docs.madelineproto.xyz MadelineProto documentation
+ */
+
+namespace danog\MadelineProto\EventHandler\Message\Service\DialogCallGroup;
+
+use danog\MadelineProto\EventHandler\Message\Service\AbstractDialogCallGroup;
+use danog\MadelineProto\MTProto;
+
+/**
+ * The group call has ended.
+ */
+final class Called extends AbstractDialogCallGroup
+{
+    public function __construct(
+        MTProto $API,
+        array $rawMessage,
+        array $info,
+
+        /** Group call ID */
+        int $id,
+        /** Group call access hash */
+        int $accessHash,
+        /** Group call duration */
+        public readonly int $duration
+    ) {
+        parent::__construct($API, $rawMessage, $info, $id, $accessHash);
+    }
+}

src/EventHandler/Message/Service/DialogCallGroup/Invited.php

@@ -0,0 +1,41 @@
+<?php declare(strict_types=1);
+
+/**
+ * This file is part of MadelineProto.
+ * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ * You should have received a copy of the GNU General Public License along with MadelineProto.
+ * If not, see <http://www.gnu.org/licenses/>.
+ *
+ * @author    Daniil Gentili <daniil@daniil.it>
+ * @copyright 2016-2023 Daniil Gentili <daniil@daniil.it>
+ * @license   https://opensource.org/licenses/AGPL-3.0 AGPLv3
+ * @link https://docs.madelineproto.xyz MadelineProto documentation
+ */
+
+namespace danog\MadelineProto\EventHandler\Message\Service\DialogCallGroup;
+
+use danog\MadelineProto\EventHandler\Message\Service\AbstractDialogCallGroup;
+use danog\MadelineProto\MTProto;
+
+/**
+ * A set of users was invited to the group call.
+ */
+final class Invited extends AbstractDialogCallGroup
+{
+    public function __construct(
+        MTProto $API,
+        array $rawMessage,
+        array $info,
+
+        /** Group call ID */
+        int $id,
+        /** Group call access hash */
+        int $accessHash,
+        /** The invited users */
+        public readonly array $users
+    ) {
+        parent::__construct($API, $rawMessage, $info, $id, $accessHash);
+    }
+}

src/EventHandler/Message/Service/DialogCallGroup/Scheduled.php

@@ -0,0 +1,41 @@
+<?php declare(strict_types=1);
+
+/**
+ * This file is part of MadelineProto.
+ * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU Affero General Public License for more details.
+ * You should have received a copy of the GNU General Public License along with MadelineProto.
+ * If not, see <http://www.gnu.org/licenses/>.
+ *
+ * @author    Daniil Gentili <daniil@daniil.it>
+ * @copyright 2016-2023 Daniil Gentili <daniil@daniil.it>
+ * @license   https://opensource.org/licenses/AGPL-3.0 AGPLv3
+ * @link https://docs.madelineproto.xyz MadelineProto documentation
+ */
+
+namespace danog\MadelineProto\EventHandler\Message\Service\DialogCallGroup;
+
+use danog\MadelineProto\EventHandler\Message\Service\AbstractDialogCallGroup;
+use danog\MadelineProto\MTProto;
+
+/**
+ * A group call was scheduled.
+ */
+final class Scheduled extends AbstractDialogCallGroup
+{
+    public function __construct(
+        MTProto $API,
+        array $rawMessage,
+        array $info,
+
+        /** Group call ID */
+        int $id,
+        /** Group call access hash */
+        int $accessHash,
+        /** When is this group call scheduled to start */
+        public readonly int $scheduleDate
+    ) {
+        parent::__construct($API, $rawMessage, $info, $id, $accessHash);
+    }
+}