Merge develop into 726-games

Author: noplanman

CHANGELOG.md

@@ -5,6 +5,7 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 
 ## [Unreleased]
 ### Added
+- `ChatAction` class to simplify chat action selection.
 - Telegram Games platform!
 ### Changed
 - [:exclamation:][unreleased-bc-rename-constants] Rename and ensure no redefinition of constants: `BASE_PATH` -> `TB_BASE_PATH`, `BASE_COMMANDS_PATH` -> `TB_BASE_COMMANDS_PATH`.

README.md

@@ -371,7 +371,7 @@ See the [*ImageCommand.php*][ImageCommand.php] for a full example.
 ```php
 Request::sendChatAction([
     'chat_id' => $chat_id,
-    'action'  => 'typing',
+    'action'  => Longman\TelegramBot\ChatAction::TYPING,
 ]);
 ```
 

src/ChatAction.php

@@ -0,0 +1,64 @@
+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot;
+
+class ChatAction
+{
+    /**
+     * Typing chat action
+     */
+    const TYPING = 'typing';
+
+    /**
+     * Upload Photo chat action
+     */
+    const UPLOAD_PHOTO = 'upload_photo';
+
+    /**
+     * Record Video chat action
+     */
+    const RECORD_VIDEO = 'record_video';
+
+    /**
+     * Upload Video chat action
+     */
+    const UPLOAD_VIDEO = 'upload_video';
+
+    /**
+     * Record Audio chat action
+     */
+    const RECORD_AUDIO = 'record_audio';
+
+    /**
+     * Upload Audio chat action
+     */
+    const UPLOAD_AUDIO = 'upload_audio';
+
+    /**
+     * Upload Document chat action
+     */
+    const UPLOAD_DOCUMENT = 'upload_document';
+
+    /**
+     * Find Location chat action
+     */
+    const FIND_LOCATION = 'find_location';
+
+    /**
+     * Record Video Note chat action
+     */
+    const RECORD_VIDEO_NOTE = 'record_video_note';
+
+    /**
+     * Upload Video note chat action
+     */
+    const UPLOAD_VIDEO_NOTE = 'upload_video_note';
+}