src/telegram: Add sendVideoNote method (#330)

References:

    * API sendVideoNote method: https://core.telegram.org/bots/api#sendvideonote
    * PR: https://github.com/yagop/node-telegram-bot-api/pull/330
    * PR-by: @kamikazechaser 
    * API v3: https://github.com/yagop/node-telegram-bot-api/issues/332

doc/api.md

@@ -33,6 +33,7 @@ TelegramBot
     * [.sendDocument(chatId, doc, [options], [fileOpts])](#TelegramBot+sendDocument) ⇒ <code>Promise</code>
     * [.sendSticker(chatId, sticker, [options])](#TelegramBot+sendSticker) ⇒ <code>Promise</code>
     * [.sendVideo(chatId, video, [options])](#TelegramBot+sendVideo) ⇒ <code>Promise</code>
+    * [.sendVideoNote(chatId, videoNote, [options])](#TelegramBot+sendVideoNote) ⇒ <code>Promise</code>
     * [.sendVoice(chatId, voice, [options])](#TelegramBot+sendVoice) ⇒ <code>Promise</code>
     * [.sendChatAction(chatId, action)](#TelegramBot+sendChatAction) ⇒ <code>Promise</code>
     * [.kickChatMember(chatId, userId)](#TelegramBot+kickChatMember) ⇒ <code>Promise</code>
@@ -338,6 +339,21 @@ Use this method to send video files, Telegram clients support mp4 videos (other
 | video | <code>String</code> &#124; <code>stream.Stream</code> &#124; <code>Buffer</code> | A file path or Stream. Can also be a `file_id` previously uploaded. |
 | [options] | <code>Object</code> | Additional Telegram query options |
 
+<a name="TelegramBot+sendVideoNote"></a>
+
+### telegramBot.sendVideoNote(chatId, videoNote, [options]) ⇒ <code>Promise</code>
+Use this method to send rounded square videos of upto 1 minute long.
+
+**Kind**: instance method of <code>[TelegramBot](#TelegramBot)</code>  
+**Info**: The length parameter is actually optional. However, the API (at time of writing) requires you to always provide it until it is fixed.  
+**See**: https://core.telegram.org/bots/api#sendvideonote  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| chatId | <code>Number</code> &#124; <code>String</code> | Unique identifier for the message recipient |
+| videoNote | <code>String</code> &#124; <code>stream.Stream</code> &#124; <code>Buffer</code> | A file path or Stream. Can also be a `file_id` previously uploaded. |
+| [options] | <code>Object</code> | Additional Telegram query options |
+
 <a name="TelegramBot+sendVoice"></a>
 
 ### telegramBot.sendVoice(chatId, voice, [options]) ⇒ <code>Promise</code>

src/telegram.js

@@ -695,6 +695,31 @@ class TelegramBot extends EventEmitter {
     return this._request('sendVideo', opts);
   }
 
+  /**
+   * Use this method to send rounded square videos of upto 1 minute long.
+   * @param  {Number|String} chatId  Unique identifier for the message recipient
+   * @param  {String|stream.Stream|Buffer} videoNote A file path or Stream.
+   * Can also be a `file_id` previously uploaded.
+   * @param  {Object} [options] Additional Telegram query options
+   * @return {Promise}
+   * @info The length parameter is actually optional. However, the API (at time of writing) requires you to always provide it until it is fixed.
+   * @see https://core.telegram.org/bots/api#sendvideonote
+   */
+  sendVideoNote(chatId, videoNote, options = {}) {
+    const opts = {
+      qs: options
+    };
+    opts.qs.chat_id = chatId;
+    try {
+      const sendData = this._formatSendData('video_note', videoNote);
+      opts.formData = sendData[0];
+      opts.qs.video_note = sendData[1];
+    } catch (ex) {
+      return Promise.reject(ex);
+    }
+    return this._request('sendVideoNote', opts);
+  }
+
   /**
    * Send voice
    * @param  {Number|String} chatId  Unique identifier for the message recipient

test/telegram.js

@@ -709,6 +709,44 @@ describe('TelegramBot', function telegramSuite() {
     });
   });
 
+  describe('#sendVideoNote', function sendVideoNoteSuite() {
+    let videoNoteId;
+    this.timeout(timeout);
+    before(function before() {
+      utils.handleRatelimit(bot, 'sendVideoNote', this);
+    });
+    it('should send a video from file', function test() {
+      const video = `${__dirname}/data/video.mp4`;
+      return bot.sendVideoNote(USERID, video, { length: 5 }).then(resp => {
+        assert.ok(is.object(resp));
+        assert.ok(is.object(resp.video_note));
+        videoNoteId = resp.video_note.file_id;
+      });
+    });
+    it('should send a video from id', function test() {
+      // Send the same videonote as before
+      assert.ok(videoNoteId);
+      return bot.sendVideoNote(USERID, videoNoteId, { length: 5 }).then(resp => {
+        assert.ok(is.object(resp));
+        assert.ok(is.object(resp.video_note));
+      });
+    });
+    it('should send a video from fs.readStream', function test() {
+      const video = fs.createReadStream(`${__dirname}/data/video.mp4`);
+      return bot.sendVideoNote(USERID, video, { length: 5 }).then(resp => {
+        assert.ok(is.object(resp));
+        assert.ok(is.object(resp.video_note));
+      });
+    });
+    it('should send a video from a Buffer', function test() {
+      const video = fs.readFileSync(`${__dirname}/data/video.mp4`);
+      return bot.sendVideoNote(USERID, video, { length: 5 }).then(resp => {
+        assert.ok(is.object(resp));
+        assert.ok(is.object(resp.video_note));
+      });
+    });
+  });
+
   describe('#sendVoice', function sendVoiceSuite() {
     let voiceId;
     this.timeout(timeout);