Support setting the region of your DB

Author: OndraFiedler

README.md

@@ -15,7 +15,7 @@ The library is [UMD](https://github.com/umdjs/umd) compatible.
 You can download [recombee-api-client.min.js](./dist/recombee-api-client.min.js) and host it at your site, or use a CDN such as [jsDelivr](https://www.jsdelivr.com/) CDN:
 
 ```js
-<script src="https://cdn.jsdelivr.net/gh/recombee/js-api-client@3.1.0/dist/recombee-api-client.min.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/recombee/js-api-client@4.0.0/dist/recombee-api-client.min.js"></script>
 ```
 
 ### npm
@@ -44,7 +44,7 @@ It is intentionally not possible to change item catalog (properties of items) wi
 
 ```javascript
 // Initialize client with name of your database and PUBLIC token
-var client = new recombee.ApiClient('name-of-your-db', '...db-public-token...');
+var client = new recombee.ApiClient('name-of-your-db', '...db-public-token...', {region: 'us-west'});
 
 //Interactions take Id of user and Id of item
 client.send(new recombee.AddBookmark('user-13434', 'item-256'));
@@ -189,7 +189,7 @@ Let's assume we want to show recommendations at product page of pants `product-2
         </div>
     </div>
 
-    <script src="https://cdn.jsdelivr.net/gh/recombee/js-api-client@3.1.0/dist/recombee-api-client.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/gh/recombee/js-api-client@4.0.0/dist/recombee-api-client.min.js"></script>
 
     <script type="text/javascript">
 
@@ -211,7 +211,7 @@ Let's assume we want to show recommendations at product page of pants `product-2
     }
 
     // Initialize client
-    var client = new recombee.ApiClient('js-client-example', 'dXx2Jw4VkkYQP1XU4JwBAqGezs8BNzwhogGIRjDHJi39Yj3i0tWyIZ0IhKKw5Ln7');
+    var client = new recombee.ApiClient('js-client-example', 'dXx2Jw4VkkYQP1XU4JwBAqGezs8BNzwhogGIRjDHJi39Yj3i0tWyIZ0IhKKw5Ln7', {region: 'eu-west'});
 
     var itemId = 'product-270';
     var userId = 'user-1539'

dist/recombee-api-client.js

@@ -1,6 +1,6 @@
 {
   "name": "recombee-js-api-client",
-  "version": "3.1.0",
+  "version": "4.0.0",
   "description": "Client-side js library for easy use of the Recombee recommendation API",
   "browser": "./src/index.js",
   "repository": {

dist/recombee-api-client.js.map

@@ -18,11 +18,38 @@ class ApiClient {
       this.databaseId = databaseId;
       this.publicToken = publicToken;
       this.options = options || {};
-      this.baseUri = this.options.baseUri || 'client-rapi.recombee.com';
+      this.baseUri = this._getBaseUri()
       this.useHttps = ('useHttps' in this.options) ? this.options.useHttps : true;
       this.async = ('async' in this.options) ? this.options.async : true;
   }
 
+
+  _getRegionalBaseUri(region) {
+    const uri = {
+      'ap-se': 'client-rapi-ap-se.recombee.com',
+      'ca-east': 'client-rapi-ca-east.recombee.com',
+      'eu-west': 'client-rapi-eu-west.recombee.com',
+      'us-west': 'client-rapi-us-west.recombee.com'
+    }[region.toLowerCase()];
+
+    if (uri === undefined) {
+      throw new Error(`Region "${region}" is unknown. You may need to update the version of the SDK.`)
+    }
+
+    return uri;
+  }
+
+  _getBaseUri() {
+    let baseUri = this.options.baseUri;
+    if (this.options.region) {
+      if (baseUri) {
+        throw new Error('baseUri and region cannot be specified at the same time');
+      }
+      baseUri = this._getRegionalBaseUri(this.options.region);
+    }
+    return baseUri || 'client-rapi.recombee.com';
+  }
+
   /**
    * Send the request to Recombee
    * @param {Request} request - Request to be sent

dist/recombee-api-client.min.js

@@ -110,7 +110,7 @@ class RecommendItemsToUser extends rqs.Request {
    *         - Description: **Expert option** Specifies the threshold of how much relevant must the recommended items be to the user. Possible values one of: "low", "medium", "high". The default value is "low", meaning that the system attempts to recommend number of items equal to *count* at any cost. If there are not enough data (such as interactions or item properties), this may even lead to bestseller-based recommendations to be appended to reach the full *count*. This behavior may be suppressed by using "medium" or "high" values. In such case, the system only recommends items of at least the requested relevance, and may return less than *count* items when there is not enough data to fulfill it.
    *     - *rotationRate*
    *         - Type: number
-   *         - Description: **Expert option** If your users browse the system in real-time, it may easily happen that you wish to offer them recommendations multiple times. Here comes the question: how much should the recommendations change? Should they remain the same, or should they rotate? Recombee API allows you to control this per-request in backward fashion. You may penalize an item for being recommended in the near past. For the specific user, `rotationRate=1` means maximal rotation, `rotationRate=0` means absolutely no rotation. You may also use, for example `rotationRate=0.2` for only slight rotation of recommended items. Default: `0.1`.
+   *         - Description: **Expert option** If your users browse the system in real-time, it may easily happen that you wish to offer them recommendations multiple times. Here comes the question: how much should the recommendations change? Should they remain the same, or should they rotate? Recombee API allows you to control this per-request in backward fashion. You may penalize an item for being recommended in the near past. For the specific user, `rotationRate=1` means maximal rotation, `rotationRate=0` means absolutely no rotation. You may also use, for example `rotationRate=0.2` for only slight rotation of recommended items. Default: `0`.
    *     - *rotationTime*
    *         - Type: number
    *         - Description: **Expert option** Taking *rotationRate* into account, specifies how long time it takes to an item to recover from the penalization. For example, `rotationTime=7200.0` means that items recommended less than 2 hours ago are penalized. Default: `7200.0`.

dist/recombee-api-client.min.js.map

@@ -1,5 +1,5 @@
 function createClient() {
-    return new recombee.ApiClient('tst-public-key', 'dIuCAwTeXn87m24HYE6uAIwSVzgEkTrQflrYlDBeIoeTIrhG1FVqj1v0h6u3nNSu');
+    return new recombee.ApiClient('tst-public-key', 'dIuCAwTeXn87m24HYE6uAIwSVzgEkTrQflrYlDBeIoeTIrhG1FVqj1v0h6u3nNSu', {region: 'eu-west'});
 }
 
 function testInteractionPromise(assert, interactionReq) {