algoliasearch 5.0.0-alpha.101 → 5.0.0-alpha.103

package/dist/algoliasearch/builds/browser.d.ts

@@ -4,7 +4,7 @@ import type { ClientOptions } from '@algolia/client-common';
 import type { Region as PersonalizationRegion, PersonalizationClient } from '@algolia/client-personalization/src/personalizationClient';
 import type { InitClientOptions, InitClientRegion } from './models';
 export * from './models';
-export declare const apiClientVersion = "5.0.0-alpha.101";
+export declare const apiClientVersion = "5.0.0-alpha.103";
 /**
  * The client type.
  */
@@ -29,6 +29,10 @@ export declare function algoliasearch(appId: string, apiKey: string, options?: C
     searchForFacets(searchMethodParams: import("@algolia/client-search/model/clientMethodProps").LegacySearchMethodProps | import("@algolia/client-search/model/searchMethodParams").SearchMethodParams, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<{
         results: import("@algolia/client-search/model/searchForFacetValuesResponse").SearchForFacetValuesResponse[];
     }>;
+    generateSecuredApiKey({ parentApiKey, restrictions, }: import("@algolia/client-search/model/clientMethodProps").GenerateSecuredApiKeyOptions): string;
+    getSecuredApiKeyRemainingValidity({ securedApiKey, }: import("@algolia/client-search/model/clientMethodProps").GetSecuredApiKeyRemainingValidityOptions): number;
+    chunkedBatch({ indexName, objects, action, waitForTasks, batchSize, }: import("@algolia/client-search/model/clientMethodProps").ChunkedBatchOptions, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/batchResponse").BatchResponse[]>;
+    replaceAllObjects({ indexName, objects, batchSize }: import("@algolia/client-search/model/clientMethodProps").ReplaceAllObjectsOptions, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/clientMethodProps").ReplaceAllObjectsResponse>;
     addApiKey(apiKey: import("@algolia/client-search/model/apiKey").ApiKey, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/addApiKeyResponse").AddApiKeyResponse>;
     addOrUpdateObject({ indexName, objectID, body }: import("@algolia/client-search/model/clientMethodProps").AddOrUpdateObjectProps, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/updatedAtWithObjectIdResponse").UpdatedAtWithObjectIdResponse>;
     appendSource(source: import("@algolia/client-search/model/source").Source, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/createdAtResponse").CreatedAtResponse>;

package/dist/algoliasearch/builds/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../builds/browser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAKvD,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAavD,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EACV,MAAM,IAAI,qBAAqB,EAC/B,qBAAqB,EACtB,MAAM,2DAA2D,CAAC;AAOnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEpE,cAAc,UAAU,CAAC;AAEzB,eAAO,MAAM,gBAAgB,oBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AAG7D,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,aAAa;;kCAiCR,iBAAiB,GAAG,iBAAiB,eAAe,CAAC,KACjE,eAAe;uCAuCH,iBAAiB,GAC5B,SAAS,iBAAiB,qBAAqB,CAAC,CAAC,KAClD,qBAAqB;kCAtBT,iBAAiB,GAAG,iBAAiB,eAAe,CAAC,KACjE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDnB"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../builds/browser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAKvD,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAavD,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EACV,MAAM,IAAI,qBAAqB,EAC/B,qBAAqB,EACtB,MAAM,2DAA2D,CAAC;AAOnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEpE,cAAc,UAAU,CAAC;AAEzB,eAAO,MAAM,gBAAgB,oBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AAG7D,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,aAAa;;kCAiCR,iBAAiB,GAAG,iBAAiB,eAAe,CAAC,KACjE,eAAe;uCAuCH,iBAAiB,GAC5B,SAAS,iBAAiB,qBAAqB,CAAC,CAAC,KAClD,qBAAqB;kCAtBT,iBAAiB,GAAG,iBAAiB,eAAe,CAAC,KACjE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDnB"}

package/dist/algoliasearch/builds/node.d.ts

@@ -4,7 +4,7 @@ import type { ClientOptions } from '@algolia/client-common';
 import type { Region as PersonalizationRegion, PersonalizationClient } from '@algolia/client-personalization/src/personalizationClient';
 import type { InitClientOptions, InitClientRegion } from './models';
 export * from './models';
-export declare const apiClientVersion = "5.0.0-alpha.101";
+export declare const apiClientVersion = "5.0.0-alpha.103";
 /**
  * The client type.
  */
@@ -29,6 +29,10 @@ export declare function algoliasearch(appId: string, apiKey: string, options?: C
     searchForFacets(searchMethodParams: import("@algolia/client-search/model/clientMethodProps").LegacySearchMethodProps | import("@algolia/client-search/model/searchMethodParams").SearchMethodParams, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<{
         results: import("@algolia/client-search/model/searchForFacetValuesResponse").SearchForFacetValuesResponse[];
     }>;
+    generateSecuredApiKey({ parentApiKey, restrictions, }: import("@algolia/client-search/model/clientMethodProps").GenerateSecuredApiKeyOptions): string;
+    getSecuredApiKeyRemainingValidity({ securedApiKey, }: import("@algolia/client-search/model/clientMethodProps").GetSecuredApiKeyRemainingValidityOptions): number;
+    chunkedBatch({ indexName, objects, action, waitForTasks, batchSize, }: import("@algolia/client-search/model/clientMethodProps").ChunkedBatchOptions, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/batchResponse").BatchResponse[]>;
+    replaceAllObjects({ indexName, objects, batchSize }: import("@algolia/client-search/model/clientMethodProps").ReplaceAllObjectsOptions, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/clientMethodProps").ReplaceAllObjectsResponse>;
     addApiKey(apiKey: import("@algolia/client-search/model/apiKey").ApiKey, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/addApiKeyResponse").AddApiKeyResponse>;
     addOrUpdateObject({ indexName, objectID, body }: import("@algolia/client-search/model/clientMethodProps").AddOrUpdateObjectProps, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/updatedAtWithObjectIdResponse").UpdatedAtWithObjectIdResponse>;
     appendSource(source: import("@algolia/client-search/model/source").Source, requestOptions?: import("@algolia/client-common").RequestOptions | undefined): Promise<import("@algolia/client-search/model/createdAtResponse").CreatedAtResponse>;

package/dist/algoliasearch/builds/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../builds/node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAKvD,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAYvD,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EACV,MAAM,IAAI,qBAAqB,EAC/B,qBAAqB,EACtB,MAAM,2DAA2D,CAAC;AAOnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEpE,cAAc,UAAU,CAAC;AAEzB,eAAO,MAAM,gBAAgB,oBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AAG7D,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,aAAa;;kCA2BR,iBAAiB,GAAG,iBAAiB,eAAe,CAAC,KACjE,eAAe;uCAuCH,iBAAiB,GAC5B,SAAS,iBAAiB,qBAAqB,CAAC,CAAC,KAClD,qBAAqB;kCAtBT,iBAAiB,GAAG,iBAAiB,eAAe,CAAC,KACjE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDnB"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../builds/node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAKvD,OAAO,KAAK,EACV,MAAM,IAAI,eAAe,EACzB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAYvD,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EACV,MAAM,IAAI,qBAAqB,EAC/B,qBAAqB,EACtB,MAAM,2DAA2D,CAAC;AAOnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEpE,cAAc,UAAU,CAAC;AAEzB,eAAO,MAAM,gBAAgB,oBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AAG7D,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,aAAa;;kCA2BR,iBAAiB,GAAG,iBAAiB,eAAe,CAAC,KACjE,eAAe;uCAuCH,iBAAiB,GAC5B,SAAS,iBAAiB,qBAAqB,CAAC,CAAC,KAClD,qBAAqB;kCAtBT,iBAAiB,GAAG,iBAAiB,eAAe,CAAC,KACjE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDnB"}

package/dist/algoliasearch.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
 var clientCommon = require('@algolia/client-common');
+var crypto = require('crypto');
 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$4 = '5.0.0-alpha.101';
+const apiClientVersion$4 = '5.0.0-alpha.103';
 const REGIONS$2 = ['de', 'us'];
 function getDefaultHosts$3(region) {
     const url = !region
@@ -309,7 +310,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
 }
 
 // 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$3 = '5.0.0-alpha.101';
+const apiClientVersion$3 = '5.0.0-alpha.103';
 const REGIONS$1 = ['de', 'us'];
 function getDefaultHosts$2(region) {
     const url = !region
@@ -1236,7 +1237,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
 }
 
 // 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$2 = '5.0.0-alpha.101';
+const apiClientVersion$2 = '5.0.0-alpha.103';
 const REGIONS = ['eu', 'us'];
 function getDefaultHosts$1(region) {
     const url = 'personalization.{region}.algolia.com'.replace('{region}', region);
@@ -1497,7 +1498,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
 }
 
 // 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$1 = '5.0.0-alpha.101';
+const apiClientVersion$1 = '5.0.0-alpha.103';
 function getDefaultHosts(appId) {
     return [
         {
@@ -1583,7 +1584,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Wait for a task to be published (completed) for a given `indexName` and `taskID`.
          *
          * @summary Helper method that waits for a task to be published (completed).
-         * @param waitForTaskOptions - The waitForTaskOptions object.
+         * @param waitForTaskOptions - The `waitForTaskOptions` object.
          * @param waitForTaskOptions.indexName - The `indexName` where the operation was performed.
          * @param waitForTaskOptions.taskID - The `taskID` returned in the method response.
          * @param waitForTaskOptions.maxRetries - The maximum number of retries. 50 by default.
@@ -1607,7 +1608,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Wait for an API key to be added, updated or deleted based on a given `operation`.
          *
          * @summary Helper method that waits for an API key task to be processed.
-         * @param waitForApiKeyOptions - The waitForApiKeyOptions object.
+         * @param waitForApiKeyOptions - The `waitForApiKeyOptions` object.
          * @param waitForApiKeyOptions.operation - The `operation` that was done on a `key`.
          * @param waitForApiKeyOptions.key - The `key` that has been added, deleted or updated.
          * @param waitForApiKeyOptions.apiKey - Necessary to know if an `update` operation has been processed, compare fields of the response with it.
@@ -1660,7 +1661,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `browse` method of the client to allow aggregating objects of an index.
          *
          * @summary Helper method that iterates on the `browse` method.
-         * @param browseObjects - The browseObjects object.
+         * @param browseObjects - The `browseObjects` object.
          * @param browseObjects.indexName - The index in which to perform the request.
          * @param browseObjects.browseParams - The `browse` parameters.
          * @param browseObjects.validate - The validator function. It receive the resolved return of the API call. By default, stops when there is no `cursor` in the response.
@@ -1686,11 +1687,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `searchRules` method of the client to allow aggregating rules of an index.
          *
          * @summary Helper method that iterates on the `searchRules` method.
-         * @param browseObjects - The browseObjects object.
-         * @param browseObjects.indexName - The index in which to perform the request.
-         * @param browseObjects.searchRulesParams - The `searchRules` method parameters.
-         * @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 browseRules - The `browseRules` object.
+         * @param browseRules.indexName - The index in which to perform the request.
+         * @param browseRules.searchRulesParams - The `searchRules` method parameters.
+         * @param browseRules.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 browseRules.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
          * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `searchRules` method and merged with the transporter requestOptions.
          */
         browseRules({ indexName, searchRulesParams, ...browseRulesOptions }, requestOptions) {
@@ -1718,11 +1719,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `searchSynonyms` method of the client to allow aggregating rules of an index.
          *
          * @summary Helper method that iterates on the `searchSynonyms` method.
-         * @param browseObjects - The browseObjects object.
-         * @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 browseSynonyms - The `browseSynonyms` object.
+         * @param browseSynonyms.indexName - The index in which to perform the request.
+         * @param browseSynonyms.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 browseSynonyms.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
+         * @param browseSynonyms.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, searchSynonymsParams, ...browseSynonymsOptions }, requestOptions) {
@@ -1732,16 +1733,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
                 hitsPerPage: 1000,
             };
             return clientCommon.createIterablePromise({
-                func: (previousResponse) => {
-                    return this.searchSynonyms({
+                func: (_) => {
+                    const resp = this.searchSynonyms({
                         indexName,
                         searchSynonymsParams: {
                             ...params,
-                            page: previousResponse
-                                ? previousResponse.page + 1
-                                : params.page,
+                            page: params.page,
                         },
                     }, requestOptions);
+                    params.page += 1;
+                    return resp;
                 },
                 validate: (response) => response.nbHits < params.hitsPerPage,
                 ...browseSynonymsOptions,
@@ -1769,6 +1770,101 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         searchForFacets(searchMethodParams, requestOptions) {
             return this.search(searchMethodParams, requestOptions);
         },
+        /**
+         * Helper: Generates a secured API key based on the given `parentApiKey` and given `restrictions`.
+         *
+         * @summary Helper: Generates a secured API key based on the given `parentApiKey` and given `restrictions`.
+         * @param generateSecuredApiKey - The `generateSecuredApiKey` object.
+         * @param generateSecuredApiKey.parentApiKey - The base API key from which to generate the new secured one.
+         * @param generateSecuredApiKey.restrictions - A set of properties defining the restrictions of the secured API key.
+         */
+        generateSecuredApiKey({ parentApiKey, restrictions = {}, }) {
+            const queryParameters = clientCommon.serializeQueryParameters(restrictions);
+            return Buffer.from(crypto.createHmac('sha256', parentApiKey)
+                .update(queryParameters)
+                .digest('hex') + queryParameters).toString('base64');
+        },
+        /**
+         * Helper: Retrieves the remaining validity of the previous generated `secured_api_key`, the `ValidUntil` parameter must have been provided.
+         *
+         * @summary Helper: Retrieves the remaining validity of the previous generated `secured_api_key`, the `ValidUntil` parameter must have been provided.
+         * @param getSecuredApiKeyRemainingValidity - The `getSecuredApiKeyRemainingValidity` object.
+         * @param getSecuredApiKeyRemainingValidity.securedApiKey - The secured API key generated with the `generateSecuredApiKey` method.
+         */
+        getSecuredApiKeyRemainingValidity({ securedApiKey, }) {
+            const decodedString = Buffer.from(securedApiKey, 'base64').toString('ascii');
+            const regex = /validUntil=(\d+)/;
+            const match = decodedString.match(regex);
+            if (match === null) {
+                throw new Error('ValidUntil not found in given secured api key.');
+            }
+            return parseInt(match[1], 10) - Math.round(new Date().getTime() / 1000);
+        },
+        /**
+         * Helper: Chunks the given `objects` list in subset of 1000 elements max in order to make it fit in `batch` requests.
+         *
+         * @summary Helper: Chunks the given `objects` list in subset of 1000 elements max in order to make it fit in `batch` requests. * @param getSecuredApiKeyRemainingValidity - The `getSecuredApiKeyRemainingValidity` object.
+         * @param chunkedBatch - The `chunkedBatch` object.
+         * @param chunkedBatch.indexName - The `indexName` to replace `objects` in.
+         * @param chunkedBatch.objects - The array of `objects` to store in the given Algolia `indexName`.
+         * @param chunkedBatch.action - The `batch` `action` to perform on the given array of `objects`, defaults to `addObject`.
+         * @param chunkedBatch.waitForTasks - Whether or not we should wait until every `batch` tasks has been processed, this operation may slow the total execution time of this method but is more reliable.
+         * @param chunkedBatch.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.
+         */
+        async chunkedBatch({ indexName, objects, action = 'addObject', waitForTasks, batchSize = 1000, }, requestOptions) {
+            let requests = [];
+            const responses = [];
+            for (const [i, obj] of objects.entries()) {
+                requests.push({ action, body: obj });
+                if (i % batchSize === 0) {
+                    responses.push(await this.batch({ indexName, batchWriteParams: { requests } }, requestOptions));
+                    requests = [];
+                }
+            }
+            if (waitForTasks) {
+                for (const resp of responses) {
+                    await this.waitForTask({ indexName, taskID: resp.taskID });
+                }
+            }
+            return responses;
+        },
+        /**
+         * 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.
+         *
+         * @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.
+         */
+        async replaceAllObjects({ indexName, objects, batchSize }, requestOptions) {
+            const randomSuffix = Math.random().toString(36).substring(7);
+            const tmpIndexName = `${indexName}_tmp_${randomSuffix}`;
+            const copyOperationResponse = await this.operationIndex({
+                indexName,
+                operationIndexParams: {
+                    operation: 'copy',
+                    destination: tmpIndexName,
+                    scope: ['settings', 'rules', 'synonyms'],
+                },
+            }, requestOptions);
+            await this.waitForTask({
+                indexName,
+                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,
+                taskID: moveOperationResponse.taskID,
+            });
+            return { copyOperationResponse, batchResponses, moveOperationResponse };
+        },
         /**
          * Add a new API key with specific permissions and restrictions. The request must be authenticated with the admin API key. The response returns an API key string.
          *

package/dist/algoliasearch.esm.browser.js

@@ -1,3 +1,5 @@
+import { createHmac } from 'crypto';
+
 function createAuth(appId, apiKey, authMode = 'WithinHeaders') {
   const credentials = {
     'x-algolia-api-key': apiKey,
@@ -321,7 +323,7 @@ function shuffle(array) {
 }
 function serializeUrl(host, path, queryParameters) {
   const queryParametersAsString = serializeQueryParameters(queryParameters);
-  let url = `${host.protocol}://${host.url}${host.port ? `:${host.port}` : ''}/${path.charAt(0) === '/' ? path.substr(1) : path}`;
+  let url = `${host.protocol}://${host.url}${host.port ? `:${host.port}` : ''}/${path.charAt(0) === '/' ? path.substring(1) : path}`;
   if (queryParametersAsString.length) {
     url += `?${queryParametersAsString}`;
   }
@@ -685,7 +687,7 @@ const DEFAULT_READ_TIMEOUT_BROWSER = 2000;
 const DEFAULT_WRITE_TIMEOUT_BROWSER = 30000;
 
 // 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$4 = '5.0.0-alpha.101';
+const apiClientVersion$4 = '5.0.0-alpha.103';
 const REGIONS$2 = ['de', 'us'];
 function getDefaultHosts$3(region) {
     const url = !region
@@ -990,7 +992,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
 }
 
 // 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$3 = '5.0.0-alpha.101';
+const apiClientVersion$3 = '5.0.0-alpha.103';
 const REGIONS$1 = ['de', 'us'];
 function getDefaultHosts$2(region) {
     const url = !region
@@ -1917,7 +1919,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
 }
 
 // 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$2 = '5.0.0-alpha.101';
+const apiClientVersion$2 = '5.0.0-alpha.103';
 const REGIONS = ['eu', 'us'];
 function getDefaultHosts$1(region) {
     const url = 'personalization.{region}.algolia.com'.replace('{region}', region);
@@ -2178,7 +2180,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
 }
 
 // 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$1 = '5.0.0-alpha.101';
+const apiClientVersion$1 = '5.0.0-alpha.103';
 function getDefaultHosts(appId) {
     return [
         {
@@ -2264,7 +2266,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Wait for a task to be published (completed) for a given `indexName` and `taskID`.
          *
          * @summary Helper method that waits for a task to be published (completed).
-         * @param waitForTaskOptions - The waitForTaskOptions object.
+         * @param waitForTaskOptions - The `waitForTaskOptions` object.
          * @param waitForTaskOptions.indexName - The `indexName` where the operation was performed.
          * @param waitForTaskOptions.taskID - The `taskID` returned in the method response.
          * @param waitForTaskOptions.maxRetries - The maximum number of retries. 50 by default.
@@ -2288,7 +2290,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Wait for an API key to be added, updated or deleted based on a given `operation`.
          *
          * @summary Helper method that waits for an API key task to be processed.
-         * @param waitForApiKeyOptions - The waitForApiKeyOptions object.
+         * @param waitForApiKeyOptions - The `waitForApiKeyOptions` object.
          * @param waitForApiKeyOptions.operation - The `operation` that was done on a `key`.
          * @param waitForApiKeyOptions.key - The `key` that has been added, deleted or updated.
          * @param waitForApiKeyOptions.apiKey - Necessary to know if an `update` operation has been processed, compare fields of the response with it.
@@ -2341,7 +2343,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `browse` method of the client to allow aggregating objects of an index.
          *
          * @summary Helper method that iterates on the `browse` method.
-         * @param browseObjects - The browseObjects object.
+         * @param browseObjects - The `browseObjects` object.
          * @param browseObjects.indexName - The index in which to perform the request.
          * @param browseObjects.browseParams - The `browse` parameters.
          * @param browseObjects.validate - The validator function. It receive the resolved return of the API call. By default, stops when there is no `cursor` in the response.
@@ -2367,11 +2369,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `searchRules` method of the client to allow aggregating rules of an index.
          *
          * @summary Helper method that iterates on the `searchRules` method.
-         * @param browseObjects - The browseObjects object.
-         * @param browseObjects.indexName - The index in which to perform the request.
-         * @param browseObjects.searchRulesParams - The `searchRules` method parameters.
-         * @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 browseRules - The `browseRules` object.
+         * @param browseRules.indexName - The index in which to perform the request.
+         * @param browseRules.searchRulesParams - The `searchRules` method parameters.
+         * @param browseRules.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 browseRules.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
          * @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `searchRules` method and merged with the transporter requestOptions.
          */
         browseRules({ indexName, searchRulesParams, ...browseRulesOptions }, requestOptions) {
@@ -2399,11 +2401,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
          * Helper: Iterate on the `searchSynonyms` method of the client to allow aggregating rules of an index.
          *
          * @summary Helper method that iterates on the `searchSynonyms` method.
-         * @param browseObjects - The browseObjects object.
-         * @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 browseSynonyms - The `browseSynonyms` object.
+         * @param browseSynonyms.indexName - The index in which to perform the request.
+         * @param browseSynonyms.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 browseSynonyms.aggregator - The function that runs right after the API call has been resolved, allows you to do anything with the response before `validate`.
+         * @param browseSynonyms.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, searchSynonymsParams, ...browseSynonymsOptions }, requestOptions) {
@@ -2413,16 +2415,16 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
                 hitsPerPage: 1000,
             };
             return createIterablePromise({
-                func: (previousResponse) => {
-                    return this.searchSynonyms({
+                func: (_) => {
+                    const resp = this.searchSynonyms({
                         indexName,
                         searchSynonymsParams: {
                             ...params,
-                            page: previousResponse
-                                ? previousResponse.page + 1
-                                : params.page,
+                            page: params.page,
                         },
                     }, requestOptions);
+                    params.page += 1;
+                    return resp;
                 },
                 validate: (response) => response.nbHits < params.hitsPerPage,
                 ...browseSynonymsOptions,
@@ -2450,6 +2452,101 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
         searchForFacets(searchMethodParams, requestOptions) {
             return this.search(searchMethodParams, requestOptions);
         },
+        /**
+         * Helper: Generates a secured API key based on the given `parentApiKey` and given `restrictions`.
+         *
+         * @summary Helper: Generates a secured API key based on the given `parentApiKey` and given `restrictions`.
+         * @param generateSecuredApiKey - The `generateSecuredApiKey` object.
+         * @param generateSecuredApiKey.parentApiKey - The base API key from which to generate the new secured one.
+         * @param generateSecuredApiKey.restrictions - A set of properties defining the restrictions of the secured API key.
+         */
+        generateSecuredApiKey({ parentApiKey, restrictions = {}, }) {
+            const queryParameters = serializeQueryParameters(restrictions);
+            return Buffer.from(createHmac('sha256', parentApiKey)
+                .update(queryParameters)
+                .digest('hex') + queryParameters).toString('base64');
+        },
+        /**
+         * Helper: Retrieves the remaining validity of the previous generated `secured_api_key`, the `ValidUntil` parameter must have been provided.
+         *
+         * @summary Helper: Retrieves the remaining validity of the previous generated `secured_api_key`, the `ValidUntil` parameter must have been provided.
+         * @param getSecuredApiKeyRemainingValidity - The `getSecuredApiKeyRemainingValidity` object.
+         * @param getSecuredApiKeyRemainingValidity.securedApiKey - The secured API key generated with the `generateSecuredApiKey` method.
+         */
+        getSecuredApiKeyRemainingValidity({ securedApiKey, }) {
+            const decodedString = Buffer.from(securedApiKey, 'base64').toString('ascii');
+            const regex = /validUntil=(\d+)/;
+            const match = decodedString.match(regex);
+            if (match === null) {
+                throw new Error('ValidUntil not found in given secured api key.');
+            }
+            return parseInt(match[1], 10) - Math.round(new Date().getTime() / 1000);
+        },
+        /**
+         * Helper: Chunks the given `objects` list in subset of 1000 elements max in order to make it fit in `batch` requests.
+         *
+         * @summary Helper: Chunks the given `objects` list in subset of 1000 elements max in order to make it fit in `batch` requests. * @param getSecuredApiKeyRemainingValidity - The `getSecuredApiKeyRemainingValidity` object.
+         * @param chunkedBatch - The `chunkedBatch` object.
+         * @param chunkedBatch.indexName - The `indexName` to replace `objects` in.
+         * @param chunkedBatch.objects - The array of `objects` to store in the given Algolia `indexName`.
+         * @param chunkedBatch.action - The `batch` `action` to perform on the given array of `objects`, defaults to `addObject`.
+         * @param chunkedBatch.waitForTasks - Whether or not we should wait until every `batch` tasks has been processed, this operation may slow the total execution time of this method but is more reliable.
+         * @param chunkedBatch.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.
+         */
+        async chunkedBatch({ indexName, objects, action = 'addObject', waitForTasks, batchSize = 1000, }, requestOptions) {
+            let requests = [];
+            const responses = [];
+            for (const [i, obj] of objects.entries()) {
+                requests.push({ action, body: obj });
+                if (i % batchSize === 0) {
+                    responses.push(await this.batch({ indexName, batchWriteParams: { requests } }, requestOptions));
+                    requests = [];
+                }
+            }
+            if (waitForTasks) {
+                for (const resp of responses) {
+                    await this.waitForTask({ indexName, taskID: resp.taskID });
+                }
+            }
+            return responses;
+        },
+        /**
+         * 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.
+         *
+         * @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.
+         */
+        async replaceAllObjects({ indexName, objects, batchSize }, requestOptions) {
+            const randomSuffix = Math.random().toString(36).substring(7);
+            const tmpIndexName = `${indexName}_tmp_${randomSuffix}`;
+            const copyOperationResponse = await this.operationIndex({
+                indexName,
+                operationIndexParams: {
+                    operation: 'copy',
+                    destination: tmpIndexName,
+                    scope: ['settings', 'rules', 'synonyms'],
+                },
+            }, requestOptions);
+            await this.waitForTask({
+                indexName,
+                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,
+                taskID: moveOperationResponse.taskID,
+            });
+            return { copyOperationResponse, batchResponses, moveOperationResponse };
+        },
         /**
          * Add a new API key with specific permissions and restrictions. The request must be authenticated with the admin API key. The response returns an API key string.
          *