ADD deletePlot method and example

Author: alexander-daniel

examples/delete-plot.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var plotly = require('../.')('username','apiKey');
+
+plotly.deletePlot('888', function (err, msg) {
+	if (err) console.log(err);
+	else console.log(msg);
+});

index.js

@@ -236,6 +236,47 @@ Plotly.prototype.getImage = function (figure, opts, callback) {
     req.end();
 };
 
+Plotly.prototype.deletePlot = function (fid, callback) {
+    if (!callback) callback = function () {};
+
+    var self = this;
+
+    // Create the base64 authstring from buffer
+    var encodedAPIAuth = new Buffer(this.username + ':' + this.apiKey).toString('base64');
+
+    var options = {
+        host: 'api.plot.ly',
+        port: this.port,
+        path: '/v2/files/' + this.username + ':' + fid + '/trash',
+        method: 'POST',
+        agent: false,
+        withCredentials: true,
+        headers: {
+            'Plotly-Client-Platform': 'nodejs ' + this.version,
+            'authorization': 'Basic ' + encodedAPIAuth
+        }
+    };
+
+    var req = https.request(options, function (res) {
+        parseRes(res, function (err, body) {
+
+            if (res.statusCode === 200) {
+                var msg = 'Successfully deleted plot: ' + self.username + ':' + fid;
+                callback(null, msg);
+            } else {
+                callback(body); // Pass out the error message from the backend
+            }
+
+        });
+    });
+
+    req.on('error', function (err) {
+        callback(err);
+    });
+
+    req.end();
+};
+
 // response parse helper fn
 function parseRes (res, cb) {
     var body = '';