feat: Add fetchOnlyRelevantRevisions config option when activating

If you set this option in your S3 config then we will only load enough revisions from
S3 to find the currently active version and then we will stop.
The assumption here is that the main use-case for `fetchInitialRevisions` is to be
able to do some sort of changelog or audit log from another plugin where we would
want to know the details of the previously active revision.
Since looping over revisions from S3 can be slow when you have too many of them
stored (see #120) we provide an option to short circuit that.

Author: Kelvin Luck

index.js

@@ -116,6 +116,12 @@ module.exports = {
       },
 
       fetchInitialRevisions: function(context) {
+
+        if (this.readConfig('fetchOnlyRelevantRevisions')) {
+          this.log('fetchInitialRevisions - fetching only enough revisions to find the active revision', { verbose: true });
+          return this._fetchActiveRevision();
+        }
+
         return this._list(context)
           .then(function(revisions) {
             return {
@@ -124,6 +130,24 @@ module.exports = {
           });
       },
 
+      _fetchActiveRevision: function() {
+        var bucket      = this.readConfig('bucket');
+        var prefix      = this.readConfig('prefix');
+        var filePattern = this.readConfig('filePattern');
+
+        var options = {
+          bucket: bucket,
+          prefix: prefix,
+          filePattern: filePattern,
+        };
+
+        var s3 = new this.S3({ plugin: this });
+        return s3.getActiveRevision(options)
+          .then((activeRevision) => {
+            return { initialRevisions: [activeRevision] };
+          });
+      },
+
       _list: function(/* context */) {
         var bucket      = this.readConfig('bucket');
         var prefix      = this.readConfig('prefix');