Add typescript support for Index and Collection controllers (#531)

## What does this PR do?

Add typescript support for Index and Collection controllers

### Other changes

 - Update `collection:update` and `collection:create` methods (new syntax with `mappings` and `settings`)
 - Returns `undefined` instead of some useless `{ acknowledged: true }`. Since this was undocumented it's not a breaking change

Author: Aschen

.eslintignore

@@ -6,6 +6,8 @@ src/Kuzzle.js
 src/KuzzleError.js
 src/controllers/Auth.js
 src/controllers/Document.js
+src/controllers/Index.js
+src/controllers/Collection.js
 src/controllers/Base.js
 src/core/security/User.js
 src/core/security/Profile.js

.gitignore

@@ -34,6 +34,8 @@ src/Kuzzle.js
 src/KuzzleError.js
 src/controllers/Auth.js
 src/controllers/Document.js
+src/controllers/Index.js
+src/controllers/Collection.js
 src/controllers/Base.js
 src/core/security/User.js
 src/core/security/Profile.js

.travis.yml

@@ -93,7 +93,7 @@ jobs:
         - $(npm bin)/kuzdoc framework:link -d /sdk/js/7/ -v 7
       script:
         - gem install typhoeus
-        - cd doc/framework/ && HYDRA_MAX_CONCURRENCY=20 ruby .ci/dead-links.rb -p src/sdk/js/7/
+        - cd doc/framework/ && HYDRA_MAX_CONCURRENCY=20 travis_retry ruby .ci/dead-links.rb -p src/sdk/js/7/
 
     - stage: Deployment Doc Dev
       name: Deploy next-docs.kuzzle.io

doc/7/controllers/collection/create/index.md

@@ -7,17 +7,22 @@ description: Create a new collection
 
 # create
 
-Creates a new [collection](/core/2/guides/essentials/store-access-data) in Kuzzle via the persistence engine, in the provided index.
+Creates a new [collection](/core/2/guides/essentials/store-access-data) in the provided index.
 
 You can also provide an optional data mapping that allow you to exploit the full capabilities of our
-persistent data storage layer, [ElasticSearch](https://www.elastic.co/elastic-stack) (check here the [mapping capabilities of ElasticSearch](https://www.elastic.co/guide/en/elasticsearch/reference/7.3/mapping.html)).
+persistent data storage layer, [ElasticSearch](https://www.elastic.co/elastic-stack) (check here the [mapping capabilities of ElasticSearch](/core/2/guides/essentials/database-mappings/)).
 
 This method will only update the mapping if the collection already exists.
 
+<SinceBadge version="Kuzzle 2.2.0" />
+<SinceBadge version="auto-version" />
+
+You can also provide Elasticsearch [index settings](https://www.elastic.co/guide/en/elasticsearch/reference/7.5/index-modules.html#index-modules-settings) when creating a new collection.
+
 <br/>
 
 ```js
-create(index, collection, [mapping], [options]);
+create(index, collection, [definition], [options]);
 ```
 
 <br/>
@@ -26,17 +31,48 @@ create(index, collection, [mapping], [options]);
 | ------------ | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `index`      | <pre>string</pre> | Index name                                                                                                                                                                    |
 | `collection` | <pre>string</pre> | Collection name                                                                                                                                                               |
-| `mapping`    | <pre>object</pre> | Describes the data mapping to associate to the new collection, using Elasticsearch [mapping format](https://www.elastic.co/guide/en/elasticsearch/reference/7.3/mapping.html) |
+| `definition`    | <pre>object</pre> | Describes the collection mappings and the ES index settings |
 | `options`    | <pre>object</pre> | Query options                                                                                                                                                                 |
+<SinceBadge version="auto-version">
 
-### mapping
-
-An object representing the data mapping of the collection.
+### definition
 
+An object containings:
+ - [collection mappings](/core/2/guides/essentials/database-mappings).
+ - Elasticsearch [index settings](https://www.elastic.co/guide/en/elasticsearch/reference/7.5/index-modules.html#index-modules-settings)
 The mapping must have a root field `properties` that contain the mapping definition:
 
 ```js
-const mapping = {
+const definition = {
+  mappings: {
+    properties: {
+      field1: { type: 'text' },
+      field2: {
+        properties: {
+          nestedField: { type: 'keyword' }
+        }
+      }
+    }    
+  },
+  settings: {
+
+  }
+};
+```
+
+</SinceBadge>
+
+
+<DeprecatedBadge version="auto-version">
+
+### definition
+
+An object representing the data mappings of the collection.
+
+The mappings must have a root field `properties` that contain the mappings properties definition:
+
+```js
+const mappings = {
   properties: {
     field1: { type: 'text' },
     field2: {
@@ -50,6 +86,8 @@ const mapping = {
 
 More informations about database mappings [here](/core/2/guides/essentials/database-mappings).
 
+</DeprecatedBadge>
+
 ### options
 
 Additional query options

doc/7/controllers/collection/create/snippets/create.js

@@ -1,4 +1,4 @@
-const mapping = {
+const mappings = {
   properties: {
     license: { type: 'keyword' },
     driver: {
@@ -11,7 +11,7 @@ const mapping = {
 };
 
 try {
-  await kuzzle.collection.create('nyc-open-data', 'yellow-taxi', mapping);
+  await kuzzle.collection.create('nyc-open-data', 'yellow-taxi', { mappings });
 
   console.log('Success');
 } catch (error) {

doc/7/controllers/collection/exists/index.md

@@ -7,7 +7,7 @@ description: Check if collection exists
 
 # exists
 
-Check if a collection exists in Kuzzle.
+Checks if a collection exists in Kuzzle.
 
 <br/>
 

doc/7/controllers/collection/get-mapping/index.md

@@ -30,6 +30,7 @@ Additional query options
 | Property   | Type<br/>(default)              | Description                                                                  |
 | ---------- | ------------------------------- | ---------------------------------------------------------------------------- |
 | `queuable` | <pre>boolean</pre><br/>(`true`) | If true, queues the request during downtime, until connected to Kuzzle again |
+| `includeKuzzleMeta` | <pre>boolean</pre><br/>(`true`) | If true, the returned mappings will contain [Kuzzle metadata](/core/2/guides/essentials/document-metadata/) |
 
 ## Resolves
 

doc/7/controllers/collection/refresh/index.md

@@ -7,7 +7,7 @@ description: Forces an Elasticsearch search index update
 
 # refresh
 
-When writing or deleting documents in Kuzzle, the update needs to be indexed before being available in search results.
+Refreshes a collection to reindex the written and deleted documents so they are available in search results.  
 
 :::info
 A refresh operation comes with some performance costs.

doc/7/controllers/collection/update-specifications/index.md

@@ -7,7 +7,7 @@ description: Update the validation specifications
 
 # updateSpecifications
 
-The updateSpecifications method allows you to create or update the validation specifications for a collection.
+Creates or updates the validation specifications for a collection.
 
 When the validation specification is not formatted correctly, a detailed error message is returned to help you to debug.
 

doc/7/controllers/collection/update/index.md

@@ -13,28 +13,66 @@ You can define the collection [dynamic mapping policy](/core/2/guides/essentials
 
 You can define [collection additional metadata](/core/2/guides/essentials/database-mappings#collection-metadata) within the `_meta` root field.
 
+<SinceBadge version="Kuzzle 2.2.0" />
+<SinceBadge version="auto-version" />
+
+You can also provide Elasticsearch [index settings](https://www.elastic.co/guide/en/elasticsearch/reference/7.5/index-modules.html#index-modules-settings) when creating a new collection.
+
 <br/>
 
 ```js
-update(index, collection, mapping);
+update(index, collection, definition);
 ```
 
 <br/>
 
-| Arguments    | Type              | Description                                                                                                                                                                   |
-| ------------ | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `index`      | <pre>string</pre> | Index name                                                                                                                                                                    |
-| `collection` | <pre>string</pre> | Collection name                                                                                                                                                               |
-| `mapping`    | <pre>object</pre> | Describes the collection mapping  |
+| Arguments    | Type              | Description                                                 |
+|--------------|-------------------|-------------------------------------------------------------|
+| `index`      | <pre>string</pre> | Index name                                                  |
+| `collection` | <pre>string</pre> | Collection name                                             |
+| `definition` | <pre>object</pre> | Describes the collection mappings and the ES index settings |
+| `options`    | <pre>object</pre> | Query options                                               |
+
+<SinceBadge version="auto-version">
 
-### mapping
+### definition
 
-An object representing the collection data mapping.
+An object containing:
+ - [collection mappings](/core/2/guides/essentials/database-mappings).
+ - Elasticsearch [index settings](https://www.elastic.co/guide/en/elasticsearch/reference/7.5/index-modules.html#index-modules-settings)
 
-This object must have a root field `properties` that contain the mapping definition:
 
 ```js
-const mapping = {
+const definition = {
+  mappings: {
+    properties: {
+      field1: { type: 'text' },
+      field2: {
+        properties: {
+          nestedField: { type: 'keyword' }
+        }
+      }
+    }    
+  },
+  settings: {
+    // index settings (e.g. analyzers)
+  }
+};
+```
+
+</SinceBadge>
+
+
+<DeprecatedBadge version="auto-version">
+
+### definition
+
+An object representing the data mappings of the collection.
+
+The mappings must have a root field `properties` that contain the mappings properties definition:
+
+```js
+const mappings = {
   properties: {
     field1: { type: 'text' },
     field2: {
@@ -48,6 +86,9 @@ const mapping = {
 
 More informations about database mappings [here](/core/2/guides/essentials/database-mappings).
 
+</DeprecatedBadge>
+
+
 ## Resolves
 
 Resolve if the collection is successfully updated.