@algolia/client-search 5.0.0-beta.1 → 5.0.0-beta.11

package/dist/client-search.cjs

@@ -5,7 +5,7 @@ var clientCommon = require('@algolia/client-common');
 var requesterNodeHttp = require('@algolia/requester-node-http');
 
 // 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-beta.1';
+const apiClientVersion = '5.0.0-beta.11';
 function getDefaultHosts(appId) {
     return [
         {
@@ -111,6 +111,29 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
                 timeout: () => timeout(retryCount),
             });
         },
+        /**
+         * Helper: Wait for an application-level task to complete for a given `taskID`.
+         *
+         * @summary Helper method that waits for a task to be published (completed).
+         * @param waitForAppTaskOptions - The `waitForTaskOptions` object.
+         * @param waitForAppTaskOptions.taskID - The `taskID` returned in the method response.
+         * @param waitForAppTaskOptions.maxRetries - The maximum number of retries. 50 by default.
+         * @param waitForAppTaskOptions.timeout - The function to decide how long to wait between retries.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
+         */
+        waitForAppTask({ taskID, maxRetries = 50, timeout = (retryCount) => Math.min(retryCount * 200, 5000), }, requestOptions) {
+            let retryCount = 0;
+            return clientCommon.createIterablePromise({
+                func: () => this.getAppTask({ taskID }, requestOptions),
+                validate: (response) => response.status === 'published',
+                aggregator: () => (retryCount += 1),
+                error: {
+                    validate: () => retryCount >= maxRetries,
+                    message: () => `The maximum number of retries exceeded. (${retryCount}/${maxRetries})`,
+                },
+                timeout: () => timeout(retryCount),
+            });
+        },
         /**
          * Helper: Wait for an API key to be added, updated or deleted based on a given `operation`.
          *
@@ -160,8 +183,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             }
             return clientCommon.createIterablePromise({
                 ...baseIteratorOptions,
-                func: () => this.getApiKey({ key }, requestOptions).catch((error) => error),
-                validate: (error) => operation === 'add' ? error.status !== 404 : error.status === 404,
+                func: () => this.getApiKey({ key }, requestOptions).catch((error) => {
+                    if (error.status === 404) {
+                        return undefined;
+                    }
+                    throw error;
+                }),
+                validate: (response) => operation === 'add' ? response !== undefined : response === undefined,
             });
         },
         /**
@@ -292,9 +320,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         async chunkedBatch({ indexName, objects, action = 'addObject', waitForTasks, batchSize = 1000, }, requestOptions) {
             let requests = [];
             const responses = [];
-            for (const [i, obj] of objects.entries()) {
+            const objectEntries = objects.entries();
+            for (const [i, obj] of objectEntries) {
                 requests.push({ action, body: obj });
-                if (i % batchSize === 0) {
+                if (requests.length === batchSize || i === objects.length - 1) {
                     responses.push(await this.batch({ indexName, batchWriteParams: { requests } }, requestOptions));
                     requests = [];
                 }
@@ -306,20 +335,68 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             }
             return responses;
         },
+        /**
+         * Helper: Saves the given array of objects in the given index. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objects in it.
+         *
+         * @summary Helper: Saves the given array of objects in the given index. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objects in it.
+         * @param saveObjects - The `saveObjects` object.
+         * @param saveObjects.indexName - The `indexName` to save `objects` in.
+         * @param saveObjects.objects - The array of `objects` to store in the given Algolia `indexName`.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `batch` method and merged with the transporter requestOptions.
+         */
+        async saveObjects({ indexName, objects }, requestOptions) {
+            return await this.chunkedBatch({ indexName, objects, action: 'addObject' }, requestOptions);
+        },
+        /**
+         * Helper: Deletes every records for the given objectIDs. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objectIDs in it.
+         *
+         * @summary Helper: Deletes every records for the given objectIDs. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objectIDs in it.
+         * @param deleteObjects - The `deleteObjects` object.
+         * @param deleteObjects.indexName - The `indexName` to delete `objectIDs` from.
+         * @param deleteObjects.objectIDs - The objectIDs to delete.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `batch` method and merged with the transporter requestOptions.
+         */
+        async deleteObjects({ indexName, objectIDs }, requestOptions) {
+            return await this.chunkedBatch({
+                indexName,
+                objects: objectIDs.map((objectID) => ({ objectID })),
+                action: 'deleteObject',
+            }, requestOptions);
+        },
+        /**
+         * Helper: Replaces object content of all the given objects according to their respective `objectID` field. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objects in it.
+         *
+         * @summary Helper: Replaces object content of all the given objects according to their respective `objectID` field. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objects in it.
+         * @param partialUpdateObjects - The `partialUpdateObjects` object.
+         * @param partialUpdateObjects.indexName - The `indexName` to update `objects` in.
+         * @param partialUpdateObjects.objects - The array of `objects` to update in the given Algolia `indexName`.
+         * @param partialUpdateObjects.createIfNotExists - To be provided if non-existing objects are passed, otherwise, the call will fail..
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
+         */
+        async partialUpdateObjects({ indexName, objects, createIfNotExists }, requestOptions) {
+            return await this.chunkedBatch({
+                indexName,
+                objects,
+                action: createIfNotExists
+                    ? 'partialUpdateObject'
+                    : 'partialUpdateObjectNoCreate',
+            }, requestOptions);
+        },
         /**
          * Helper: Replaces all objects (records) in the given `index_name` with the given `objects`. A temporary index is created during this process in order to backup your data.
+         * See https://api-clients-automation.netlify.app/docs/contributing/add-new-api-client#5-helpers for implementation details.
          *
          * @summary Helper: Replaces all objects (records) in the given `index_name` with the given `objects`. A temporary index is created during this process in order to backup your data.
          * @param replaceAllObjects - The `replaceAllObjects` object.
          * @param replaceAllObjects.indexName - The `indexName` to replace `objects` in.
          * @param replaceAllObjects.objects - The array of `objects` to store in the given Algolia `indexName`.
-         * @param replaceAllObjects.batchSize - The size of the chunk of `objects`. The number of `batch` calls will be equal to `length(objects) / batchSize`. Defaults to 1000.
-         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
+         * @param replaceAllObjects.batchSize - The size of the chunk of `objects`. The number of `batch` calls will be equal to `objects.length / batchSize`. Defaults to 1000.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `batch`, `operationIndex` and `getTask` method and merged with the transporter requestOptions.
          */
         async replaceAllObjects({ indexName, objects, batchSize }, requestOptions) {
-            const randomSuffix = Math.random().toString(36).substring(7);
+            const randomSuffix = Math.floor(Math.random() * 1000000) + 100000;
             const tmpIndexName = `${indexName}_tmp_${randomSuffix}`;
-            const copyOperationResponse = await this.operationIndex({
+            let copyOperationResponse = await this.operationIndex({
                 indexName,
                 operationIndexParams: {
                     operation: 'copy',
@@ -327,17 +404,29 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
                     scope: ['settings', 'rules', 'synonyms'],
                 },
             }, requestOptions);
+            const batchResponses = await this.chunkedBatch({ indexName: tmpIndexName, objects, waitForTasks: true, batchSize }, requestOptions);
             await this.waitForTask({
+                indexName: tmpIndexName,
+                taskID: copyOperationResponse.taskID,
+            });
+            copyOperationResponse = await this.operationIndex({
                 indexName,
+                operationIndexParams: {
+                    operation: 'copy',
+                    destination: tmpIndexName,
+                    scope: ['settings', 'rules', 'synonyms'],
+                },
+            }, requestOptions);
+            await this.waitForTask({
+                indexName: tmpIndexName,
                 taskID: copyOperationResponse.taskID,
             });
-            const batchResponses = await this.chunkedBatch({ indexName: tmpIndexName, objects, waitForTasks: true, batchSize }, requestOptions);
             const moveOperationResponse = await this.operationIndex({
                 indexName: tmpIndexName,
                 operationIndexParams: { operation: 'move', destination: indexName },
             }, requestOptions);
             await this.waitForTask({
-                indexName,
+                indexName: tmpIndexName,
                 taskID: moveOperationResponse.taskID,
             });
             return { copyOperationResponse, batchResponses, moveOperationResponse };
@@ -573,7 +662,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn\'t collect data when using `browse`. - Records are ranked by attributes and custom ranking. - Deduplication (`distinct`) is turned off. - There\'s no ranking for: typo-tolerance, number of matched words, proximity, geo distance.
+         * Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn\'t collect data when using `browse`. - Records are ranked by attributes and custom ranking. - There\'s no ranking for: typo-tolerance, number of matched words, proximity, geo distance.  Browse requests automatically apply these settings:  - `advancedSyntax`: `false` - `attributesToHighlight`: `[]` - `attributesToSnippet`: `[]` - `distinct`: `false` - `enablePersonalization`: `false` - `enableRules`: `false` - `facets`: `[]` - `getRankingInfo`: `false` - `ignorePlurals`: `false` - `optionalFilters`: `[]` - `typoTolerance`: `true` or `false` (`min` and `strict` is evaluated to `true`)  If you send these parameters with your browse requests, they\'ll be ignored.
          *
          * Required API Key ACLs:
          * - browse.
@@ -1006,6 +1095,31 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             };
             return transporter.request(request, requestOptions);
         },
+        /**
+         * Checks the status of a given application task.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
+         *
+         * @param getAppTask - The getAppTask object.
+         * @param getAppTask.taskID - Unique task identifier.
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        getAppTask({ taskID }, requestOptions) {
+            if (!taskID) {
+                throw new Error('Parameter `taskID` is required when calling `getAppTask`.');
+            }
+            const requestPath = '/1/task/{taskID}'.replace('{taskID}', encodeURIComponent(taskID));
+            const headers = {};
+            const queryParameters = {};
+            const request = {
+                method: 'GET',
+                path: requestPath,
+                queryParameters,
+                headers,
+            };
+            return transporter.request(request, requestOptions);
+        },
         /**
          * Lists supported languages with their supported dictionary types and number of custom entries.
          *
@@ -1480,7 +1594,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for index-specific API keys and analytics data. - If the destination index doesn\'t exist yet, it\'ll be created.  **Copy**  - Copying a source index that doesn\'t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can\'t copy the `enableReRanking`, `mode`, and `replicas` settings. - You can\'t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn\'t exist is ignored without returning an error. - When moving an index, the analytics data keep their original name and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
+         * Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn\'t exist yet, it\'ll be created.  **Copy**  - Copying a source index that doesn\'t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can\'t copy the `enableReRanking`, `mode`, and `replicas` settings. - You can\'t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn\'t exist is ignored without returning an error. - When moving an index, the analytics data keep their original name and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
          *
          * Required API Key ACLs:
          * - addObject.
@@ -2198,7 +2312,23 @@ function searchClient(appId, apiKey, options) {
          * @param generateSecuredApiKey.restrictions - A set of properties defining the restrictions of the secured API key.
          */
         generateSecuredApiKey({ parentApiKey, restrictions = {}, }) {
-            const queryParameters = clientCommon.serializeQueryParameters(restrictions);
+            let mergedRestrictions = restrictions;
+            if (restrictions.searchParams) {
+                // merge searchParams with the root restrictions
+                mergedRestrictions = {
+                    ...restrictions,
+                    ...restrictions.searchParams,
+                };
+                delete mergedRestrictions.searchParams;
+            }
+            mergedRestrictions = Object.keys(mergedRestrictions)
+                .sort()
+                .reduce((acc, key) => {
+                // eslint-disable-next-line no-param-reassign
+                acc[key] = mergedRestrictions[key];
+                return acc;
+            }, {});
+            const queryParameters = clientCommon.serializeQueryParameters(mergedRestrictions);
             return Buffer.from(crypto.createHmac('sha256', parentApiKey)
                 .update(queryParameters)
                 .digest('hex') + queryParameters).toString('base64');

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

@@ -235,6 +235,14 @@ function createStatefulHost(host, status = 'up') {
   };
 }
 
+function _defineProperty(e, r, t) {
+  return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+    value: t,
+    enumerable: !0,
+    configurable: !0,
+    writable: !0
+  }) : e[r] = t, e;
+}
 function _toPrimitive(t, r) {
   if ("object" != typeof t || !t) return t;
   var e = t[Symbol.toPrimitive];
@@ -249,20 +257,6 @@ function _toPropertyKey(t) {
   var i = _toPrimitive(t, "string");
   return "symbol" == typeof i ? i : i + "";
 }
-function _defineProperty(obj, key, value) {
-  key = _toPropertyKey(key);
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value: value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 
 class AlgoliaError extends Error {
   constructor(message, name) {
@@ -283,7 +277,7 @@ class ErrorWithStackTrace extends AlgoliaError {
 }
 class RetryError extends ErrorWithStackTrace {
   constructor(stackTrace) {
-    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');
+    super('Unreachable hosts - your application id may be incorrect. If the error persists, please reach out to the Algolia Support team: https://alg.li/support.', stackTrace, 'RetryError');
   }
 }
 class ApiError extends ErrorWithStackTrace {
@@ -328,8 +322,7 @@ function serializeUrl(host, path, queryParameters) {
   return url;
 }
 function serializeQueryParameters(parameters) {
-  const isObjectOrArray = value => Object.prototype.toString.call(value) === '[object Object]' || Object.prototype.toString.call(value) === '[object Array]';
-  return Object.keys(parameters).map(key => `${key}=${encodeURIComponent(isObjectOrArray(parameters[key]) ? JSON.stringify(parameters[key]) : parameters[key]).replaceAll('+', '%20')}`).join('&');
+  return Object.keys(parameters).filter(key => parameters[key] !== undefined).sort().map(key => `${key}=${encodeURIComponent(Object.prototype.toString.call(parameters[key]) === '[object Array]' ? parameters[key].join(',') : parameters[key]).replaceAll('+', '%20')}`).join('&');
 }
 function serializeData(request, requestOptions) {
   if (request.method === 'GET' || request.data === undefined && requestOptions.data === undefined) {
@@ -734,7 +727,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-beta.1';
+const apiClientVersion = '5.0.0-beta.11';
 function getDefaultHosts(appId) {
     return [
         {
@@ -840,6 +833,29 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
                 timeout: () => timeout(retryCount),
             });
         },
+        /**
+         * Helper: Wait for an application-level task to complete for a given `taskID`.
+         *
+         * @summary Helper method that waits for a task to be published (completed).
+         * @param waitForAppTaskOptions - The `waitForTaskOptions` object.
+         * @param waitForAppTaskOptions.taskID - The `taskID` returned in the method response.
+         * @param waitForAppTaskOptions.maxRetries - The maximum number of retries. 50 by default.
+         * @param waitForAppTaskOptions.timeout - The function to decide how long to wait between retries.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
+         */
+        waitForAppTask({ taskID, maxRetries = 50, timeout = (retryCount) => Math.min(retryCount * 200, 5000), }, requestOptions) {
+            let retryCount = 0;
+            return createIterablePromise({
+                func: () => this.getAppTask({ taskID }, requestOptions),
+                validate: (response) => response.status === 'published',
+                aggregator: () => (retryCount += 1),
+                error: {
+                    validate: () => retryCount >= maxRetries,
+                    message: () => `The maximum number of retries exceeded. (${retryCount}/${maxRetries})`,
+                },
+                timeout: () => timeout(retryCount),
+            });
+        },
         /**
          * Helper: Wait for an API key to be added, updated or deleted based on a given `operation`.
          *
@@ -889,8 +905,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             }
             return createIterablePromise({
                 ...baseIteratorOptions,
-                func: () => this.getApiKey({ key }, requestOptions).catch((error) => error),
-                validate: (error) => operation === 'add' ? error.status !== 404 : error.status === 404,
+                func: () => this.getApiKey({ key }, requestOptions).catch((error) => {
+                    if (error.status === 404) {
+                        return undefined;
+                    }
+                    throw error;
+                }),
+                validate: (response) => operation === 'add' ? response !== undefined : response === undefined,
             });
         },
         /**
@@ -1021,9 +1042,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         async chunkedBatch({ indexName, objects, action = 'addObject', waitForTasks, batchSize = 1000, }, requestOptions) {
             let requests = [];
             const responses = [];
-            for (const [i, obj] of objects.entries()) {
+            const objectEntries = objects.entries();
+            for (const [i, obj] of objectEntries) {
                 requests.push({ action, body: obj });
-                if (i % batchSize === 0) {
+                if (requests.length === batchSize || i === objects.length - 1) {
                     responses.push(await this.batch({ indexName, batchWriteParams: { requests } }, requestOptions));
                     requests = [];
                 }
@@ -1035,20 +1057,68 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             }
             return responses;
         },
+        /**
+         * Helper: Saves the given array of objects in the given index. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objects in it.
+         *
+         * @summary Helper: Saves the given array of objects in the given index. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objects in it.
+         * @param saveObjects - The `saveObjects` object.
+         * @param saveObjects.indexName - The `indexName` to save `objects` in.
+         * @param saveObjects.objects - The array of `objects` to store in the given Algolia `indexName`.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `batch` method and merged with the transporter requestOptions.
+         */
+        async saveObjects({ indexName, objects }, requestOptions) {
+            return await this.chunkedBatch({ indexName, objects, action: 'addObject' }, requestOptions);
+        },
+        /**
+         * Helper: Deletes every records for the given objectIDs. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objectIDs in it.
+         *
+         * @summary Helper: Deletes every records for the given objectIDs. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objectIDs in it.
+         * @param deleteObjects - The `deleteObjects` object.
+         * @param deleteObjects.indexName - The `indexName` to delete `objectIDs` from.
+         * @param deleteObjects.objectIDs - The objectIDs to delete.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `batch` method and merged with the transporter requestOptions.
+         */
+        async deleteObjects({ indexName, objectIDs }, requestOptions) {
+            return await this.chunkedBatch({
+                indexName,
+                objects: objectIDs.map((objectID) => ({ objectID })),
+                action: 'deleteObject',
+            }, requestOptions);
+        },
+        /**
+         * Helper: Replaces object content of all the given objects according to their respective `objectID` field. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objects in it.
+         *
+         * @summary Helper: Replaces object content of all the given objects according to their respective `objectID` field. The `chunkedBatch` helper is used under the hood, which creates a `batch` requests with at most 1000 objects in it.
+         * @param partialUpdateObjects - The `partialUpdateObjects` object.
+         * @param partialUpdateObjects.indexName - The `indexName` to update `objects` in.
+         * @param partialUpdateObjects.objects - The array of `objects` to update in the given Algolia `indexName`.
+         * @param partialUpdateObjects.createIfNotExists - To be provided if non-existing objects are passed, otherwise, the call will fail..
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
+         */
+        async partialUpdateObjects({ indexName, objects, createIfNotExists }, requestOptions) {
+            return await this.chunkedBatch({
+                indexName,
+                objects,
+                action: createIfNotExists
+                    ? 'partialUpdateObject'
+                    : 'partialUpdateObjectNoCreate',
+            }, requestOptions);
+        },
         /**
          * Helper: Replaces all objects (records) in the given `index_name` with the given `objects`. A temporary index is created during this process in order to backup your data.
+         * See https://api-clients-automation.netlify.app/docs/contributing/add-new-api-client#5-helpers for implementation details.
          *
          * @summary Helper: Replaces all objects (records) in the given `index_name` with the given `objects`. A temporary index is created during this process in order to backup your data.
          * @param replaceAllObjects - The `replaceAllObjects` object.
          * @param replaceAllObjects.indexName - The `indexName` to replace `objects` in.
          * @param replaceAllObjects.objects - The array of `objects` to store in the given Algolia `indexName`.
-         * @param replaceAllObjects.batchSize - The size of the chunk of `objects`. The number of `batch` calls will be equal to `length(objects) / batchSize`. Defaults to 1000.
-         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
+         * @param replaceAllObjects.batchSize - The size of the chunk of `objects`. The number of `batch` calls will be equal to `objects.length / batchSize`. Defaults to 1000.
+         * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `batch`, `operationIndex` and `getTask` method and merged with the transporter requestOptions.
          */
         async replaceAllObjects({ indexName, objects, batchSize }, requestOptions) {
-            const randomSuffix = Math.random().toString(36).substring(7);
+            const randomSuffix = Math.floor(Math.random() * 1000000) + 100000;
             const tmpIndexName = `${indexName}_tmp_${randomSuffix}`;
-            const copyOperationResponse = await this.operationIndex({
+            let copyOperationResponse = await this.operationIndex({
                 indexName,
                 operationIndexParams: {
                     operation: 'copy',
@@ -1056,17 +1126,29 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
                     scope: ['settings', 'rules', 'synonyms'],
                 },
             }, requestOptions);
+            const batchResponses = await this.chunkedBatch({ indexName: tmpIndexName, objects, waitForTasks: true, batchSize }, requestOptions);
             await this.waitForTask({
+                indexName: tmpIndexName,
+                taskID: copyOperationResponse.taskID,
+            });
+            copyOperationResponse = await this.operationIndex({
                 indexName,
+                operationIndexParams: {
+                    operation: 'copy',
+                    destination: tmpIndexName,
+                    scope: ['settings', 'rules', 'synonyms'],
+                },
+            }, requestOptions);
+            await this.waitForTask({
+                indexName: tmpIndexName,
                 taskID: copyOperationResponse.taskID,
             });
-            const batchResponses = await this.chunkedBatch({ indexName: tmpIndexName, objects, waitForTasks: true, batchSize }, requestOptions);
             const moveOperationResponse = await this.operationIndex({
                 indexName: tmpIndexName,
                 operationIndexParams: { operation: 'move', destination: indexName },
             }, requestOptions);
             await this.waitForTask({
-                indexName,
+                indexName: tmpIndexName,
                 taskID: moveOperationResponse.taskID,
             });
             return { copyOperationResponse, batchResponses, moveOperationResponse };
@@ -1302,7 +1384,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn\'t collect data when using `browse`. - Records are ranked by attributes and custom ranking. - Deduplication (`distinct`) is turned off. - There\'s no ranking for: typo-tolerance, number of matched words, proximity, geo distance.
+         * Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn\'t collect data when using `browse`. - Records are ranked by attributes and custom ranking. - There\'s no ranking for: typo-tolerance, number of matched words, proximity, geo distance.  Browse requests automatically apply these settings:  - `advancedSyntax`: `false` - `attributesToHighlight`: `[]` - `attributesToSnippet`: `[]` - `distinct`: `false` - `enablePersonalization`: `false` - `enableRules`: `false` - `facets`: `[]` - `getRankingInfo`: `false` - `ignorePlurals`: `false` - `optionalFilters`: `[]` - `typoTolerance`: `true` or `false` (`min` and `strict` is evaluated to `true`)  If you send these parameters with your browse requests, they\'ll be ignored.
          *
          * Required API Key ACLs:
          * - browse.
@@ -1735,6 +1817,31 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             };
             return transporter.request(request, requestOptions);
         },
+        /**
+         * Checks the status of a given application task.
+         *
+         * Required API Key ACLs:
+         * - editSettings.
+         *
+         * @param getAppTask - The getAppTask object.
+         * @param getAppTask.taskID - Unique task identifier.
+         * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
+         */
+        getAppTask({ taskID }, requestOptions) {
+            if (!taskID) {
+                throw new Error('Parameter `taskID` is required when calling `getAppTask`.');
+            }
+            const requestPath = '/1/task/{taskID}'.replace('{taskID}', encodeURIComponent(taskID));
+            const headers = {};
+            const queryParameters = {};
+            const request = {
+                method: 'GET',
+                path: requestPath,
+                queryParameters,
+                headers,
+            };
+            return transporter.request(request, requestOptions);
+        },
         /**
          * Lists supported languages with their supported dictionary types and number of custom entries.
          *
@@ -2209,7 +2316,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
             return transporter.request(request, requestOptions);
         },
         /**
-         * Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for index-specific API keys and analytics data. - If the destination index doesn\'t exist yet, it\'ll be created.  **Copy**  - Copying a source index that doesn\'t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can\'t copy the `enableReRanking`, `mode`, and `replicas` settings. - You can\'t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn\'t exist is ignored without returning an error. - When moving an index, the analytics data keep their original name and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
+         * Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn\'t exist yet, it\'ll be created.  **Copy**  - Copying a source index that doesn\'t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can\'t copy the `enableReRanking`, `mode`, and `replicas` settings. - You can\'t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn\'t exist is ignored without returning an error. - When moving an index, the analytics data keep their original name and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
          *
          * Required API Key ACLs:
          * - addObject.