api: Add support for GET /messages/<msgid>/history.

Author: Anupam-dagar

README.md

@@ -94,6 +94,7 @@ zulip.callEndpoint('/messages', 'POST', params);
 | `zulip.messages.flags.add()` | POST `/messages/flags` | add a flag to a list of messages. Its params are `flag` which is one of `[read, starred, mentioned, wildcard_mentioned, has_alert_word, historical]` and `messages` which is a list of messageIDs. |
 | `zulip.messages.flags.remove()` | POST `/messages/flags` | remove a flag from a list of messages. Its params are `flag` which is one of `[read, starred, mentioned, wildcard_mentioned, has_alert_word, historical]` and `messages` which is a list of messageIDs. |
 | `zulip.messages.getById()` | GET `/messages/<msg_id>` | returns a message by its id. |
+| `zulip.messages.getHistoryById()` | GET `/messages/<msg_id>/history` | return the history of a message |
 | `zulip.queues.register()` | POST `/register` | registers a new queue. You can pass it a params object with the types of events you are interested in and whether you want to receive raw text or html (using markdown). |
 | `zulip.queues.deregister()` | DELETE `/events` | deletes a previously registered queue. |
 | `zulip.reactions.add()` | POST `/reactions` | add a reaction to a message. Accepts a params object with `message_id`, `emoji_name`, `emoji_code` and `reaction_type` (default is `unicode_emoji`). |

examples/messages.js

@@ -66,3 +66,10 @@ zulip(config).then((z) => {
   };
   z.messages.getById(readParams).then(console.log);
 }).catch(err => console.log(err.message));
+
+zulip(config).then((z) => {
+  const readParams = {
+    message_id: 2,
+  };
+  z.messages.getHistoryById(readParams).then(console.log);
+}).catch(err => console.log(err.message));

src/resources/messages.js

@@ -56,6 +56,10 @@ function messages(config) {
       const url = `${config.apiURL}/messages/${params.message_id}`;
       return api(url, config, 'GET', params);
     },
+    getHistoryById: (params) => {
+      const url = `${config.apiURL}/messages/${params.message_id}/history`;
+      return api(url, config, 'GET', params);
+    },
   };
 }
 

test/resources/messages.js

@@ -143,6 +143,28 @@ describe('Messages', () => {
     }).catch(done);
   });
 
+  it('should get message history by id', (done) => {
+    const params = {
+      message_id: 2,
+    };
+    const validator = (url, options) => {
+      url.should.contain(`${common.config.apiURL}/messages/2/history`);
+      options.should.not.have.property('body');
+      options.method.should.be.equal('GET');
+    };
+    const output = {
+      msg: '',
+      result: 'success',
+    };
+    const stubs = common.getStubs(validator, output);
+    messages(common.config).getHistoryById(params)
+    .then((data) => {
+      data.should.have.property('result', 'success');
+      common.restoreStubs(stubs);
+      done();
+    }).catch(done);
+  });
+
   it('should mark message as read', (done) => {
     const params = {
       flag: 'read',