Bloodhound optionally indexes/matches remote data

- twitter#1148

doc/bloodhound.md

@@ -272,6 +272,10 @@ When configuring `remote`, the following options are available.
   you to transform the remote response before the Bloodhound instance operates 
   on it. Defaults to the [identity function].
 
+* `indexResponse` – Adds the remote response to the index (combined with local 
+  and prefetched data). Then returns filtered results based on the query. Defaults 
+  to `false`.
+
 <!-- section links -->
 
 [identity function]: http://en.wikipedia.org/wiki/Identity_function

src/bloodhound/bloodhound.js

@@ -159,6 +159,12 @@ var Bloodhound = (function() {
           }) && nonDuplicates.push(r);
         });
 
+        // #1148: Should Bloodhound index remote datums?
+        if (that.remote.indexResponse) {
+          that.index.add(nonDuplicates);
+          nonDuplicates = that.index.search(query);
+        }
+
         async && async(nonDuplicates);
       }
     },

src/bloodhound/remote.js

@@ -14,6 +14,7 @@ var Remote = (function() {
     this.url = o.url;
     this.prepare = o.prepare;
     this.transform = o.transform;
+    this.indexResponse = o.indexResponse;
 
     this.transport = new Transport({
       cache: o.cache,