Added unban command

botsrc/AdminCommands/UnbanCommand.php

@@ -0,0 +1,142 @@
+<?php
+
+    namespace AdminCommands;
+
+    use Longman\TelegramBot\Commands\UserCommand;
+    use Longman\TelegramBot\Entities\ServerResponse;
+    use Longman\TelegramBot\Exception\TelegramException;
+    use Longman\TelegramBot\Request;
+    use SynicalBot;
+    use TelegramClientManager\Abstracts\TelegramChatType;
+    use TelegramClientManager\Exceptions\DatabaseException;
+    use TelegramClientManager\Exceptions\InvalidSearchMethod;
+    use TelegramClientManager\Exceptions\TelegramClientNotFoundException;
+    use TelegramClientManager\Objects\DetectedClients;
+    use TelegramClientManager\Utilities\Helper;
+
+    class UnbanCommand extends UserCommand
+    {
+        /**
+         * @var string
+         */
+        protected $name = 'Unban';
+
+        /**
+         * @var string
+         */
+        protected $description = 'Lifts the ban for a target user';
+
+        /**
+         * @var string
+         */
+        protected $usage = '/ban';
+
+        /**
+         * @var string
+         */
+        protected $version = '1.0.0';
+
+        /**
+         * Command execute method
+         *
+         * @return ServerResponse
+         * @throws TelegramException
+         * @throws DatabaseException
+         * @throws InvalidSearchMethod
+         * @throws TelegramClientNotFoundException
+         * @noinspection DuplicatedCode
+         */
+        public function execute(): ServerResponse
+        {
+            $DetectedClients = DetectedClients::findClients(SynicalBot::getTelegramClientManager(), $this->getMessage(), $this->getCallbackQuery());
+
+            // Ignore forwarded commands
+            if($this->getMessage()->getForwardFrom() !== null || $this->getMessage()->getForwardFromChat())
+            {
+                return Request::emptyResponse();
+            }
+
+            // Prevent the use of this command in private chats
+            if($this->getMessage()->getChat()->isPrivateChat())
+            {
+                return Request::sendMessage([
+                    'chat_id' => $this->getMessage()->getChat()->getId(),
+                    'reply_to_message_id' => $this->getMessage()->getMessageId(),
+                    'parse_mode' => 'html',
+                    'text' => 'This command is made to be used in group chats, not in private messages!'
+                ]);
+            }
+
+            // Ignore the request if it's not a group or supergroup (eg; channels or new features that wasn't added)
+            if(
+                $this->getMessage()->getChat()->getType() !== TelegramChatType::Group &&
+                $this->getMessage()->getChat()->getType() !== TelegramChatType::SuperGroup
+            )
+            {
+                return Request::emptyResponse();
+            }
+
+            $ChatMemberCache = AdminCacheCommand::getChatMemberCache($this->getMessage());
+            if($ChatMemberCache == null)
+            {
+                return Request::emptyResponse();
+            }
+
+            $CallerPermissions = $ChatMemberCache->getAdministratorUser($this->getMessage()->getFrom()->getId());
+            if($CallerPermissions == null || $CallerPermissions->CanRestrictMembers == false)
+            {
+                return Request::sendMessage([
+                    'chat_id' => $this->getMessage()->getChat()->getId(),
+                    'reply_to_message_id' => $this->getMessage()->getMessageId(),
+                    'parse_mode' => 'html',
+                    'text' => 'You do not have the required permissions to unban users from this chat'
+                ]);
+            }
+
+            try
+            {
+                $TargetUser = SynicalBot\Utilities::findTarget($this->getMessage(), $DetectedClients);
+            }
+            catch(SynicalBot\Exceptions\CannotFindTargetUserException $e)
+            {
+                return Request::sendMessage([
+                    'chat_id' => $this->getMessage()->getChat()->getId(),
+                    'reply_to_message_id' => $this->getMessage()->getMessageId(),
+                    'parse_mode' => 'html',
+                    'text' => 'Cannot resolve user. If you reply to one of their messages, I\'ll be able to interact with them.'
+                ]);
+            }
+
+            if($TargetUser == null)
+            {
+                return Request::sendMessage([
+                    'chat_id' => $this->getMessage()->getChat()->getId(),
+                    'reply_to_message_id' => $this->getMessage()->getMessageId(),
+                    'parse_mode' => 'html',
+                    'text' => 'You need to specify a user to ban'
+                ]);
+            }
+
+            $BanResults = Request::unbanChatMember([
+                'chat_id' => $this->getMessage()->getChat()->getId(),
+                'user_id' => $TargetUser->User->ID
+            ]);
+
+            if($BanResults->isOk())
+            {
+                return Request::sendMessage([
+                    'chat_id' => $this->getMessage()->getChat()->getId(),
+                    'reply_to_message_id' => $this->getMessage()->getMessageId(),
+                    'parse_mode' => 'html',
+                    'text' => Helper::generateMention($TargetUser) . ' can join the chat again'
+                ]);
+            }
+
+            return Request::sendMessage([
+                'chat_id' => $this->getMessage()->getChat()->getId(),
+                'reply_to_message_id' => $this->getMessage()->getMessageId(),
+                'parse_mode' => 'html',
+                'text' => $BanResults->getDescription() . ' (' . $BanResults->getErrorCode() . ')'
+            ]);
+        }
+    }

botsrc/package.json

@@ -91,6 +91,10 @@
             "required": true,
             "file": "SynicalBot.php"
         },
+        {
+            "required": true,
+            "file": "AdminCommands/UnbanCommand.php"
+        },
         {
             "required": true,
             "file": "AdminCommands/BanCommand.php"