From 3ab9c36704fd4c453680e4b486cfb68920d9ddaa Mon Sep 17 00:00:00 2001
From: zyberspace <zyberspace@zyberware.org>
Date: Thu, 9 Jul 2015 23:46:15 +0200
Subject: [PATCH] Added chat-commands

---
 lib/Zyberspace/Telegram/Cli/Client.php | 90 ++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)

diff --git a/lib/Zyberspace/Telegram/Cli/Client.php b/lib/Zyberspace/Telegram/Cli/Client.php
index 002bbf9..4612625 100644
--- a/lib/Zyberspace/Telegram/Cli/Client.php
+++ b/lib/Zyberspace/Telegram/Cli/Client.php
@@ -85,6 +85,96 @@ public function broadcast(array $userList, $msg)
             . $this->escapeStringArgument($msg));
     }
 
+    /**
+     * Creates a new group chat with the users in $userList.
+     *
+     * @param string $chatTitle The title of the new chat
+     * @param array $userList The users you want to add to the chat. Gets formatted with formatPeerList().
+     *                        The current telgram-user (who creates the chat) will be added automatically.
+     *
+     * @return boolean true on success, false otherwise
+     *
+     * @uses exec()
+     * @uses escapeStringArgument()
+     * @uses formatPeerList()
+     */
+    public function createGroupChat($chatTitle, $userList)
+    {
+        if (count($userList) <= 0) {
+            return false;
+        }
+
+        return $this->exec('create_group_chat', $this->escapeStringArgument($chatTitle),
+            $this->formatPeerList($userList));
+    }
+
+    /**
+     * Returns an info-object about a chat (title, name, members, admin, etc.).
+     *
+     * @param string $chat The name of the chat (not the title). Gets escaped with escapePeer().
+     *
+     * @return object|boolean A chat-object; false if somethings goes wrong
+     *
+     * @uses exec()
+     * @uses escapePeer()
+     */
+    public function chatInfo($chat)
+    {
+        return $this->exec('chat_info', $this->escapePeer($chat));
+    }
+
+    /**
+     * Renames a chat. Both, the chat title and the print-name will change.
+     *
+     * @param string $chat The name of the chat (not the title). Gets escaped with escapePeer().
+     * @param string $chatTitle The new title of the chat.
+     *
+     * @return boolean true on success, false otherwise
+     *
+     * @uses exec()
+     * @uses escapePeer()
+     * @uses escapeStringArgument()
+     */
+    public function renameChat($chat, $newChatTitle)
+    {
+        return $this->exec('rename_chat', $this->escapePeer($chat), $this->escapeStringArgument($newChatTitle));
+    }
+
+    /**
+     * Adds a user to a chat.
+     *
+     * @param string $chat The chat you want the user to add to. Gets escaped with escapePeer().
+     * @param string $user The user you want to add. Gets escaped with escapePeer().
+     * @param int $numberOfMessagesToFoward The number of last messages of the chat, the new user should see.
+     *                                      Default is 100.
+     *
+     * @return boolean true on success, false otherwise
+     *
+     * @uses exec()
+     * @uses escapePeer()
+     */
+    public function chatAddUser($chat, $user, $numberOfMessagesToFoward = 100)
+    {
+        return $this->exec('chat_add_user', $this->escapePeer($chat), $this->escapePeer($user),
+            (int) $numberOfMessagesToFoward);
+    }
+
+    /**
+     * Deletes a user from a chat.
+     *
+     * @param string $chat The chat you want the user to delete from. Gets escaped with escapePeer().
+     * @param string $user The user you want to delete. Gets escaped with escapePeer().
+     *
+     * @return boolean true on success, false otherwise
+     *
+     * @uses exec()
+     * @uses escapePeer()
+     */
+    public function chatDeleteUser($chat, $user)
+    {
+        return $this->exec('chat_delete_user', $this->escapePeer($chat), $this->escapePeer($user));
+    }
+
     /**
      * Sets the profile name
      *