add mode parameter to symlink (#469)

lib/core.js

@@ -849,9 +849,10 @@ Archiver.prototype.setModule = function(module) {
  *
  * @param  {String} filepath The symlink path (within archive).
  * @param  {String} target The target path (within archive).
+ * @param  {Number} mode Sets the entry permissions.
  * @return {this}
  */
-Archiver.prototype.symlink = function(filepath, target) {
+Archiver.prototype.symlink = function(filepath, target, mode) {
   if (this._state.finalize || this._state.aborted) {
     this.emit('error', new ArchiverError('QUEUECLOSED'));
     return this;
@@ -878,6 +879,10 @@ Archiver.prototype.symlink = function(filepath, target) {
   data.linkname = target.replace(/\\/g, '/');
   data.sourceType = 'buffer';
 
+  if (typeof mode === "number") {
+    data.mode = mode;
+  }
+
   this._entriesCount++;
   this._queue.push({
     data: data,

test/archiver.js

@@ -398,4 +398,41 @@ describe('archiver', function() {
     });
 
   });
+
+  describe('#symlink', function() {
+    var actual;
+    var archive;
+    var entries = {};
+
+    before(function(done) {
+      archive = archiver('json');
+      var testStream = new WriteStream('tmp/symlink.json');
+
+      testStream.on('close', function() {
+        actual = helpers.readJSON('tmp/symlink.json');
+
+        actual.forEach(function(entry) {
+          entries[entry.name] = entry;
+        });
+
+        done();
+      });
+
+      archive.pipe(testStream);
+
+      archive
+        .append("file-a", { name: "file-a" })
+        .symlink("directory-a/symlink-to-file-a", "../file-a")
+        .symlink("directory-b/directory-c/symlink-to-directory-a", "../../directory-a", 493)
+        .finalize();
+    });
+
+    it('should append multiple entries', () => {
+      assert.isArray(actual);
+      assert.property(entries, 'file-a');
+      assert.property(entries, 'directory-a/symlink-to-file-a');
+      assert.property(entries, 'directory-b/directory-c/symlink-to-directory-a');
+      assert.propertyVal(entries['directory-b/directory-c/symlink-to-directory-a'], 'mode', 493);
+    });
+  });
 });