rename removeLink() into getRemoteLinks()

add createRemoteLink

Author: itoche

lib/jira.js

@@ -606,7 +606,7 @@ var JiraApi = exports.JiraApi = function(protocol, host, port, username, passwor
      * @param issueNumber - The internal id (not the issue key) of the issue
      * @param callback
      */
-    this.remoteLink = function remoteLink(issueNumber, callback) {
+    this.getRemoteLinks = function getRemoteLinks(issueNumber, callback) {
 
         var options = {
             rejectUnauthorized: this.strictSSL,
@@ -635,7 +635,50 @@ var JiraApi = exports.JiraApi = function(protocol, host, port, username, passwor
             callback(null, response.body);
 
         });
-    }
+    };
+
+    /**
+     * Retrieves the remote links associated with the given issue.
+     *
+     * @param issueNumber - The internal id (not the issue key) of the issue
+     * @param callback
+     */
+    this.createRemoteLink = function createRemoteLink(issueNumber, remoteLink, callback) {
+
+        var options = {
+            rejectUnauthorized: this.strictSSL,
+            uri: this.makeUri('/issue/' + issueNumber + '/remotelink'),
+            method: 'POST',
+            json: true,
+            body: remoteLink
+        };
+
+        this.doRequest(options, function(error, response) {
+
+            if (error) {
+                callback(error, null);
+                return;
+            }
+
+            if (response.statusCode === 404) {
+                callback('Cannot create remote link. Invalid issue.');
+                return;
+            }
+
+            if (response.statusCode === 400) {
+                callback('Cannot create remote link. ' + response.body.errors.title);
+                return;
+            }
+
+            if (response.statusCode !== 200) {
+                callback(response.statusCode + ': Unable to connect to JIRA during request.');
+                return;
+            }
+
+            callback(null, response.body);
+
+        });
+    };
 
 
     // ## Get Versions for a project ##