@algolia/client-search 5.0.0-alpha.91 → 5.0.0-alpha.98

package/dist/client-search.esm.browser.js

@@ -66,14 +66,35 @@ function createBrowserLocalStorageCache(options) {
   function getNamespace() {
     return JSON.parse(getStorage().getItem(namespaceKey) || '{}');
   }
+  function setNamespace(namespace) {
+    getStorage().setItem(namespaceKey, JSON.stringify(namespace));
+  }
+  function removeOutdatedCacheItems() {
+    const timeToLive = options.timeToLive ? options.timeToLive * 1000 : null;
+    const namespace = getNamespace();
+    const filteredNamespaceWithoutOldFormattedCacheItems = Object.fromEntries(Object.entries(namespace).filter(([, cacheItem]) => {
+      return cacheItem.timestamp !== undefined;
+    }));
+    setNamespace(filteredNamespaceWithoutOldFormattedCacheItems);
+    if (!timeToLive) {
+      return;
+    }
+    const filteredNamespaceWithoutExpiredItems = Object.fromEntries(Object.entries(filteredNamespaceWithoutOldFormattedCacheItems).filter(([, cacheItem]) => {
+      const currentTimestamp = new Date().getTime();
+      const isExpired = cacheItem.timestamp + timeToLive < currentTimestamp;
+      return !isExpired;
+    }));
+    setNamespace(filteredNamespaceWithoutExpiredItems);
+  }
   return {
     get(key, defaultValue, events = {
       miss: () => Promise.resolve()
     }) {
       return Promise.resolve().then(() => {
-        const keyAsString = JSON.stringify(key);
-        const value = getNamespace()[keyAsString];
-        return Promise.all([value || defaultValue(), value !== undefined]);
+        removeOutdatedCacheItems();
+        return getNamespace()[JSON.stringify(key)];
+      }).then(value => {
+        return Promise.all([value ? value.value : defaultValue(), value !== undefined]);
       }).then(([value, exists]) => {
         return Promise.all([value, exists || events.miss(value)]);
       }).then(([value]) => value);
@@ -81,7 +102,10 @@ function createBrowserLocalStorageCache(options) {
     set(key, value) {
       return Promise.resolve().then(() => {
         const namespace = getNamespace();
-        namespace[JSON.stringify(key)] = value;
+        namespace[JSON.stringify(key)] = {
+          timestamp: new Date().getTime(),
+          value
+        };
         getStorage().setItem(namespaceKey, JSON.stringify(namespace));
         return value;
       });
@@ -211,6 +235,20 @@ function createStatefulHost(host, status = 'up') {
   };
 }
 
+function _toPrimitive(t, r) {
+  if ("object" != typeof t || !t) return t;
+  var e = t[Symbol.toPrimitive];
+  if (void 0 !== e) {
+    var i = e.call(t, r || "default");
+    if ("object" != typeof i) return i;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return ("string" === r ? String : Number)(t);
+}
+function _toPropertyKey(t) {
+  var i = _toPrimitive(t, "string");
+  return "symbol" == typeof i ? i : String(i);
+}
 function _defineProperty(obj, key, value) {
   key = _toPropertyKey(key);
   if (key in obj) {
@@ -225,20 +263,6 @@ function _defineProperty(obj, key, value) {
   }
   return obj;
 }
-function _toPrimitive(input, hint) {
-  if (typeof input !== "object" || input === null) return input;
-  var prim = input[Symbol.toPrimitive];
-  if (prim !== undefined) {
-    var res = prim.call(input, hint || "default");
-    if (typeof res !== "object") return res;
-    throw new TypeError("@@toPrimitive must return a primitive value.");
-  }
-  return (hint === "string" ? String : Number)(input);
-}
-function _toPropertyKey(arg) {
-  var key = _toPrimitive(arg, "string");
-  return typeof key === "symbol" ? key : String(key);
-}
 
 class AlgoliaError extends Error {
   constructor(message, name) {
@@ -259,7 +283,7 @@ class ErrorWithStackTrace extends AlgoliaError {
 }
 class RetryError extends ErrorWithStackTrace {
   constructor(stackTrace) {
-    super('Unreachable hosts - your application id may be incorrect. If the error persists, contact support@algolia.com.', stackTrace, 'RetryError');
+    super('Unreachable hosts - your application id may be incorrect. If the error persists, please create a ticket at https://support.algolia.com/ sharing steps we can use to reproduce the issue.', stackTrace, 'RetryError');
   }
 }
 class ApiError extends ErrorWithStackTrace {
@@ -713,7 +737,7 @@ function createXhrRequester() {
 }
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
-const apiClientVersion = '5.0.0-alpha.91';
+const apiClientVersion = '5.0.0-alpha.98';
 function getDefaultHosts(appId) {
     return [
         {
@@ -938,21 +962,25 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * @param browseObjects.indexName - The index in which to perform the request.
          * @param browseObjects.validate - The validator function. It receive the resolved return of the API call. By default, stops when there is less hits returned than the number of maximum hits (1000).
          * @param browseObjects.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
+         * @param browseObjects.searchSynonymsParams - The `searchSynonyms` method parameters.
          * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `searchSynonyms` method and merged with the transporter requestOptions.
          */
-        browseSynonyms({ indexName, validate, aggregator, ...browseSynonymsOptions }, requestOptions) {
+        browseSynonyms({ indexName, searchSynonymsParams, ...browseSynonymsOptions }, requestOptions) {
             const params = {
+                page: 0,
+                ...searchSynonymsParams,
                 hitsPerPage: 1000,
-                ...browseSynonymsOptions,
             };
             return createIterablePromise({
                 func: (previousResponse) => {
                     return this.searchSynonyms({
-                        ...params,
                         indexName,
-                        page: previousResponse
-                            ? previousResponse.page + 1
-                            : browseSynonymsOptions.page || 0,
+                        searchSynonymsParams: {
+                            ...params,
+                            page: previousResponse
+                                ? previousResponse.page + 1
+                                : params.page,
+                        },
                     }, requestOptions);
                 },
                 validate: (response) => response.nbHits < params.hitsPerPage,
@@ -1226,24 +1254,20 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete all synonyms in the index.
+         * Delete the records but leave settings and index-specific API keys untouched.
          *
-         * @summary Delete all synonyms.
-         * @param clearAllSynonyms - The clearAllSynonyms object.
-         * @param clearAllSynonyms.indexName - Index on which to perform the request.
-         * @param clearAllSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @summary Delete all records from an index.
+         * @param clearObjects - The clearObjects object.
+         * @param clearObjects.indexName - Index on which to perform the request.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
-        clearAllSynonyms({ indexName, forwardToReplicas }, requestOptions) {
+        clearObjects({ indexName }, requestOptions) {
             if (!indexName) {
-                throw new Error('Parameter `indexName` is required when calling `clearAllSynonyms`.');
+                throw new Error('Parameter `indexName` is required when calling `clearObjects`.');
             }
-            const requestPath = '/1/indexes/{indexName}/synonyms/clear'.replace('{indexName}', encodeURIComponent(indexName));
+            const requestPath = '/1/indexes/{indexName}/clear'.replace('{indexName}', encodeURIComponent(indexName));
             const headers = {};
             const queryParameters = {};
-            if (forwardToReplicas !== undefined) {
-                queryParameters.forwardToReplicas = forwardToReplicas.toString();
-            }
             const request = {
                 method: 'POST',
                 path: requestPath,
@@ -1253,20 +1277,24 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete the records but leave settings and index-specific API keys untouched.
+         * Delete all rules in the index.
          *
-         * @summary Delete all records from an index.
-         * @param clearObjects - The clearObjects object.
-         * @param clearObjects.indexName - Index on which to perform the request.
+         * @summary Delete all rules.
+         * @param clearRules - The clearRules object.
+         * @param clearRules.indexName - Index on which to perform the request.
+         * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
-        clearObjects({ indexName }, requestOptions) {
+        clearRules({ indexName, forwardToReplicas }, requestOptions) {
             if (!indexName) {
-                throw new Error('Parameter `indexName` is required when calling `clearObjects`.');
+                throw new Error('Parameter `indexName` is required when calling `clearRules`.');
             }
-            const requestPath = '/1/indexes/{indexName}/clear'.replace('{indexName}', encodeURIComponent(indexName));
+            const requestPath = '/1/indexes/{indexName}/rules/clear'.replace('{indexName}', encodeURIComponent(indexName));
             const headers = {};
             const queryParameters = {};
+            if (forwardToReplicas !== undefined) {
+                queryParameters.forwardToReplicas = forwardToReplicas.toString();
+            }
             const request = {
                 method: 'POST',
                 path: requestPath,
@@ -1276,19 +1304,19 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Delete all rules in the index.
+         * Delete all synonyms in the index.
          *
-         * @summary Delete all rules.
-         * @param clearRules - The clearRules object.
-         * @param clearRules.indexName - Index on which to perform the request.
-         * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
+         * @summary Delete all synonyms.
+         * @param clearSynonyms - The clearSynonyms object.
+         * @param clearSynonyms.indexName - Index on which to perform the request.
+         * @param clearSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
-        clearRules({ indexName, forwardToReplicas }, requestOptions) {
+        clearSynonyms({ indexName, forwardToReplicas }, requestOptions) {
             if (!indexName) {
-                throw new Error('Parameter `indexName` is required when calling `clearRules`.');
+                throw new Error('Parameter `indexName` is required when calling `clearSynonyms`.');
             }
-            const requestPath = '/1/indexes/{indexName}/rules/clear'.replace('{indexName}', encodeURIComponent(indexName));
+            const requestPath = '/1/indexes/{indexName}/synonyms/clear'.replace('{indexName}', encodeURIComponent(indexName));
             const headers = {};
             const queryParameters = {};
             if (forwardToReplicas !== undefined) {
@@ -1306,14 +1334,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * This method allow you to send requests to the Algolia REST API.
          *
          * @summary Send requests to the Algolia REST API.
-         * @param del - The del object.
-         * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
-         * @param del.parameters - Query parameters to apply to the current query.
+         * @param customDelete - The customDelete object.
+         * @param customDelete.path - Path of the endpoint, anything after \"/1\" must be specified.
+         * @param customDelete.parameters - Query parameters to apply to the current query.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
-        del({ path, parameters }, requestOptions) {
+        customDelete({ path, parameters }, requestOptions) {
             if (!path) {
-                throw new Error('Parameter `path` is required when calling `del`.');
+                throw new Error('Parameter `path` is required when calling `customDelete`.');
             }
             const requestPath = '/1{path}'.replace('{path}', path);
             const headers = {};
@@ -1326,6 +1354,82 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             };
             return transporter.request(request, requestOptions);
         },
+        /**
+         * This method allow you to send requests to the Algolia REST API.
+         *
+         * @summary Send requests to the Algolia REST API.
+         * @param customGet - The customGet object.
+         * @param customGet.path - Path of the endpoint, anything after \"/1\" must be specified.
+         * @param customGet.parameters - Query parameters to apply to the current query.
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        customGet({ path, parameters }, requestOptions) {
+            if (!path) {
+                throw new Error('Parameter `path` is required when calling `customGet`.');
+            }
+            const requestPath = '/1{path}'.replace('{path}', path);
+            const headers = {};
+            const queryParameters = parameters ? parameters : {};
+            const request = {
+                method: 'GET',
+                path: requestPath,
+                queryParameters,
+                headers,
+            };
+            return transporter.request(request, requestOptions);
+        },
+        /**
+         * This method allow you to send requests to the Algolia REST API.
+         *
+         * @summary Send requests to the Algolia REST API.
+         * @param customPost - The customPost object.
+         * @param customPost.path - Path of the endpoint, anything after \"/1\" must be specified.
+         * @param customPost.parameters - Query parameters to apply to the current query.
+         * @param customPost.body - Parameters to send with the custom request.
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        customPost({ path, parameters, body }, requestOptions) {
+            if (!path) {
+                throw new Error('Parameter `path` is required when calling `customPost`.');
+            }
+            const requestPath = '/1{path}'.replace('{path}', path);
+            const headers = {};
+            const queryParameters = parameters ? parameters : {};
+            const request = {
+                method: 'POST',
+                path: requestPath,
+                queryParameters,
+                headers,
+                data: body ? body : {},
+            };
+            return transporter.request(request, requestOptions);
+        },
+        /**
+         * This method allow you to send requests to the Algolia REST API.
+         *
+         * @summary Send requests to the Algolia REST API.
+         * @param customPut - The customPut object.
+         * @param customPut.path - Path of the endpoint, anything after \"/1\" must be specified.
+         * @param customPut.parameters - Query parameters to apply to the current query.
+         * @param customPut.body - Parameters to send with the custom request.
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        customPut({ path, parameters, body }, requestOptions) {
+            if (!path) {
+                throw new Error('Parameter `path` is required when calling `customPut`.');
+            }
+            const requestPath = '/1{path}'.replace('{path}', path);
+            const headers = {};
+            const queryParameters = parameters ? parameters : {};
+            const request = {
+                method: 'PUT',
+                path: requestPath,
+                queryParameters,
+                headers,
+                data: body ? body : {},
+            };
+            return transporter.request(request, requestOptions);
+        },
         /**
          * Delete an existing API key. The request must be authenticated with the admin API key.
          *
@@ -1518,30 +1622,6 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             };
             return transporter.request(request, requestOptions);
         },
-        /**
-         * This method allow you to send requests to the Algolia REST API.
-         *
-         * @summary Send requests to the Algolia REST API.
-         * @param get - The get object.
-         * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
-         * @param get.parameters - Query parameters to apply to the current query.
-         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
-         */
-        get({ path, parameters }, requestOptions) {
-            if (!path) {
-                throw new Error('Parameter `path` is required when calling `get`.');
-            }
-            const requestPath = '/1{path}'.replace('{path}', path);
-            const headers = {};
-            const queryParameters = parameters ? parameters : {};
-            const request = {
-                method: 'GET',
-                path: requestPath,
-                queryParameters,
-                headers,
-            };
-            return transporter.request(request, requestOptions);
-        },
         /**
          * Get the permissions and restrictions of a specific API key. When authenticating with the admin API key, you can request information for any of your application\'s keys. When authenticating with other API keys, you can only retrieve information for that key.
          *
@@ -2077,58 +2157,6 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             };
             return transporter.request(request, requestOptions);
         },
-        /**
-         * This method allow you to send requests to the Algolia REST API.
-         *
-         * @summary Send requests to the Algolia REST API.
-         * @param post - The post object.
-         * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
-         * @param post.parameters - Query parameters to apply to the current query.
-         * @param post.body - Parameters to send with the custom request.
-         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
-         */
-        post({ path, parameters, body }, requestOptions) {
-            if (!path) {
-                throw new Error('Parameter `path` is required when calling `post`.');
-            }
-            const requestPath = '/1{path}'.replace('{path}', path);
-            const headers = {};
-            const queryParameters = parameters ? parameters : {};
-            const request = {
-                method: 'POST',
-                path: requestPath,
-                queryParameters,
-                headers,
-                data: body ? body : {},
-            };
-            return transporter.request(request, requestOptions);
-        },
-        /**
-         * This method allow you to send requests to the Algolia REST API.
-         *
-         * @summary Send requests to the Algolia REST API.
-         * @param put - The put object.
-         * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
-         * @param put.parameters - Query parameters to apply to the current query.
-         * @param put.body - Parameters to send with the custom request.
-         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
-         */
-        put({ path, parameters, body }, requestOptions) {
-            if (!path) {
-                throw new Error('Parameter `path` is required when calling `put`.');
-            }
-            const requestPath = '/1{path}'.replace('{path}', path);
-            const headers = {};
-            const queryParameters = parameters ? parameters : {};
-            const request = {
-                method: 'PUT',
-                path: requestPath,
-                queryParameters,
-                headers,
-                data: body ? body : {},
-            };
-            return transporter.request(request, requestOptions);
-        },
         /**
          * Remove a userID and its associated data from the multi-clusters.
          *
@@ -2561,28 +2589,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * @summary Search for synonyms.
          * @param searchSynonyms - The searchSynonyms object.
          * @param searchSynonyms.indexName - Index on which to perform the request.
-         * @param searchSynonyms.type - Search for specific [types of synonyms](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms).
-         * @param searchSynonyms.page - Returns the requested page number (the first page is 0). Page size is set by `hitsPerPage`. When null, there\'s no pagination.
-         * @param searchSynonyms.hitsPerPage - Maximum number of hits per page.
          * @param searchSynonyms.searchSynonymsParams - Body of the `searchSynonyms` operation.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
-        searchSynonyms({ indexName, type, page, hitsPerPage, searchSynonymsParams, }, requestOptions) {
+        searchSynonyms({ indexName, searchSynonymsParams }, requestOptions) {
             if (!indexName) {
                 throw new Error('Parameter `indexName` is required when calling `searchSynonyms`.');
             }
             const requestPath = '/1/indexes/{indexName}/synonyms/search'.replace('{indexName}', encodeURIComponent(indexName));
             const headers = {};
             const queryParameters = {};
-            if (type !== undefined) {
-                queryParameters.type = type.toString();
-            }
-            if (page !== undefined) {
-                queryParameters.page = page.toString();
-            }
-            if (hitsPerPage !== undefined) {
-                queryParameters.hitsPerPage = hitsPerPage.toString();
-            }
             const request = {
                 method: 'POST',
                 path: requestPath,