Add date filters and fuzzy matching

Author: anttiai

README.md

@@ -35,11 +35,24 @@ client.search('keyword', callback);
 client.search(callback);
 ```
 
-#### Define language filter (e.g. "en" or "de")
+#### Use fuzzy matching
 ```js
+// Enable fuzzy matching for typo tolerance (default "false")
+client.useFuzzyMatch(true);
+```
+
+#### Define language filter
+```js
+// Documents in specific language (e.g. "en" or "de")
 client.setLanguage('en');
 ```
 
+#### Define publishing date filters 
+```js
+// Documents published between specific date range
+client.setDateFilter('2019-01-01', '2019-01-31');
+```
+
 #### Manage paging
 ```js
 // Defaults: page "1", pageSize "10", sortBy "relevance", sortOrder "desc"

src/apifetch.js

@@ -38,6 +38,9 @@ var executeApiFetch = function(sitekey, type, settings, cb) {
   var qs = '';
   if (type === 'search') {
     qs = settingToQueryParam(settings.lang, 'lang') +
+         settingToQueryParam(settings.fuzzy, 'fuzzy') +
+         settingToQueryParam(settings.dateFrom, 'dateFrom') +
+         settingToQueryParam(settings.dateTo, 'dateTo') +
          settingToQueryParam(settings.paging.page, 'page') +
          settingToQueryParam(settings.paging.pageSize, 'limit') +
          settingToQueryParam(settings.paging.sortBy, 'sort') +

src/index.js

@@ -47,6 +47,8 @@ var client = function(sitekey) {
    */
   this.getSettings = function() { return this.settings.getSettings(); }
   this.setLanguage = function(lang) { this.settings.setLanguage(lang); };
+  this.useFuzzyMatch = function(use) { this.settings.useFuzzyMatch(use); };
+  this.setDateFilter = function(dateFrom, dateTo) { this.settings.setDateFilter(dateFrom, dateTo); };
   this.setPaging = function(page, pageSize, sortBy, sortOder) { this.settings.setPaging(page, pageSize, sortBy, sortOder); };
   this.nextPage = function() { this.settings.nextPage(); };
   this.previousPage = function() { this.settings.previousPage(); };

src/settings.js

@@ -11,29 +11,57 @@ var settings = function() {
     }
   };
 
-  this.getSettings = function () {
+  this.getSettings = function() {
     return this.settings;
   }
 
-  this.setKeyword = function (keyword) {
+  this.setKeyword = function(keyword) {
     this.settings.keyword = keyword || '*';
   }
 
-  this.setLanguage = function (language) {
-    console.log('LANG SET TO ' + language);
+  this.setLanguage = function(language) {
+    if (language && language.length !== 2) {
+      throw "use 2-char language code (e.g. \"en\")";
+    }
     this.settings.lang = language;
   }
 
-  this.setPaging = function (page, pageSize, sortBy, sortOder) {
+  this.useFuzzyMatch = function(fuzzy) {
+    this.settings.fuzzy = fuzzy;
+  }
+
+  this.setDateFilter = function(dateFrom, dateTo) {
+    this.settings.dateFrom = dateFrom;
+    this.settings.dateTo = dateTo;
+  }
+
+  this.setKeyword = function(keyword) {
+    this.settings.keyword = keyword || '*';
+  }
+
+  this.setPaging = function(page, pageSize, sortBy, sortOder) {
+    // Validate
+    if (page < 1) {
+      throw "page must be 1 or bigger";
+    }
+    if (pageSize < 1 || pageSize > 50) {
+      throw "pageSize must be 1-50";
+    }
+    if (sortOrder !== 'asc' && sortOrder !== 'desc') {
+      throw "sortOrder must be asc or desc";
+    }
+
     this.settings.paging.page = page;
     this.settings.paging.pageSize = pageSize;
     this.settings.paging.sortBy = sortBy;
     this.settings.paging.sortOder = sortOder;
   }
-  this.nextPage = function () {
+
+  this.nextPage = function() {
     this.settings.paging.page = this.settings.paging.page + 1;
   }
-  this.previousPage = function () {
+
+  this.previousPage = function() {
     if (this.settings.paging.page > 0) {
       this.settings.paging.page = this.settings.paging.page - 1;
     }