Merge branch '7-dev' of github.com:kuzzleio/sdk-javascript into 7-dev

Author: Aschen

doc/7/core-classes/observer/constructor/index.md

@@ -0,0 +1,38 @@
+---
+code: true
+type: page
+title: constructor
+description: Creates a new Observer object
+order: 50
+---
+
+# Constructor
+
+Use this constructor to create a new Observer instance.
+
+## Arguments
+
+```js
+Observer(sdk, [options]);
+```
+
+<br/>
+
+| Argument  | Type              | Description                    |
+|-----------|-------------------|--------------------------------|
+| `sdk`     | <pre>Kuzzle</pre> | SDK instanciated and connected |
+| `options` | <pre>object</pre> | Additional options             |
+
+### options
+
+Observer options.
+
+| Property       | Type<br/>(default)             | Description                                                  |
+|----------------|--------------------------------|--------------------------------------------------------------|
+| `pullingDelay` | <pre>number</pre><br/>(`5000`) | Refresh delay in ms when the SDK is using the HTTP protocol. |
+
+## Usage
+
+```js
+const observer = new Observer(sdk);
+```

doc/7/core-classes/observer/introduction/index.md

@@ -35,3 +35,11 @@ await observer.stop('nyc-open-data', 'yellow-taxi');
 A good frontend practice is to instantiate one observer for the actual page
 and/or component(s) displaying realtime documents and to dispose them when
 they are not displayed anymore.
+
+## Using HTTP protocol
+
+<SinceBadge version="auto-version"/>
+
+If the SDK is using the HTTP protocol, then documents are retrieved through the [document.mGet](/sdk/js/7/controllers/document/m-get) method every specified interval (default is 5 sec).
+
+This interval can be modified with the `pullingDelay` option of the constructor.

doc/7/essentials/realtime-application/index.md

@@ -101,3 +101,13 @@ let realtimeResult = await observer.search('nyc-open-data', 'yellow-taxi', { que
 // Dispose ressources for all managed realtime documents of this collection
 await observer.stop('nyc-open-data', 'yellow-taxi');
 ```
+
+### HTTP support for realtime documents
+
+<SinceBadge version="auto-version"/>
+
+If the SDK is using the HTTP protocol, then the realtime controller cannot be used.
+
+Instead, the [document.mGet](/sdk/js/7/controllers/document/m-get) method will be used every 5 seconds to retrieve documents from Kuzzle.
+
+The pulling delay can be modified using the `pullingDelay` option of the constructor.

src/Kuzzle.ts

@@ -18,6 +18,7 @@ import { JSONObject } from './types';
 import { RequestPayload } from './types/RequestPayload';
 import { ResponsePayload } from './types/ResponsePayload';
 import { RequestTimeoutError } from './RequestTimeoutError';
+import { BaseProtocolRealtime } from './protocols/abstract/Realtime';
 
 // Defined by webpack plugin
 declare const SDKVERSION: any;
@@ -403,12 +404,14 @@ export class Kuzzle extends KuzzleEventEmitter {
   }
 
   get autoReconnect () {
-    return this.protocol.autoReconnect;
+    const protocol = this.protocol as BaseProtocolRealtime;
+    return protocol.autoReconnect;
   }
 
   set autoReconnect (value) {
     this._checkPropertyType('autoReconnect', 'boolean', value);
-    this.protocol.autoReconnect = value;
+    const protocol = this.protocol as BaseProtocolRealtime;
+    protocol.autoReconnect = value;
   }
 
   get autoReplay () {
@@ -498,7 +501,8 @@ export class Kuzzle extends KuzzleEventEmitter {
   }
 
   get reconnectionDelay () {
-    return this.protocol.reconnectionDelay;
+    const protocol = this.protocol as BaseProtocolRealtime;
+    return protocol.reconnectionDelay;
   }
 
   get replayInterval () {