algoliasearch 5.0.0-alpha.72 → 5.0.0-alpha.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (328) hide show
  1. package/dist/algoliasearch.cjs.js +342 -340
  2. package/dist/algoliasearch.esm.browser.js +342 -338
  3. package/dist/algoliasearch.esm.node.js +342 -338
  4. package/dist/algoliasearch.umd.js +2 -2
  5. package/dist/builds/browser.d.ts +2 -2
  6. package/dist/builds/node.d.ts +2 -2
  7. package/dist/client-abtesting/model/aBTest.d.ts +8 -12
  8. package/dist/client-abtesting/model/aBTest.d.ts.map +1 -1
  9. package/dist/client-abtesting/model/aBTestResponse.d.ts +3 -3
  10. package/dist/client-abtesting/model/abTestsVariant.d.ts +3 -3
  11. package/dist/client-abtesting/model/addABTestsRequest.d.ts +3 -3
  12. package/dist/client-abtesting/model/addABTestsRequest.d.ts.map +1 -1
  13. package/dist/client-abtesting/model/clientMethodProps.d.ts +16 -16
  14. package/dist/client-abtesting/model/customSearchParams.d.ts +3 -0
  15. package/dist/client-abtesting/model/customSearchParams.d.ts.map +1 -1
  16. package/dist/client-abtesting/model/listABTestsResponse.d.ts +3 -3
  17. package/dist/client-abtesting/model/variant.d.ts +20 -12
  18. package/dist/client-abtesting/model/variant.d.ts.map +1 -1
  19. package/dist/client-abtesting/src/abtestingClient.d.ts +27 -27
  20. package/dist/client-analytics/model/averageClickEvent.d.ts +3 -3
  21. package/dist/client-analytics/model/clickPosition.d.ts +2 -2
  22. package/dist/client-analytics/model/clickThroughRateEvent.d.ts +4 -4
  23. package/dist/client-analytics/model/clientMethodProps.d.ts +91 -91
  24. package/dist/client-analytics/model/conversionRateEvent.d.ts +4 -4
  25. package/dist/client-analytics/model/getAverageClickPositionResponse.d.ts +3 -3
  26. package/dist/client-analytics/model/getClickPositionsResponse.d.ts +1 -1
  27. package/dist/client-analytics/model/getClickThroughRateResponse.d.ts +4 -4
  28. package/dist/client-analytics/model/getConversationRateResponse.d.ts +4 -4
  29. package/dist/client-analytics/model/getNoClickRateResponse.d.ts +4 -4
  30. package/dist/client-analytics/model/getNoResultsRateResponse.d.ts +4 -4
  31. package/dist/client-analytics/model/getSearchesCountResponse.d.ts +2 -2
  32. package/dist/client-analytics/model/getSearchesNoClicksResponse.d.ts +1 -1
  33. package/dist/client-analytics/model/getSearchesNoResultsResponse.d.ts +1 -1
  34. package/dist/client-analytics/model/getStatusResponse.d.ts +1 -1
  35. package/dist/client-analytics/model/getTopCountriesResponse.d.ts +1 -1
  36. package/dist/client-analytics/model/getTopFilterAttribute.d.ts +2 -2
  37. package/dist/client-analytics/model/getTopFilterAttributesResponse.d.ts +1 -1
  38. package/dist/client-analytics/model/getTopFilterForAttribute.d.ts +4 -4
  39. package/dist/client-analytics/model/getTopFilterForAttributeResponse.d.ts +1 -1
  40. package/dist/client-analytics/model/getTopFiltersNoResultsResponse.d.ts +1 -1
  41. package/dist/client-analytics/model/getTopFiltersNoResultsValue.d.ts +3 -3
  42. package/dist/client-analytics/model/getTopFiltersNoResultsValues.d.ts +2 -2
  43. package/dist/client-analytics/model/getUsersCountResponse.d.ts +2 -2
  44. package/dist/client-analytics/model/noClickRateEvent.d.ts +4 -4
  45. package/dist/client-analytics/model/noResultsRateEvent.d.ts +4 -4
  46. package/dist/client-analytics/model/orderBy.d.ts +3 -0
  47. package/dist/client-analytics/model/orderBy.d.ts.map +1 -1
  48. package/dist/client-analytics/model/searchEvent.d.ts +2 -2
  49. package/dist/client-analytics/model/searchNoClickEvent.d.ts +3 -3
  50. package/dist/client-analytics/model/searchNoResultEvent.d.ts +3 -3
  51. package/dist/client-analytics/model/topCountry.d.ts +2 -2
  52. package/dist/client-analytics/model/topHit.d.ts +2 -2
  53. package/dist/client-analytics/model/topHitWithAnalytics.d.ts +7 -7
  54. package/dist/client-analytics/model/topHitsResponse.d.ts +1 -1
  55. package/dist/client-analytics/model/topHitsResponseWithAnalytics.d.ts +1 -1
  56. package/dist/client-analytics/model/topSearch.d.ts +3 -3
  57. package/dist/client-analytics/model/topSearchWithAnalytics.d.ts +9 -9
  58. package/dist/client-analytics/model/topSearchesResponse.d.ts +1 -1
  59. package/dist/client-analytics/model/topSearchesResponseWithAnalytics.d.ts +1 -1
  60. package/dist/client-analytics/model/userWithDate.d.ts +2 -2
  61. package/dist/client-analytics/src/analyticsClient.d.ts +114 -114
  62. package/dist/client-personalization/model/clientMethodProps.d.ts +10 -10
  63. package/dist/client-personalization/src/personalizationClient.d.ts +11 -11
  64. package/dist/client-search/model/acl.d.ts +1 -1
  65. package/dist/client-search/model/action.d.ts +1 -1
  66. package/dist/client-search/model/addApiKeyResponse.d.ts +2 -2
  67. package/dist/client-search/model/anchoring.d.ts +1 -1
  68. package/dist/client-search/model/apiKey.d.ts +9 -9
  69. package/dist/client-search/model/aroundRadius.d.ts +1 -1
  70. package/dist/client-search/model/assignUserIdParams.d.ts +1 -1
  71. package/dist/client-search/model/baseGetApiKeyResponse.d.ts +2 -2
  72. package/dist/client-search/model/baseIndexSettings.d.ts +14 -14
  73. package/dist/client-search/model/baseSearchParamsWithoutQuery.d.ts +25 -25
  74. package/dist/client-search/model/baseSearchResponse.d.ts +20 -20
  75. package/dist/client-search/model/baseSearchResponseRedirect.d.ts +1 -1
  76. package/dist/client-search/model/batchAssignUserIdsParams.d.ts +2 -2
  77. package/dist/client-search/model/batchDictionaryEntriesParams.d.ts +3 -3
  78. package/dist/client-search/model/batchParams.d.ts +1 -1
  79. package/dist/client-search/model/batchRequest.d.ts +1 -1
  80. package/dist/client-search/model/batchResponse.d.ts +2 -2
  81. package/dist/client-search/model/batchWriteParams.d.ts +1 -1
  82. package/dist/client-search/model/builtInOperation.d.ts +1 -1
  83. package/dist/client-search/model/builtInOperationType.d.ts +1 -1
  84. package/dist/client-search/model/clientMethodProps.d.ts +88 -84
  85. package/dist/client-search/model/clientMethodProps.d.ts.map +1 -1
  86. package/dist/client-search/model/consequence.d.ts +4 -4
  87. package/dist/client-search/model/consequenceHide.d.ts +2 -2
  88. package/dist/client-search/model/createdAtResponse.d.ts +2 -2
  89. package/dist/client-search/model/cursor.d.ts +1 -1
  90. package/dist/client-search/model/deleteApiKeyResponse.d.ts +1 -1
  91. package/dist/client-search/model/deleteByParams.d.ts +4 -4
  92. package/dist/client-search/model/deleteSourceResponse.d.ts +1 -1
  93. package/dist/client-search/model/deletedAtResponse.d.ts +3 -3
  94. package/dist/client-search/model/dictionaryEntry.d.ts +6 -6
  95. package/dist/client-search/model/dictionaryEntryState.d.ts +1 -1
  96. package/dist/client-search/model/dictionaryLanguage.d.ts +2 -2
  97. package/dist/client-search/model/dictionarySettingsParams.d.ts +1 -1
  98. package/dist/client-search/model/distinct.d.ts +1 -1
  99. package/dist/client-search/model/exactOnSingleWordQuery.d.ts +1 -1
  100. package/dist/client-search/model/facetFilters.d.ts +1 -1
  101. package/dist/client-search/model/facetHits.d.ts +3 -3
  102. package/dist/client-search/model/facetOrdering.d.ts +2 -2
  103. package/dist/client-search/model/facets.d.ts +1 -1
  104. package/dist/client-search/model/facetsStats.d.ts +4 -4
  105. package/dist/client-search/model/fetchedIndex.d.ts +1 -1
  106. package/dist/client-search/model/getObjectsParams.d.ts +1 -1
  107. package/dist/client-search/model/getObjectsRequest.d.ts +4 -4
  108. package/dist/client-search/model/getObjectsResponse.d.ts +1 -1
  109. package/dist/client-search/model/getTopUserIdsResponse.d.ts +2 -2
  110. package/dist/client-search/model/hasPendingMappingsResponse.d.ts +2 -2
  111. package/dist/client-search/model/highlightResultOption.d.ts +1 -1
  112. package/dist/client-search/model/hit.d.ts +1 -1
  113. package/dist/client-search/model/ignorePlurals.d.ts +1 -1
  114. package/dist/client-search/model/indexSettings.d.ts +1 -1
  115. package/dist/client-search/model/indexSettingsAsSearchParams.d.ts +30 -30
  116. package/dist/client-search/model/indexSettingsAsSearchParamsSemanticSearch.d.ts +2 -2
  117. package/dist/client-search/model/languages.d.ts +1 -1
  118. package/dist/client-search/model/listApiKeysResponse.d.ts +1 -1
  119. package/dist/client-search/model/listClustersResponse.d.ts +2 -2
  120. package/dist/client-search/model/listIndicesResponse.d.ts +1 -1
  121. package/dist/client-search/model/listUserIdsResponse.d.ts +2 -2
  122. package/dist/client-search/model/log.d.ts +7 -7
  123. package/dist/client-search/model/logQuery.d.ts +1 -1
  124. package/dist/client-search/model/mode.d.ts +1 -1
  125. package/dist/client-search/model/multipleBatchRequest.d.ts +1 -1
  126. package/dist/client-search/model/multipleBatchResponse.d.ts +2 -2
  127. package/dist/client-search/model/numericFilters.d.ts +1 -1
  128. package/dist/client-search/model/operationIndexParams.d.ts +2 -2
  129. package/dist/client-search/model/operationType.d.ts +1 -1
  130. package/dist/client-search/model/optionalFilters.d.ts +1 -1
  131. package/dist/client-search/model/params.d.ts +1 -1
  132. package/dist/client-search/model/promoteObjectID.d.ts +3 -3
  133. package/dist/client-search/model/promoteObjectIDs.d.ts +3 -3
  134. package/dist/client-search/model/queryType.d.ts +1 -1
  135. package/dist/client-search/model/reRankingApplyFilter.d.ts +1 -1
  136. package/dist/client-search/model/redirectRuleIndexMetadata.d.ts +1 -1
  137. package/dist/client-search/model/redirectRuleIndexMetadataData.d.ts +1 -1
  138. package/dist/client-search/model/removeStopWords.d.ts +1 -1
  139. package/dist/client-search/model/removeUserIdResponse.d.ts +1 -1
  140. package/dist/client-search/model/removeWordsIfNoResults.d.ts +1 -1
  141. package/dist/client-search/model/renderingContent.d.ts +1 -1
  142. package/dist/client-search/model/replaceSourceResponse.d.ts +1 -1
  143. package/dist/client-search/model/rule.d.ts +5 -5
  144. package/dist/client-search/model/saveObjectResponse.d.ts +5 -2
  145. package/dist/client-search/model/saveObjectResponse.d.ts.map +1 -1
  146. package/dist/client-search/model/saveSynonymResponse.d.ts +3 -3
  147. package/dist/client-search/model/searchDictionaryEntriesParams.d.ts +5 -5
  148. package/dist/client-search/model/searchForFacetValuesRequest.d.ts +2 -2
  149. package/dist/client-search/model/searchForFacetsOptions.d.ts +3 -3
  150. package/dist/client-search/model/searchForHitsOptions.d.ts +1 -1
  151. package/dist/client-search/model/searchParamsQuery.d.ts +1 -1
  152. package/dist/client-search/model/searchParamsString.d.ts +1 -1
  153. package/dist/client-search/model/searchRulesParams.d.ts +7 -7
  154. package/dist/client-search/model/searchStrategy.d.ts +3 -0
  155. package/dist/client-search/model/searchStrategy.d.ts.map +1 -1
  156. package/dist/client-search/model/searchSynonymsParams.d.ts +1 -1
  157. package/dist/client-search/model/searchSynonymsResponse.d.ts +2 -2
  158. package/dist/client-search/model/searchTypeDefault.d.ts +1 -1
  159. package/dist/client-search/model/searchTypeFacet.d.ts +1 -1
  160. package/dist/client-search/model/searchUserIdsParams.d.ts +4 -4
  161. package/dist/client-search/model/searchUserIdsResponse.d.ts +5 -5
  162. package/dist/client-search/model/snippetResultOption.d.ts +1 -1
  163. package/dist/client-search/model/sortRemainingBy.d.ts +1 -1
  164. package/dist/client-search/model/source.d.ts +3 -3
  165. package/dist/client-search/model/standardEntries.d.ts +4 -4
  166. package/dist/client-search/model/synonymHit.d.ts +6 -6
  167. package/dist/client-search/model/synonymType.d.ts +1 -1
  168. package/dist/client-search/model/tagFilters.d.ts +1 -1
  169. package/dist/client-search/model/taskStatus.d.ts +3 -0
  170. package/dist/client-search/model/taskStatus.d.ts.map +1 -1
  171. package/dist/client-search/model/typoTolerance.d.ts +1 -1
  172. package/dist/client-search/model/updateApiKeyResponse.d.ts +2 -2
  173. package/dist/client-search/model/updatedAtResponse.d.ts +3 -3
  174. package/dist/client-search/model/updatedAtWithObjectIdResponse.d.ts +4 -4
  175. package/dist/client-search/model/updatedRuleResponse.d.ts +3 -3
  176. package/dist/client-search/model/userHit.d.ts +1 -1
  177. package/dist/client-search/model/userId.d.ts +2 -2
  178. package/dist/client-search/src/searchClient.d.ts +185 -184
  179. package/dist/client-search/src/searchClient.d.ts.map +1 -1
  180. package/dist/lite/lite.cjs.js +6 -8
  181. package/dist/lite/lite.esm.browser.js +6 -6
  182. package/dist/lite/lite.esm.node.js +6 -6
  183. package/dist/lite/lite.umd.js +2 -2
  184. package/dist/lite/model/acl.d.ts +1 -1
  185. package/dist/lite/model/action.d.ts +1 -1
  186. package/dist/lite/model/addApiKeyResponse.d.ts +2 -2
  187. package/dist/lite/model/anchoring.d.ts +1 -1
  188. package/dist/lite/model/apiKey.d.ts +9 -9
  189. package/dist/lite/model/aroundRadius.d.ts +1 -1
  190. package/dist/lite/model/baseGetApiKeyResponse.d.ts +2 -2
  191. package/dist/lite/model/baseIndexSettings.d.ts +14 -14
  192. package/dist/lite/model/baseSearchParamsWithoutQuery.d.ts +25 -25
  193. package/dist/lite/model/baseSearchResponse.d.ts +20 -20
  194. package/dist/lite/model/baseSearchResponseRedirect.d.ts +1 -1
  195. package/dist/lite/model/builtInOperation.d.ts +1 -1
  196. package/dist/lite/model/builtInOperationType.d.ts +1 -1
  197. package/dist/lite/model/clientMethodProps.d.ts +3 -3
  198. package/dist/lite/model/consequence.d.ts +4 -4
  199. package/dist/lite/model/consequenceHide.d.ts +2 -2
  200. package/dist/lite/model/cursor.d.ts +1 -1
  201. package/dist/lite/model/deleteByParams.d.ts +4 -4
  202. package/dist/lite/model/dictionaryEntry.d.ts +6 -6
  203. package/dist/lite/model/dictionaryEntryState.d.ts +1 -1
  204. package/dist/lite/model/dictionaryLanguage.d.ts +2 -2
  205. package/dist/lite/model/distinct.d.ts +1 -1
  206. package/dist/lite/model/exactOnSingleWordQuery.d.ts +1 -1
  207. package/dist/lite/model/facetFilters.d.ts +1 -1
  208. package/dist/lite/model/facetOrdering.d.ts +2 -2
  209. package/dist/lite/model/facets.d.ts +1 -1
  210. package/dist/lite/model/facetsStats.d.ts +4 -4
  211. package/dist/lite/model/fetchedIndex.d.ts +1 -1
  212. package/dist/lite/model/highlightResultOption.d.ts +1 -1
  213. package/dist/lite/model/hit.d.ts +1 -1
  214. package/dist/lite/model/ignorePlurals.d.ts +1 -1
  215. package/dist/lite/model/indexSettings.d.ts +1 -1
  216. package/dist/lite/model/indexSettingsAsSearchParams.d.ts +30 -30
  217. package/dist/lite/model/indexSettingsAsSearchParamsSemanticSearch.d.ts +2 -2
  218. package/dist/lite/model/languages.d.ts +1 -1
  219. package/dist/lite/model/listIndicesResponse.d.ts +1 -1
  220. package/dist/lite/model/mode.d.ts +1 -1
  221. package/dist/lite/model/numericFilters.d.ts +1 -1
  222. package/dist/lite/model/operationType.d.ts +1 -1
  223. package/dist/lite/model/optionalFilters.d.ts +1 -1
  224. package/dist/lite/model/params.d.ts +1 -1
  225. package/dist/lite/model/promoteObjectID.d.ts +3 -3
  226. package/dist/lite/model/promoteObjectIDs.d.ts +3 -3
  227. package/dist/lite/model/queryType.d.ts +1 -1
  228. package/dist/lite/model/reRankingApplyFilter.d.ts +1 -1
  229. package/dist/lite/model/redirectRuleIndexMetadata.d.ts +1 -1
  230. package/dist/lite/model/redirectRuleIndexMetadataData.d.ts +1 -1
  231. package/dist/lite/model/removeStopWords.d.ts +1 -1
  232. package/dist/lite/model/removeWordsIfNoResults.d.ts +1 -1
  233. package/dist/lite/model/renderingContent.d.ts +1 -1
  234. package/dist/lite/model/rule.d.ts +5 -5
  235. package/dist/lite/model/searchForFacetsOptions.d.ts +3 -3
  236. package/dist/lite/model/searchForHitsOptions.d.ts +1 -1
  237. package/dist/lite/model/searchParamsQuery.d.ts +1 -1
  238. package/dist/lite/model/searchParamsString.d.ts +1 -1
  239. package/dist/lite/model/searchStrategy.d.ts +3 -0
  240. package/dist/lite/model/searchStrategy.d.ts.map +1 -1
  241. package/dist/lite/model/searchSynonymsResponse.d.ts +2 -2
  242. package/dist/lite/model/searchTypeDefault.d.ts +1 -1
  243. package/dist/lite/model/searchTypeFacet.d.ts +1 -1
  244. package/dist/lite/model/snippetResultOption.d.ts +1 -1
  245. package/dist/lite/model/sortRemainingBy.d.ts +1 -1
  246. package/dist/lite/model/source.d.ts +3 -3
  247. package/dist/lite/model/standardEntries.d.ts +4 -4
  248. package/dist/lite/model/synonymHit.d.ts +6 -6
  249. package/dist/lite/model/synonymType.d.ts +1 -1
  250. package/dist/lite/model/tagFilters.d.ts +1 -1
  251. package/dist/lite/model/taskStatus.d.ts +3 -0
  252. package/dist/lite/model/taskStatus.d.ts.map +1 -1
  253. package/dist/lite/model/typoTolerance.d.ts +1 -1
  254. package/dist/lite/model/updatedRuleResponse.d.ts +3 -3
  255. package/dist/lite/model/userId.d.ts +2 -2
  256. package/dist/lite/src/liteClient.d.ts +6 -6
  257. package/lite/model/acl.ts +1 -1
  258. package/lite/model/action.ts +1 -1
  259. package/lite/model/addApiKeyResponse.ts +2 -2
  260. package/lite/model/anchoring.ts +1 -1
  261. package/lite/model/apiKey.ts +9 -9
  262. package/lite/model/aroundRadius.ts +1 -1
  263. package/lite/model/baseGetApiKeyResponse.ts +2 -2
  264. package/lite/model/baseIndexSettings.ts +14 -14
  265. package/lite/model/baseSearchParamsWithoutQuery.ts +25 -25
  266. package/lite/model/baseSearchResponse.ts +20 -20
  267. package/lite/model/baseSearchResponseRedirect.ts +1 -1
  268. package/lite/model/builtInOperation.ts +1 -1
  269. package/lite/model/builtInOperationType.ts +1 -1
  270. package/lite/model/clientMethodProps.ts +3 -3
  271. package/lite/model/consequence.ts +4 -4
  272. package/lite/model/consequenceHide.ts +2 -2
  273. package/lite/model/cursor.ts +1 -1
  274. package/lite/model/deleteByParams.ts +4 -4
  275. package/lite/model/dictionaryEntry.ts +6 -6
  276. package/lite/model/dictionaryEntryState.ts +1 -1
  277. package/lite/model/dictionaryLanguage.ts +2 -2
  278. package/lite/model/distinct.ts +1 -1
  279. package/lite/model/exactOnSingleWordQuery.ts +1 -1
  280. package/lite/model/facetFilters.ts +1 -1
  281. package/lite/model/facetOrdering.ts +2 -2
  282. package/lite/model/facets.ts +1 -1
  283. package/lite/model/facetsStats.ts +4 -4
  284. package/lite/model/fetchedIndex.ts +1 -1
  285. package/lite/model/highlightResultOption.ts +1 -1
  286. package/lite/model/hit.ts +1 -1
  287. package/lite/model/ignorePlurals.ts +1 -1
  288. package/lite/model/indexSettings.ts +1 -1
  289. package/lite/model/indexSettingsAsSearchParams.ts +30 -30
  290. package/lite/model/indexSettingsAsSearchParamsSemanticSearch.ts +2 -2
  291. package/lite/model/languages.ts +1 -1
  292. package/lite/model/listIndicesResponse.ts +1 -1
  293. package/lite/model/mode.ts +1 -1
  294. package/lite/model/numericFilters.ts +1 -1
  295. package/lite/model/operationType.ts +1 -1
  296. package/lite/model/optionalFilters.ts +1 -1
  297. package/lite/model/params.ts +1 -1
  298. package/lite/model/promoteObjectID.ts +3 -3
  299. package/lite/model/promoteObjectIDs.ts +3 -3
  300. package/lite/model/queryType.ts +1 -1
  301. package/lite/model/reRankingApplyFilter.ts +1 -1
  302. package/lite/model/redirectRuleIndexMetadata.ts +1 -1
  303. package/lite/model/redirectRuleIndexMetadataData.ts +1 -1
  304. package/lite/model/removeStopWords.ts +1 -1
  305. package/lite/model/removeWordsIfNoResults.ts +1 -1
  306. package/lite/model/renderingContent.ts +1 -1
  307. package/lite/model/rule.ts +5 -5
  308. package/lite/model/searchForFacetsOptions.ts +3 -3
  309. package/lite/model/searchForHitsOptions.ts +1 -1
  310. package/lite/model/searchParamsQuery.ts +1 -1
  311. package/lite/model/searchParamsString.ts +1 -1
  312. package/lite/model/searchStrategy.ts +3 -0
  313. package/lite/model/searchSynonymsResponse.ts +2 -2
  314. package/lite/model/searchTypeDefault.ts +1 -1
  315. package/lite/model/searchTypeFacet.ts +1 -1
  316. package/lite/model/snippetResultOption.ts +1 -1
  317. package/lite/model/sortRemainingBy.ts +1 -1
  318. package/lite/model/source.ts +3 -3
  319. package/lite/model/standardEntries.ts +4 -4
  320. package/lite/model/synonymHit.ts +6 -6
  321. package/lite/model/synonymType.ts +1 -1
  322. package/lite/model/tagFilters.ts +1 -1
  323. package/lite/model/taskStatus.ts +3 -0
  324. package/lite/model/typoTolerance.ts +1 -1
  325. package/lite/model/updatedRuleResponse.ts +3 -3
  326. package/lite/model/userId.ts +2 -2
  327. package/lite/src/liteClient.ts +6 -6
  328. package/package.json +15 -14
@@ -2,7 +2,7 @@ import { createAuth, createTransporter, getAlgoliaAgent, createIterablePromise,
2
2
  import { createHttpRequester } from '@algolia/requester-node-http';
3
3
 
4
4
  // 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.
5
- const apiClientVersion$4 = '5.0.0-alpha.72';
5
+ const apiClientVersion$4 = '5.0.0-alpha.75';
6
6
  const REGIONS$2 = ['de', 'us'];
7
7
  function getDefaultHosts$3(region) {
8
8
  const url = !region
@@ -62,9 +62,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
62
62
  transporter.algoliaAgent.add({ segment, version });
63
63
  },
64
64
  /**
65
- * Creates a new A/B test with provided configuration. You can set an A/B test on two different indices with different settings, or on the same index with different search parameters by providing a customSearchParameters setting on one of the variants.
65
+ * Creates an A/B test.
66
66
  *
67
- * @summary Create a test.
67
+ * @summary Create an A/B test.
68
68
  * @param addABTestsRequest - The addABTestsRequest object.
69
69
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
70
70
  */
@@ -75,8 +75,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
75
75
  if (!addABTestsRequest.name) {
76
76
  throw new Error('Parameter `addABTestsRequest.name` is required when calling `addABTests`.');
77
77
  }
78
- if (!addABTestsRequest.variant) {
79
- throw new Error('Parameter `addABTestsRequest.variant` is required when calling `addABTests`.');
78
+ if (!addABTestsRequest.variants) {
79
+ throw new Error('Parameter `addABTestsRequest.variants` is required when calling `addABTests`.');
80
80
  }
81
81
  if (!addABTestsRequest.endAt) {
82
82
  throw new Error('Parameter `addABTestsRequest.endAt` is required when calling `addABTests`.');
@@ -98,8 +98,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
98
98
  *
99
99
  * @summary Send requests to the Algolia REST API.
100
100
  * @param del - The del object.
101
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
102
- * @param del.parameters - Query parameters to be applied to the current query.
101
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
102
+ * @param del.parameters - Query parameters to apply to the current query.
103
103
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
104
104
  */
105
105
  del({ path, parameters }, requestOptions) {
@@ -118,11 +118,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
118
118
  return transporter.request(request, requestOptions);
119
119
  },
120
120
  /**
121
- * Delete a test.
121
+ * Delete an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
122
122
  *
123
- * @summary Delete a test.
123
+ * @summary Delete an A/B test.
124
124
  * @param deleteABTest - The deleteABTest object.
125
- * @param deleteABTest.id - The A/B test ID.
125
+ * @param deleteABTest.id - Unique A/B test ID.
126
126
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
127
127
  */
128
128
  deleteABTest({ id }, requestOptions) {
@@ -145,8 +145,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
145
145
  *
146
146
  * @summary Send requests to the Algolia REST API.
147
147
  * @param get - The get object.
148
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
149
- * @param get.parameters - Query parameters to be applied to the current query.
148
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
149
+ * @param get.parameters - Query parameters to apply to the current query.
150
150
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
151
151
  */
152
152
  get({ path, parameters }, requestOptions) {
@@ -165,11 +165,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
165
165
  return transporter.request(request, requestOptions);
166
166
  },
167
167
  /**
168
- * Returns metadata and metrics for an A/B test.
168
+ * Get specific details for an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
169
169
  *
170
- * @summary Get a test.
170
+ * @summary Get A/B test details.
171
171
  * @param getABTest - The getABTest object.
172
- * @param getABTest.id - The A/B test ID.
172
+ * @param getABTest.id - Unique A/B test ID.
173
173
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
174
174
  */
175
175
  getABTest({ id }, requestOptions) {
@@ -188,14 +188,14 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
188
188
  return transporter.request(request, requestOptions);
189
189
  },
190
190
  /**
191
- * Fetch all existing A/B tests for App that are available for the current API Key. When no data has been processed, the metrics will be returned as null.
191
+ * List all A/B tests.
192
192
  *
193
- * @summary List all tests.
193
+ * @summary List all A/B tests.
194
194
  * @param listABTests - The listABTests object.
195
195
  * @param listABTests.offset - Position of the starting record. Used for paging. 0 is the first record.
196
- * @param listABTests.limit - Number of records to return. Limit is the size of the page.
197
- * @param listABTests.indexPrefix - Filters the returned ab tests by any indices starting with the provided prefix that are assigned to either variant of an ab test.
198
- * @param listABTests.indexSuffix - Filters the returned ab tests by any indices ending with the provided suffix that are assigned to either variant of an ab test.
196
+ * @param listABTests.limit - Number of records to return (page size).
197
+ * @param listABTests.indexPrefix - Only return A/B tests for indices starting with this prefix.
198
+ * @param listABTests.indexSuffix - Only return A/B tests for indices ending with this suffix.
199
199
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
200
200
  */
201
201
  listABTests({ offset, limit, indexPrefix, indexSuffix } = {}, requestOptions = undefined) {
@@ -227,9 +227,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
227
227
  *
228
228
  * @summary Send requests to the Algolia REST API.
229
229
  * @param post - The post object.
230
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
231
- * @param post.parameters - Query parameters to be applied to the current query.
232
- * @param post.body - The parameters to send with the custom request.
230
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
231
+ * @param post.parameters - Query parameters to apply to the current query.
232
+ * @param post.body - Parameters to send with the custom request.
233
233
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
234
234
  */
235
235
  post({ path, parameters, body }, requestOptions) {
@@ -253,9 +253,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
253
253
  *
254
254
  * @summary Send requests to the Algolia REST API.
255
255
  * @param put - The put object.
256
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
257
- * @param put.parameters - Query parameters to be applied to the current query.
258
- * @param put.body - The parameters to send with the custom request.
256
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
257
+ * @param put.parameters - Query parameters to apply to the current query.
258
+ * @param put.body - Parameters to send with the custom request.
259
259
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
260
260
  */
261
261
  put({ path, parameters, body }, requestOptions) {
@@ -275,11 +275,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
275
275
  return transporter.request(request, requestOptions);
276
276
  },
277
277
  /**
278
- * Marks the A/B test as stopped. At this point, the test is over and cannot be restarted. As a result, your application is back to normal: index A will perform as usual, receiving 100% of all search requests. Associated metadata and metrics are still stored.
278
+ * If stopped, the test is over and can\'t be restarted. There is now only one index, receiving 100% of all search requests. The data gathered for stopped A/B tests is retained. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
279
279
  *
280
- * @summary Stop a test.
280
+ * @summary Stop an A/B test.
281
281
  * @param stopABTest - The stopABTest object.
282
- * @param stopABTest.id - The A/B test ID.
282
+ * @param stopABTest.id - Unique A/B test ID.
283
283
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
284
284
  */
285
285
  stopABTest({ id }, requestOptions) {
@@ -301,7 +301,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
301
301
  }
302
302
 
303
303
  // 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.
304
- const apiClientVersion$3 = '5.0.0-alpha.72';
304
+ const apiClientVersion$3 = '5.0.0-alpha.75';
305
305
  const REGIONS$1 = ['de', 'us'];
306
306
  function getDefaultHosts$2(region) {
307
307
  const url = !region
@@ -365,8 +365,8 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
365
365
  *
366
366
  * @summary Send requests to the Algolia REST API.
367
367
  * @param del - The del object.
368
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
369
- * @param del.parameters - Query parameters to be applied to the current query.
368
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
369
+ * @param del.parameters - Query parameters to apply to the current query.
370
370
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
371
371
  */
372
372
  del({ path, parameters }, requestOptions) {
@@ -389,8 +389,8 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
389
389
  *
390
390
  * @summary Send requests to the Algolia REST API.
391
391
  * @param get - The get object.
392
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
393
- * @param get.parameters - Query parameters to be applied to the current query.
392
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
393
+ * @param get.parameters - Query parameters to apply to the current query.
394
394
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
395
395
  */
396
396
  get({ path, parameters }, requestOptions) {
@@ -409,14 +409,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
409
409
  return transporter.request(request, requestOptions);
410
410
  },
411
411
  /**
412
- * Returns the average click position. The endpoint returns a value for the complete given time range, as well as a value per day.
412
+ * Return the average click position for the complete time range and for individual days. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
413
413
  *
414
414
  * @summary Get average click position.
415
415
  * @param getAverageClickPosition - The getAverageClickPosition object.
416
- * @param getAverageClickPosition.index - The index name to target.
417
- * @param getAverageClickPosition.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
418
- * @param getAverageClickPosition.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
419
- * @param getAverageClickPosition.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
416
+ * @param getAverageClickPosition.index - Index name to target.
417
+ * @param getAverageClickPosition.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
418
+ * @param getAverageClickPosition.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
419
+ * @param getAverageClickPosition.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
420
420
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
421
421
  */
422
422
  getAverageClickPosition({ index, startDate, endDate, tags }, requestOptions) {
@@ -447,14 +447,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
447
447
  return transporter.request(request, requestOptions);
448
448
  },
449
449
  /**
450
- * Returns the distribution of clicks per range of positions. If the groups all have a count of 0, it means Algolia didnt receive any click events for the queries with the clickAnalytics search parameter set to true. The count is 0 until Algolia receives at least one click event.
450
+ * Show the number of clicks events and their associated position in the search results. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
451
451
  *
452
- * @summary Get clicks per positions.
452
+ * @summary Get click positions.
453
453
  * @param getClickPositions - The getClickPositions object.
454
- * @param getClickPositions.index - The index name to target.
455
- * @param getClickPositions.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
456
- * @param getClickPositions.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
457
- * @param getClickPositions.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
454
+ * @param getClickPositions.index - Index name to target.
455
+ * @param getClickPositions.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
456
+ * @param getClickPositions.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
457
+ * @param getClickPositions.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
458
458
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
459
459
  */
460
460
  getClickPositions({ index, startDate, endDate, tags }, requestOptions) {
@@ -485,14 +485,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
485
485
  return transporter.request(request, requestOptions);
486
486
  },
487
487
  /**
488
- * Returns a click-through rate (CTR). The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of clicks and searches used to compute the rates.
488
+ * Returns a [click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
489
489
  *
490
490
  * @summary Get click-through rate (CTR).
491
491
  * @param getClickThroughRate - The getClickThroughRate object.
492
- * @param getClickThroughRate.index - The index name to target.
493
- * @param getClickThroughRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
494
- * @param getClickThroughRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
495
- * @param getClickThroughRate.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
492
+ * @param getClickThroughRate.index - Index name to target.
493
+ * @param getClickThroughRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
494
+ * @param getClickThroughRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
495
+ * @param getClickThroughRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
496
496
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
497
497
  */
498
498
  getClickThroughRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -523,14 +523,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
523
523
  return transporter.request(request, requestOptions);
524
524
  },
525
525
  /**
526
- * Returns a conversion rate (CR). The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of conversion and searches used to compute the rates.
526
+ * Return a [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
527
527
  *
528
528
  * @summary Get conversion rate (CR).
529
529
  * @param getConversationRate - The getConversationRate object.
530
- * @param getConversationRate.index - The index name to target.
531
- * @param getConversationRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
532
- * @param getConversationRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
533
- * @param getConversationRate.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
530
+ * @param getConversationRate.index - Index name to target.
531
+ * @param getConversationRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
532
+ * @param getConversationRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
533
+ * @param getConversationRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
534
534
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
535
535
  */
536
536
  getConversationRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -561,14 +561,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
561
561
  return transporter.request(request, requestOptions);
562
562
  },
563
563
  /**
564
- * Returns the rate at which searches didn\'t lead to any clicks. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without clicks.
564
+ * Returns the rate at which searches don\'t lead to any clicks. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without clicks.
565
565
  *
566
566
  * @summary Get no click rate.
567
567
  * @param getNoClickRate - The getNoClickRate object.
568
- * @param getNoClickRate.index - The index name to target.
569
- * @param getNoClickRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
570
- * @param getNoClickRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
571
- * @param getNoClickRate.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
568
+ * @param getNoClickRate.index - Index name to target.
569
+ * @param getNoClickRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
570
+ * @param getNoClickRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
571
+ * @param getNoClickRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
572
572
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
573
573
  */
574
574
  getNoClickRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -599,14 +599,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
599
599
  return transporter.request(request, requestOptions);
600
600
  },
601
601
  /**
602
- * Returns the rate at which searches didn\'t return any results. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without results used to compute the rates.
602
+ * Returns the rate at which searches didn\'t return any results.
603
603
  *
604
604
  * @summary Get no results rate.
605
605
  * @param getNoResultsRate - The getNoResultsRate object.
606
- * @param getNoResultsRate.index - The index name to target.
607
- * @param getNoResultsRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
608
- * @param getNoResultsRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
609
- * @param getNoResultsRate.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
606
+ * @param getNoResultsRate.index - Index name to target.
607
+ * @param getNoResultsRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
608
+ * @param getNoResultsRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
609
+ * @param getNoResultsRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
610
610
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
611
611
  */
612
612
  getNoResultsRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -637,14 +637,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
637
637
  return transporter.request(request, requestOptions);
638
638
  },
639
639
  /**
640
- * Returns the number of searches across the given time range. The endpoint returns a value for the complete given time range, as well as a value per day.
640
+ * Returns the number of searches within a time range.
641
641
  *
642
- * @summary Get searches count.
642
+ * @summary Get number of searches.
643
643
  * @param getSearchesCount - The getSearchesCount object.
644
- * @param getSearchesCount.index - The index name to target.
645
- * @param getSearchesCount.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
646
- * @param getSearchesCount.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
647
- * @param getSearchesCount.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
644
+ * @param getSearchesCount.index - Index name to target.
645
+ * @param getSearchesCount.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
646
+ * @param getSearchesCount.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
647
+ * @param getSearchesCount.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
648
648
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
649
649
  */
650
650
  getSearchesCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -675,16 +675,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
675
675
  return transporter.request(request, requestOptions);
676
676
  },
677
677
  /**
678
- * Returns top searches that didn\'t lead to any clicks. Limited to the 1000 most frequent ones. For each search, also returns the average number of found hits.
678
+ * Return the most popular of the last 1,000 searches that didn\'t lead to any clicks.
679
679
  *
680
680
  * @summary Get top searches with no clicks.
681
681
  * @param getSearchesNoClicks - The getSearchesNoClicks object.
682
- * @param getSearchesNoClicks.index - The index name to target.
683
- * @param getSearchesNoClicks.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
684
- * @param getSearchesNoClicks.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
685
- * @param getSearchesNoClicks.limit - Number of records to return. Limit is the size of the page.
682
+ * @param getSearchesNoClicks.index - Index name to target.
683
+ * @param getSearchesNoClicks.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
684
+ * @param getSearchesNoClicks.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
685
+ * @param getSearchesNoClicks.limit - Number of records to return (page size).
686
686
  * @param getSearchesNoClicks.offset - Position of the starting record. Used for paging. 0 is the first record.
687
- * @param getSearchesNoClicks.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
687
+ * @param getSearchesNoClicks.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
688
688
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
689
689
  */
690
690
  getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -721,16 +721,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
721
721
  return transporter.request(request, requestOptions);
722
722
  },
723
723
  /**
724
- * Returns top searches that didn\'t return any results. Limited to the 1000 most frequent ones.
724
+ * Returns the most popular of the latest 1,000 searches that didn\'t return any results.
725
725
  *
726
726
  * @summary Get top searches with no results.
727
727
  * @param getSearchesNoResults - The getSearchesNoResults object.
728
- * @param getSearchesNoResults.index - The index name to target.
729
- * @param getSearchesNoResults.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
730
- * @param getSearchesNoResults.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
731
- * @param getSearchesNoResults.limit - Number of records to return. Limit is the size of the page.
728
+ * @param getSearchesNoResults.index - Index name to target.
729
+ * @param getSearchesNoResults.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
730
+ * @param getSearchesNoResults.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
731
+ * @param getSearchesNoResults.limit - Number of records to return (page size).
732
732
  * @param getSearchesNoResults.offset - Position of the starting record. Used for paging. 0 is the first record.
733
- * @param getSearchesNoResults.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
733
+ * @param getSearchesNoResults.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
734
734
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
735
735
  */
736
736
  getSearchesNoResults({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -767,11 +767,11 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
767
767
  return transporter.request(request, requestOptions);
768
768
  },
769
769
  /**
770
- * Returns the latest update time of the analytics API for a given index. If the index has been recently created and/or no search has been performed yet the updated time will be null.
770
+ * Return the latest update time of the Analytics API for an index. If the index has been recently created or no search has been performed yet, `updatedAt` will be `null`. > **Note**: The Analytics API is updated every 5 minutes.
771
771
  *
772
772
  * @summary Get Analytics API status.
773
773
  * @param getStatus - The getStatus object.
774
- * @param getStatus.index - The index name to target.
774
+ * @param getStatus.index - Index name to target.
775
775
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
776
776
  */
777
777
  getStatus({ index }, requestOptions) {
@@ -793,16 +793,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
793
793
  return transporter.request(request, requestOptions);
794
794
  },
795
795
  /**
796
- * Returns top countries. Limited to the 1000 most frequent ones.
796
+ * Returns top countries. Limited to the 1,000 most frequent ones.
797
797
  *
798
798
  * @summary Get top countries.
799
799
  * @param getTopCountries - The getTopCountries object.
800
- * @param getTopCountries.index - The index name to target.
801
- * @param getTopCountries.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
802
- * @param getTopCountries.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
803
- * @param getTopCountries.limit - Number of records to return. Limit is the size of the page.
800
+ * @param getTopCountries.index - Index name to target.
801
+ * @param getTopCountries.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
802
+ * @param getTopCountries.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
803
+ * @param getTopCountries.limit - Number of records to return (page size).
804
804
  * @param getTopCountries.offset - Position of the starting record. Used for paging. 0 is the first record.
805
- * @param getTopCountries.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
805
+ * @param getTopCountries.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
806
806
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
807
807
  */
808
808
  getTopCountries({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
@@ -839,17 +839,17 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
839
839
  return transporter.request(request, requestOptions);
840
840
  },
841
841
  /**
842
- * Returns top filter attributes. Limited to the 1000 most used filters.
842
+ * Return the most popular [filterable attributes](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering/) in the 1,000 most recently used filters.
843
843
  *
844
- * @summary Get top filter attributes.
844
+ * @summary Get top filterable attributes.
845
845
  * @param getTopFilterAttributes - The getTopFilterAttributes object.
846
- * @param getTopFilterAttributes.index - The index name to target.
847
- * @param getTopFilterAttributes.search - The query term to search for. Must match the exact user input.
848
- * @param getTopFilterAttributes.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
849
- * @param getTopFilterAttributes.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
850
- * @param getTopFilterAttributes.limit - Number of records to return. Limit is the size of the page.
846
+ * @param getTopFilterAttributes.index - Index name to target.
847
+ * @param getTopFilterAttributes.search - User query.
848
+ * @param getTopFilterAttributes.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
849
+ * @param getTopFilterAttributes.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
850
+ * @param getTopFilterAttributes.limit - Number of records to return (page size).
851
851
  * @param getTopFilterAttributes.offset - Position of the starting record. Used for paging. 0 is the first record.
852
- * @param getTopFilterAttributes.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
852
+ * @param getTopFilterAttributes.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
853
853
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
854
854
  */
855
855
  getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -889,18 +889,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
889
889
  return transporter.request(request, requestOptions);
890
890
  },
891
891
  /**
892
- * Returns top filters for the given attribute. Limited to the 1000 most used filters.
892
+ * Returns the most popular filter values for an attribute in the 1,000 most recently used filters.
893
893
  *
894
- * @summary Get top filters for the an attribute.
894
+ * @summary Get top filter values for an attribute.
895
895
  * @param getTopFilterForAttribute - The getTopFilterForAttribute object.
896
- * @param getTopFilterForAttribute.attribute - The exact name of the attribute.
897
- * @param getTopFilterForAttribute.index - The index name to target.
898
- * @param getTopFilterForAttribute.search - The query term to search for. Must match the exact user input.
899
- * @param getTopFilterForAttribute.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
900
- * @param getTopFilterForAttribute.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
901
- * @param getTopFilterForAttribute.limit - Number of records to return. Limit is the size of the page.
896
+ * @param getTopFilterForAttribute.attribute - Attribute name.
897
+ * @param getTopFilterForAttribute.index - Index name to target.
898
+ * @param getTopFilterForAttribute.search - User query.
899
+ * @param getTopFilterForAttribute.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
900
+ * @param getTopFilterForAttribute.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
901
+ * @param getTopFilterForAttribute.limit - Number of records to return (page size).
902
902
  * @param getTopFilterForAttribute.offset - Position of the starting record. Used for paging. 0 is the first record.
903
- * @param getTopFilterForAttribute.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
903
+ * @param getTopFilterForAttribute.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
904
904
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
905
905
  */
906
906
  getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -943,17 +943,17 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
943
943
  return transporter.request(request, requestOptions);
944
944
  },
945
945
  /**
946
- * Returns top filters with no results. Limited to the 1000 most used filters.
946
+ * Returns top filters for filter-enabled searches that don\'t return results. Limited to the 1,000 most recently used filters.
947
947
  *
948
948
  * @summary Get top filters for a no result search.
949
949
  * @param getTopFiltersNoResults - The getTopFiltersNoResults object.
950
- * @param getTopFiltersNoResults.index - The index name to target.
951
- * @param getTopFiltersNoResults.search - The query term to search for. Must match the exact user input.
952
- * @param getTopFiltersNoResults.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
953
- * @param getTopFiltersNoResults.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
954
- * @param getTopFiltersNoResults.limit - Number of records to return. Limit is the size of the page.
950
+ * @param getTopFiltersNoResults.index - Index name to target.
951
+ * @param getTopFiltersNoResults.search - User query.
952
+ * @param getTopFiltersNoResults.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
953
+ * @param getTopFiltersNoResults.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
954
+ * @param getTopFiltersNoResults.limit - Number of records to return (page size).
955
955
  * @param getTopFiltersNoResults.offset - Position of the starting record. Used for paging. 0 is the first record.
956
- * @param getTopFiltersNoResults.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
956
+ * @param getTopFiltersNoResults.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
957
957
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
958
958
  */
959
959
  getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -993,18 +993,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
993
993
  return transporter.request(request, requestOptions);
994
994
  },
995
995
  /**
996
- * Returns top hits. Limited to the 1000 most frequent ones.
996
+ * Return the most popular clicked results in the last 1,000 searches.
997
997
  *
998
998
  * @summary Get top hits.
999
999
  * @param getTopHits - The getTopHits object.
1000
- * @param getTopHits.index - The index name to target.
1001
- * @param getTopHits.search - The query term to search for. Must match the exact user input.
1002
- * @param getTopHits.clickAnalytics - Whether to include the click-through and conversion rates for a search.
1003
- * @param getTopHits.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1004
- * @param getTopHits.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1005
- * @param getTopHits.limit - Number of records to return. Limit is the size of the page.
1000
+ * @param getTopHits.index - Index name to target.
1001
+ * @param getTopHits.search - User query.
1002
+ * @param getTopHits.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1003
+ * @param getTopHits.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1004
+ * @param getTopHits.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1005
+ * @param getTopHits.limit - Number of records to return (page size).
1006
1006
  * @param getTopHits.offset - Position of the starting record. Used for paging. 0 is the first record.
1007
- * @param getTopHits.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1007
+ * @param getTopHits.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1008
1008
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1009
1009
  */
1010
1010
  getTopHits({ index, search, clickAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1047,19 +1047,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1047
1047
  return transporter.request(request, requestOptions);
1048
1048
  },
1049
1049
  /**
1050
- * Returns top searches. Limited to the 1000 most frequent ones. For each search, also returns the average number of hits returned.
1050
+ * Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.
1051
1051
  *
1052
1052
  * @summary Get top searches.
1053
1053
  * @param getTopSearches - The getTopSearches object.
1054
- * @param getTopSearches.index - The index name to target.
1055
- * @param getTopSearches.clickAnalytics - Whether to include the click-through and conversion rates for a search.
1056
- * @param getTopSearches.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1057
- * @param getTopSearches.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1054
+ * @param getTopSearches.index - Index name to target.
1055
+ * @param getTopSearches.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1056
+ * @param getTopSearches.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1057
+ * @param getTopSearches.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1058
1058
  * @param getTopSearches.orderBy - Reorder the results.
1059
- * @param getTopSearches.direction - The sorting of the result.
1060
- * @param getTopSearches.limit - Number of records to return. Limit is the size of the page.
1059
+ * @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
1060
+ * @param getTopSearches.limit - Number of records to return (page size).
1061
1061
  * @param getTopSearches.offset - Position of the starting record. Used for paging. 0 is the first record.
1062
- * @param getTopSearches.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1062
+ * @param getTopSearches.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1063
1063
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1064
1064
  */
1065
1065
  getTopSearches({ index, clickAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
@@ -1105,14 +1105,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1105
1105
  return transporter.request(request, requestOptions);
1106
1106
  },
1107
1107
  /**
1108
- * Returns the distinct count of users across the given time range. The endpoint returns a value for the complete given time range, as well as a value per day.
1108
+ * Return the count of unique users.
1109
1109
  *
1110
- * @summary Get users count.
1110
+ * @summary Get user count.
1111
1111
  * @param getUsersCount - The getUsersCount object.
1112
- * @param getUsersCount.index - The index name to target.
1113
- * @param getUsersCount.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1114
- * @param getUsersCount.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1115
- * @param getUsersCount.tags - Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
1112
+ * @param getUsersCount.index - Index name to target.
1113
+ * @param getUsersCount.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1114
+ * @param getUsersCount.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1115
+ * @param getUsersCount.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1116
1116
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1117
1117
  */
1118
1118
  getUsersCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -1147,9 +1147,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1147
1147
  *
1148
1148
  * @summary Send requests to the Algolia REST API.
1149
1149
  * @param post - The post object.
1150
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1151
- * @param post.parameters - Query parameters to be applied to the current query.
1152
- * @param post.body - The parameters to send with the custom request.
1150
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
1151
+ * @param post.parameters - Query parameters to apply to the current query.
1152
+ * @param post.body - Parameters to send with the custom request.
1153
1153
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1154
1154
  */
1155
1155
  post({ path, parameters, body }, requestOptions) {
@@ -1173,9 +1173,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1173
1173
  *
1174
1174
  * @summary Send requests to the Algolia REST API.
1175
1175
  * @param put - The put object.
1176
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1177
- * @param put.parameters - Query parameters to be applied to the current query.
1178
- * @param put.body - The parameters to send with the custom request.
1176
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
1177
+ * @param put.parameters - Query parameters to apply to the current query.
1178
+ * @param put.body - Parameters to send with the custom request.
1179
1179
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1180
1180
  */
1181
1181
  put({ path, parameters, body }, requestOptions) {
@@ -1198,7 +1198,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1198
1198
  }
1199
1199
 
1200
1200
  // 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.
1201
- const apiClientVersion$2 = '5.0.0-alpha.72';
1201
+ const apiClientVersion$2 = '5.0.0-alpha.75';
1202
1202
  const REGIONS = ['eu', 'us'];
1203
1203
  function getDefaultHosts$1(region) {
1204
1204
  const url = 'personalization.{region}.algolia.com'.replace('{region}', region);
@@ -1260,8 +1260,8 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1260
1260
  *
1261
1261
  * @summary Send requests to the Algolia REST API.
1262
1262
  * @param del - The del object.
1263
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1264
- * @param del.parameters - Query parameters to be applied to the current query.
1263
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
1264
+ * @param del.parameters - Query parameters to apply to the current query.
1265
1265
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1266
1266
  */
1267
1267
  del({ path, parameters }, requestOptions) {
@@ -1307,8 +1307,8 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1307
1307
  *
1308
1308
  * @summary Send requests to the Algolia REST API.
1309
1309
  * @param get - The get object.
1310
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1311
- * @param get.parameters - Query parameters to be applied to the current query.
1310
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
1311
+ * @param get.parameters - Query parameters to apply to the current query.
1312
1312
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1313
1313
  */
1314
1314
  get({ path, parameters }, requestOptions) {
@@ -1372,9 +1372,9 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1372
1372
  *
1373
1373
  * @summary Send requests to the Algolia REST API.
1374
1374
  * @param post - The post object.
1375
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1376
- * @param post.parameters - Query parameters to be applied to the current query.
1377
- * @param post.body - The parameters to send with the custom request.
1375
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
1376
+ * @param post.parameters - Query parameters to apply to the current query.
1377
+ * @param post.body - Parameters to send with the custom request.
1378
1378
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1379
1379
  */
1380
1380
  post({ path, parameters, body }, requestOptions) {
@@ -1398,9 +1398,9 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1398
1398
  *
1399
1399
  * @summary Send requests to the Algolia REST API.
1400
1400
  * @param put - The put object.
1401
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1402
- * @param put.parameters - Query parameters to be applied to the current query.
1403
- * @param put.body - The parameters to send with the custom request.
1401
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
1402
+ * @param put.parameters - Query parameters to apply to the current query.
1403
+ * @param put.body - Parameters to send with the custom request.
1404
1404
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1405
1405
  */
1406
1406
  put({ path, parameters, body }, requestOptions) {
@@ -1455,7 +1455,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1455
1455
  }
1456
1456
 
1457
1457
  // 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.
1458
- const apiClientVersion$1 = '5.0.0-alpha.72';
1458
+ const apiClientVersion$1 = '5.0.0-alpha.75';
1459
1459
  function getDefaultHosts(appId) {
1460
1460
  return [
1461
1461
  {
@@ -1702,9 +1702,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1702
1702
  });
1703
1703
  },
1704
1704
  /**
1705
- * Add a new API Key with specific permissions/restrictions.
1705
+ * 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.
1706
1706
  *
1707
- * @summary Create an API key.
1707
+ * @summary Add API key.
1708
1708
  * @param apiKey - The apiKey object.
1709
1709
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1710
1710
  */
@@ -1728,13 +1728,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1728
1728
  return transporter.request(request, requestOptions);
1729
1729
  },
1730
1730
  /**
1731
- * Add or replace an object with a given object ID. If the object does not exist, it will be created. If it already exists, it will be replaced.
1731
+ * If you use an existing `objectID`, the existing record will be replaced with the new one. To update only some attributes of an existing record, use the [`partial` operation](#tag/Records/operation/partialUpdateObject) instead. To add multiple records to your index in a single API request, use the [`batch` operation](#tag/Records/operation/batch).
1732
1732
  *
1733
- * @summary Add or replace an object.
1733
+ * @summary Add or update a record (using objectID).
1734
1734
  * @param addOrUpdateObject - The addOrUpdateObject object.
1735
- * @param addOrUpdateObject.indexName - The index in which to perform the request.
1736
- * @param addOrUpdateObject.objectID - Unique identifier of an object.
1737
- * @param addOrUpdateObject.body - The Algolia object.
1735
+ * @param addOrUpdateObject.indexName - Index on which to perform the request.
1736
+ * @param addOrUpdateObject.objectID - Unique record (object) identifier.
1737
+ * @param addOrUpdateObject.body - Algolia record.
1738
1738
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1739
1739
  */
1740
1740
  addOrUpdateObject({ indexName, objectID, body }, requestOptions) {
@@ -1762,10 +1762,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1762
1762
  return transporter.request(request, requestOptions);
1763
1763
  },
1764
1764
  /**
1765
- * Add a single source to the list of allowed sources.
1765
+ * Add a source to the list of allowed sources.
1766
1766
  *
1767
- * @summary Add a single source.
1768
- * @param source - The source to add.
1767
+ * @summary Add a source.
1768
+ * @param source - Source to add.
1769
1769
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1770
1770
  */
1771
1771
  appendSource(source, requestOptions) {
@@ -1788,9 +1788,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1788
1788
  return transporter.request(request, requestOptions);
1789
1789
  },
1790
1790
  /**
1791
- * Assign or Move a userID to a cluster. The time it takes to migrate (move) a user is proportional to the amount of data linked to the userID. Upon success, the response is 200 OK. A successful response indicates that the operation has been taken into account, and the userID is directly usable.
1791
+ * Assign or move a user ID to a cluster. The time it takes to move a user is proportional to the amount of data linked to the user ID.
1792
1792
  *
1793
- * @summary Assign or Move userID.
1793
+ * @summary Assign or move a user ID.
1794
1794
  * @param assignUserId - The assignUserId object.
1795
1795
  * @param assignUserId.xAlgoliaUserID - UserID to assign.
1796
1796
  * @param assignUserId.assignUserIdParams - The assignUserIdParams object.
@@ -1822,11 +1822,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1822
1822
  return transporter.request(request, requestOptions);
1823
1823
  },
1824
1824
  /**
1825
- * Perform multiple write operations targeting one index, in a single API call.
1825
+ * To reduce the time spent on network round trips, you can perform several write actions in a single API call. Actions are applied in the order they are specified. The supported `action`s are equivalent to the individual operations of the same name.
1826
1826
  *
1827
- * @summary Batch operations to one index.
1827
+ * @summary Batch write operations on one index.
1828
1828
  * @param batch - The batch object.
1829
- * @param batch.indexName - The index in which to perform the request.
1829
+ * @param batch.indexName - Index on which to perform the request.
1830
1830
  * @param batch.batchWriteParams - The batchWriteParams object.
1831
1831
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1832
1832
  */
@@ -1853,7 +1853,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1853
1853
  return transporter.request(request, requestOptions);
1854
1854
  },
1855
1855
  /**
1856
- * Assign multiple userIDs to a cluster. Upon success, the response is 200 OK. A successful response indicates that the operation has been taken into account, and the userIDs are directly usable.
1856
+ * Assign multiple user IDs to a cluster. **You can\'t _move_ users with this operation.**.
1857
1857
  *
1858
1858
  * @summary Batch assign userIDs.
1859
1859
  * @param batchAssignUserIds - The batchAssignUserIds object.
@@ -1890,11 +1890,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1890
1890
  return transporter.request(request, requestOptions);
1891
1891
  },
1892
1892
  /**
1893
- * Send a batch of dictionary entries.
1893
+ * Add or remove a batch of dictionary entries.
1894
1894
  *
1895
1895
  * @summary Batch dictionary entries.
1896
1896
  * @param batchDictionaryEntries - The batchDictionaryEntries object.
1897
- * @param batchDictionaryEntries.dictionaryName - The dictionary to search in.
1897
+ * @param batchDictionaryEntries.dictionaryName - Dictionary to search in.
1898
1898
  * @param batchDictionaryEntries.batchDictionaryEntriesParams - The batchDictionaryEntriesParams object.
1899
1899
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1900
1900
  */
@@ -1921,11 +1921,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1921
1921
  return transporter.request(request, requestOptions);
1922
1922
  },
1923
1923
  /**
1924
- * This method allows you to retrieve all index content. It can retrieve up to 1,000 records per call and supports full text search and filters. For performance reasons, some features are not supported, including `distinct`, sorting by `typos`, `words` or `geo distance`. When there is more content to be browsed, the response contains a cursor field. This cursor has to be passed to the subsequent call to browse in order to get the next page of results. When the end of the index has been reached, the cursor field is absent from the response.
1924
+ * Retrieve up to 1,000 records per call. Supports full-text search and filters. For better performance, it doesn\'t support: - The `distinct` query parameter - Sorting by typos, proximity, words, or geographical distance.
1925
1925
  *
1926
- * @summary Retrieve all index content.
1926
+ * @summary Get all records from an index.
1927
1927
  * @param browse - The browse object.
1928
- * @param browse.indexName - The index in which to perform the request.
1928
+ * @param browse.indexName - Index on which to perform the request.
1929
1929
  * @param browse.browseParams - The browseParams object.
1930
1930
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1931
1931
  */
@@ -1946,12 +1946,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1946
1946
  return transporter.request(request, requestOptions);
1947
1947
  },
1948
1948
  /**
1949
- * Remove all synonyms from an index.
1949
+ * Delete all synonyms in the index.
1950
1950
  *
1951
- * @summary Clear all synonyms.
1951
+ * @summary Delete all synonyms.
1952
1952
  * @param clearAllSynonyms - The clearAllSynonyms object.
1953
- * @param clearAllSynonyms.indexName - The index in which to perform the request.
1954
- * @param clearAllSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1953
+ * @param clearAllSynonyms.indexName - Index on which to perform the request.
1954
+ * @param clearAllSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1955
1955
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1956
1956
  */
1957
1957
  clearAllSynonyms({ indexName, forwardToReplicas }, requestOptions) {
@@ -1973,11 +1973,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1973
1973
  return transporter.request(request, requestOptions);
1974
1974
  },
1975
1975
  /**
1976
- * Delete an index\'s content, but leave settings and index-specific API keys untouched.
1976
+ * Delete the records but leave settings and index-specific API keys untouched.
1977
1977
  *
1978
- * @summary Clear all objects from an index.
1978
+ * @summary Delete all records from an index.
1979
1979
  * @param clearObjects - The clearObjects object.
1980
- * @param clearObjects.indexName - The index in which to perform the request.
1980
+ * @param clearObjects.indexName - Index on which to perform the request.
1981
1981
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1982
1982
  */
1983
1983
  clearObjects({ indexName }, requestOptions) {
@@ -1996,12 +1996,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1996
1996
  return transporter.request(request, requestOptions);
1997
1997
  },
1998
1998
  /**
1999
- * Delete all Rules in the index.
1999
+ * Delete all rules in the index.
2000
2000
  *
2001
- * @summary Clear Rules.
2001
+ * @summary Delete all rules.
2002
2002
  * @param clearRules - The clearRules object.
2003
- * @param clearRules.indexName - The index in which to perform the request.
2004
- * @param clearRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2003
+ * @param clearRules.indexName - Index on which to perform the request.
2004
+ * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2005
2005
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2006
2006
  */
2007
2007
  clearRules({ indexName, forwardToReplicas }, requestOptions) {
@@ -2027,8 +2027,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2027
2027
  *
2028
2028
  * @summary Send requests to the Algolia REST API.
2029
2029
  * @param del - The del object.
2030
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2031
- * @param del.parameters - Query parameters to be applied to the current query.
2030
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
2031
+ * @param del.parameters - Query parameters to apply to the current query.
2032
2032
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2033
2033
  */
2034
2034
  del({ path, parameters }, requestOptions) {
@@ -2047,11 +2047,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2047
2047
  return transporter.request(request, requestOptions);
2048
2048
  },
2049
2049
  /**
2050
- * Delete an existing API Key.
2050
+ * Delete an existing API key. The request must be authenticated with the admin API key.
2051
2051
  *
2052
- * @summary Delete an API key.
2052
+ * @summary Delete API key.
2053
2053
  * @param deleteApiKey - The deleteApiKey object.
2054
- * @param deleteApiKey.key - API Key string.
2054
+ * @param deleteApiKey.key - API key.
2055
2055
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2056
2056
  */
2057
2057
  deleteApiKey({ key }, requestOptions) {
@@ -2070,11 +2070,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2070
2070
  return transporter.request(request, requestOptions);
2071
2071
  },
2072
2072
  /**
2073
- * Remove all objects matching a filter (including geo filters). This method enables you to delete one or more objects based on filters (numeric, facet, tag or geo queries). It doesn\'t accept empty filters or a query.
2073
+ * This operation doesn\'t support all the query options, only its filters (numeric, facet, or tag) and geo queries. It doesn\'t accept empty filters or queries.
2074
2074
  *
2075
- * @summary Delete all records matching the query.
2075
+ * @summary Delete all records matching a query.
2076
2076
  * @param deleteBy - The deleteBy object.
2077
- * @param deleteBy.indexName - The index in which to perform the request.
2077
+ * @param deleteBy.indexName - Index on which to perform the request.
2078
2078
  * @param deleteBy.deleteByParams - The deleteByParams object.
2079
2079
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2080
2080
  */
@@ -2102,7 +2102,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2102
2102
  *
2103
2103
  * @summary Delete index.
2104
2104
  * @param deleteIndex - The deleteIndex object.
2105
- * @param deleteIndex.indexName - The index in which to perform the request.
2105
+ * @param deleteIndex.indexName - Index on which to perform the request.
2106
2106
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2107
2107
  */
2108
2108
  deleteIndex({ indexName }, requestOptions) {
@@ -2121,12 +2121,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2121
2121
  return transporter.request(request, requestOptions);
2122
2122
  },
2123
2123
  /**
2124
- * Delete an existing object.
2124
+ * To delete a set of records matching a query, use the [`deleteByQuery` operation](#tag/Records/operation/deleteBy) instead.
2125
2125
  *
2126
- * @summary Delete an object.
2126
+ * @summary Delete a record.
2127
2127
  * @param deleteObject - The deleteObject object.
2128
- * @param deleteObject.indexName - The index in which to perform the request.
2129
- * @param deleteObject.objectID - Unique identifier of an object.
2128
+ * @param deleteObject.indexName - Index on which to perform the request.
2129
+ * @param deleteObject.objectID - Unique record (object) identifier.
2130
2130
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2131
2131
  */
2132
2132
  deleteObject({ indexName, objectID }, requestOptions) {
@@ -2150,13 +2150,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2150
2150
  return transporter.request(request, requestOptions);
2151
2151
  },
2152
2152
  /**
2153
- * Delete the Rule with the specified objectID.
2153
+ * Delete a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
2154
2154
  *
2155
2155
  * @summary Delete a rule.
2156
2156
  * @param deleteRule - The deleteRule object.
2157
- * @param deleteRule.indexName - The index in which to perform the request.
2158
- * @param deleteRule.objectID - Unique identifier of an object.
2159
- * @param deleteRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2157
+ * @param deleteRule.indexName - Index on which to perform the request.
2158
+ * @param deleteRule.objectID - Unique identifier of a rule object.
2159
+ * @param deleteRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2160
2160
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2161
2161
  */
2162
2162
  deleteRule({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -2183,11 +2183,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2183
2183
  return transporter.request(request, requestOptions);
2184
2184
  },
2185
2185
  /**
2186
- * Remove a single source from the list of allowed sources.
2186
+ * Remove a source from the list of allowed sources.
2187
2187
  *
2188
- * @summary Remove a single source.
2188
+ * @summary Remove a source.
2189
2189
  * @param deleteSource - The deleteSource object.
2190
- * @param deleteSource.source - The IP range of the source.
2190
+ * @param deleteSource.source - IP address range of the source.
2191
2191
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2192
2192
  */
2193
2193
  deleteSource({ source }, requestOptions) {
@@ -2206,13 +2206,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2206
2206
  return transporter.request(request, requestOptions);
2207
2207
  },
2208
2208
  /**
2209
- * Delete a single synonyms set, identified by the given objectID.
2209
+ * Delete a synonym by its `objectID`. To find the object IDs of your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
2210
2210
  *
2211
- * @summary Delete synonym.
2211
+ * @summary Delete a synonym.
2212
2212
  * @param deleteSynonym - The deleteSynonym object.
2213
- * @param deleteSynonym.indexName - The index in which to perform the request.
2214
- * @param deleteSynonym.objectID - Unique identifier of an object.
2215
- * @param deleteSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2213
+ * @param deleteSynonym.indexName - Index on which to perform the request.
2214
+ * @param deleteSynonym.objectID - Unique identifier of a synonym object.
2215
+ * @param deleteSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2216
2216
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2217
2217
  */
2218
2218
  deleteSynonym({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -2243,8 +2243,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2243
2243
  *
2244
2244
  * @summary Send requests to the Algolia REST API.
2245
2245
  * @param get - The get object.
2246
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2247
- * @param get.parameters - Query parameters to be applied to the current query.
2246
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
2247
+ * @param get.parameters - Query parameters to apply to the current query.
2248
2248
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2249
2249
  */
2250
2250
  get({ path, parameters }, requestOptions) {
@@ -2263,11 +2263,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2263
2263
  return transporter.request(request, requestOptions);
2264
2264
  },
2265
2265
  /**
2266
- * Get the permissions of an API key.
2266
+ * 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.
2267
2267
  *
2268
- * @summary Get an API key.
2268
+ * @summary Get API key permissions.
2269
2269
  * @param getApiKey - The getApiKey object.
2270
- * @param getApiKey.key - API Key string.
2270
+ * @param getApiKey.key - API key.
2271
2271
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2272
2272
  */
2273
2273
  getApiKey({ key }, requestOptions) {
@@ -2286,7 +2286,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2286
2286
  return transporter.request(request, requestOptions);
2287
2287
  },
2288
2288
  /**
2289
- * List dictionaries supported per language.
2289
+ * Lists Algolia\'s [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/) and any customizations applied to each language\'s [stop word](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/), [plural](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/), and [segmentation (compound)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/) features.
2290
2290
  *
2291
2291
  * @summary List available languages.
2292
2292
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2304,9 +2304,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2304
2304
  return transporter.request(request, requestOptions);
2305
2305
  },
2306
2306
  /**
2307
- * Retrieve dictionaries settings. The API stores languages whose standard entries are disabled. Fetch settings does not return false values.
2307
+ * Get the languages for which [stop words are turned off](#tag/Dictionaries/operation/setDictionarySettings).
2308
2308
  *
2309
- * @summary Retrieve dictionaries settings.
2309
+ * @summary Get stop word settings.
2310
2310
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2311
2311
  */
2312
2312
  getDictionarySettings(requestOptions) {
@@ -2322,13 +2322,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2322
2322
  return transporter.request(request, requestOptions);
2323
2323
  },
2324
2324
  /**
2325
- * Return the latest log entries.
2325
+ * The request must be authenticated by an API key with the [`logs` ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). Logs are held for the last seven days. There\'s also a logging limit of 1,000 API calls per server. This request counts towards your [operations quota](https://support.algolia.com/hc/en-us/articles/4406981829777-How-does-Algolia-count-records-and-operations-) but doesn\'t appear in the logs itself. > **Note**: To fetch the logs for a Distributed Search Network (DSN) cluster, target the [DSN\'s endpoint](https://www.algolia.com/doc/guides/scaling/distributed-search-network-dsn/#accessing-dsn-servers).
2326
2326
  *
2327
2327
  * @summary Return the latest log entries.
2328
2328
  * @param getLogs - The getLogs object.
2329
- * @param getLogs.offset - First entry to retrieve (zero-based). Log entries are sorted by decreasing date, therefore 0 designates the most recent log entry.
2330
- * @param getLogs.length - Maximum number of entries to retrieve. The maximum allowed value is 1000.
2331
- * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved across all indices.
2329
+ * @param getLogs.offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most recent.
2330
+ * @param getLogs.length - Maximum number of entries to retrieve.
2331
+ * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
2332
2332
  * @param getLogs.type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
2333
2333
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2334
2334
  */
@@ -2357,13 +2357,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2357
2357
  return transporter.request(request, requestOptions);
2358
2358
  },
2359
2359
  /**
2360
- * Retrieve one object from the index.
2360
+ * To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
2361
2361
  *
2362
- * @summary Retrieve an object.
2362
+ * @summary Get a record.
2363
2363
  * @param getObject - The getObject object.
2364
- * @param getObject.indexName - The index in which to perform the request.
2365
- * @param getObject.objectID - Unique identifier of an object.
2366
- * @param getObject.attributesToRetrieve - List of attributes to retrieve. If not specified, all retrievable attributes are returned.
2364
+ * @param getObject.indexName - Index on which to perform the request.
2365
+ * @param getObject.objectID - Unique record (object) identifier.
2366
+ * @param getObject.attributesToRetrieve - Attributes to include with the records in the response. This is useful to reduce the size of the API response. By default, all retrievable attributes are returned. `objectID` is always retrieved, even when not specified. [`unretrievableAttributes`](https://www.algolia.com/doc/api-reference/api-parameters/unretrievableAttributes/) won\'t be retrieved unless the request is authenticated with the admin API key.
2367
2367
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2368
2368
  */
2369
2369
  getObject({ indexName, objectID, attributesToRetrieve }, requestOptions) {
@@ -2390,10 +2390,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2390
2390
  return transporter.request(request, requestOptions);
2391
2391
  },
2392
2392
  /**
2393
- * Retrieve one or more objects, potentially from different indices, in a single API call.
2393
+ * Retrieve one or more records, potentially from different indices, in a single API operation. Results will be received in the same order as the requests.
2394
2394
  *
2395
- * @summary Retrieve one or more objects.
2396
- * @param getObjectsParams - The Algolia object.
2395
+ * @summary Get multiple records.
2396
+ * @param getObjectsParams - Request object.
2397
2397
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2398
2398
  */
2399
2399
  getObjects(getObjectsParams, requestOptions) {
@@ -2418,12 +2418,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2418
2418
  return transporter.request(request, requestOptions);
2419
2419
  },
2420
2420
  /**
2421
- * Retrieve the Rule with the specified objectID.
2421
+ * Get a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
2422
2422
  *
2423
2423
  * @summary Get a rule.
2424
2424
  * @param getRule - The getRule object.
2425
- * @param getRule.indexName - The index in which to perform the request.
2426
- * @param getRule.objectID - Unique identifier of an object.
2425
+ * @param getRule.indexName - Index on which to perform the request.
2426
+ * @param getRule.objectID - Unique identifier of a rule object.
2427
2427
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2428
2428
  */
2429
2429
  getRule({ indexName, objectID }, requestOptions) {
@@ -2447,11 +2447,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2447
2447
  return transporter.request(request, requestOptions);
2448
2448
  },
2449
2449
  /**
2450
- * Retrieve settings of an index.
2450
+ * Return an object containing an index\'s [configuration settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/).
2451
2451
  *
2452
- * @summary Retrieve settings of an index.
2452
+ * @summary Get index settings.
2453
2453
  * @param getSettings - The getSettings object.
2454
- * @param getSettings.indexName - The index in which to perform the request.
2454
+ * @param getSettings.indexName - Index on which to perform the request.
2455
2455
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2456
2456
  */
2457
2457
  getSettings({ indexName }, requestOptions) {
@@ -2470,9 +2470,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2470
2470
  return transporter.request(request, requestOptions);
2471
2471
  },
2472
2472
  /**
2473
- * List all allowed sources.
2473
+ * Get all allowed sources (IP addresses).
2474
2474
  *
2475
- * @summary List all allowed sources.
2475
+ * @summary Get all allowed IP addresses.
2476
2476
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2477
2477
  */
2478
2478
  getSources(requestOptions) {
@@ -2488,12 +2488,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2488
2488
  return transporter.request(request, requestOptions);
2489
2489
  },
2490
2490
  /**
2491
- * Fetch a synonym object identified by its objectID.
2491
+ * Get a syonym by its `objectID`. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
2492
2492
  *
2493
- * @summary Get synonym.
2493
+ * @summary Get a synonym object.
2494
2494
  * @param getSynonym - The getSynonym object.
2495
- * @param getSynonym.indexName - The index in which to perform the request.
2496
- * @param getSynonym.objectID - Unique identifier of an object.
2495
+ * @param getSynonym.indexName - Index on which to perform the request.
2496
+ * @param getSynonym.objectID - Unique identifier of a synonym object.
2497
2497
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2498
2498
  */
2499
2499
  getSynonym({ indexName, objectID }, requestOptions) {
@@ -2517,12 +2517,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2517
2517
  return transporter.request(request, requestOptions);
2518
2518
  },
2519
2519
  /**
2520
- * Check the current status of a given task.
2520
+ * Some operations, such as copying an index, will respond with a `taskID` value. Use this value here to check the status of that task.
2521
2521
  *
2522
- * @summary Check the status of a task.
2522
+ * @summary Check a task\'s status.
2523
2523
  * @param getTask - The getTask object.
2524
- * @param getTask.indexName - The index in which to perform the request.
2525
- * @param getTask.taskID - Unique identifier of an task. Numeric value (up to 64bits).
2524
+ * @param getTask.indexName - Index on which to perform the request.
2525
+ * @param getTask.taskID - Unique task identifier.
2526
2526
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2527
2527
  */
2528
2528
  getTask({ indexName, taskID }, requestOptions) {
@@ -2546,7 +2546,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2546
2546
  return transporter.request(request, requestOptions);
2547
2547
  },
2548
2548
  /**
2549
- * Get the top 10 userIDs with the highest number of records per cluster. The data returned will usually be a few seconds behind real time, because userID usage may take up to a few seconds to propagate to the different clusters. Upon success, the response is 200 OK and contains the following array of userIDs and clusters.
2549
+ * Get the IDs of the 10 users with the highest number of records per cluster. Since it can take up to a few seconds to get the data from the different clusters, the response isn\'t real-time.
2550
2550
  *
2551
2551
  * @summary Get top userID.
2552
2552
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2564,7 +2564,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2564
2564
  return transporter.request(request, requestOptions);
2565
2565
  },
2566
2566
  /**
2567
- * Returns the userID data stored in the mapping. The data returned will usually be a few seconds behind real time, because userID usage may take up to a few seconds to propagate to the different clusters. Upon success, the response is 200 OK and contains the following userID data.
2567
+ * Returns the userID data stored in the mapping. Since it can take up to a few seconds to get the data from the different clusters, the response isn\'t real-time.
2568
2568
  *
2569
2569
  * @summary Get userID.
2570
2570
  * @param getUserId - The getUserId object.
@@ -2587,11 +2587,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2587
2587
  return transporter.request(request, requestOptions);
2588
2588
  },
2589
2589
  /**
2590
- * Get the status of your clusters\' migrations or user creations. Creating a large batch of users or migrating your multi-cluster may take quite some time. This method lets you retrieve the status of the migration, so you can know when it\'s done. Upon success, the response is 200 OK. A successful response indicates that the operation has been taken into account, and the userIDs are directly usable.
2590
+ * To determine when the time-consuming process of creating a large batch of users or migrating users from one cluster to another is complete, this operation retrieves the status of the process.
2591
2591
  *
2592
- * @summary Get migration status.
2592
+ * @summary Get migration and user mapping status.
2593
2593
  * @param hasPendingMappings - The hasPendingMappings object.
2594
- * @param hasPendingMappings.getClusters - If the clusters pending mapping state should be on the response.
2594
+ * @param hasPendingMappings.getClusters - Indicates whether to include the cluster\'s pending mapping state in the response.
2595
2595
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2596
2596
  */
2597
2597
  hasPendingMappings({ getClusters } = {}, requestOptions = undefined) {
@@ -2610,9 +2610,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2610
2610
  return transporter.request(request, requestOptions);
2611
2611
  },
2612
2612
  /**
2613
- * List API keys, along with their associated rights.
2613
+ * List all API keys associated with your Algolia application, including their permissions and restrictions.
2614
2614
  *
2615
- * @summary List API Keys.
2615
+ * @summary List API keys.
2616
2616
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2617
2617
  */
2618
2618
  listApiKeys(requestOptions) {
@@ -2628,7 +2628,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2628
2628
  return transporter.request(request, requestOptions);
2629
2629
  },
2630
2630
  /**
2631
- * List the clusters available in a multi-clusters setup for a single appID. Upon success, the response is 200 OK and contains the following clusters.
2631
+ * List the available clusters in a multi-cluster setup.
2632
2632
  *
2633
2633
  * @summary List clusters.
2634
2634
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2646,20 +2646,24 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2646
2646
  return transporter.request(request, requestOptions);
2647
2647
  },
2648
2648
  /**
2649
- * List existing indexes from an application.
2649
+ * List indices in an Algolia application.
2650
2650
  *
2651
- * @summary List existing indexes.
2651
+ * @summary List indices.
2652
2652
  * @param listIndices - The listIndices object.
2653
- * @param listIndices.page - Requested page (zero-based). When specified, will retrieve a specific page; the page size is implicitly set to 100. When null, will retrieve all indices (no pagination).
2653
+ * @param listIndices.page - Returns the requested page number. The page size is determined by the `hitsPerPage` parameter. You can see the number of available pages in the `nbPages` response attribute. When `page` is null, the API response is not paginated.
2654
+ * @param listIndices.hitsPerPage - Maximum number of hits per page.
2654
2655
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2655
2656
  */
2656
- listIndices({ page } = {}, requestOptions = undefined) {
2657
+ listIndices({ page, hitsPerPage } = {}, requestOptions = undefined) {
2657
2658
  const requestPath = '/1/indexes';
2658
2659
  const headers = {};
2659
2660
  const queryParameters = {};
2660
2661
  if (page !== undefined) {
2661
2662
  queryParameters.page = page.toString();
2662
2663
  }
2664
+ if (hitsPerPage !== undefined) {
2665
+ queryParameters.hitsPerPage = hitsPerPage.toString();
2666
+ }
2663
2667
  const request = {
2664
2668
  method: 'GET',
2665
2669
  path: requestPath,
@@ -2669,12 +2673,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2669
2673
  return transporter.request(request, requestOptions);
2670
2674
  },
2671
2675
  /**
2672
- * List the userIDs assigned to a multi-clusters appID. The data returned will usually be a few seconds behind real time, because userID usage may take up to a few seconds to propagate to the different clusters. Upon success, the response is 200 OK and contains the following userIDs data.
2676
+ * List the userIDs assigned to a multi-cluster application. Since it can take up to a few seconds to get the data from the different clusters, the response isn\'t real-time.
2673
2677
  *
2674
2678
  * @summary List userIDs.
2675
2679
  * @param listUserIds - The listUserIds object.
2676
- * @param listUserIds.page - Requested page (zero-based). When specified, will retrieve a specific page; the page size is implicitly set to 100. When null, will retrieve all indices (no pagination).
2677
- * @param listUserIds.hitsPerPage - Maximum number of objects to retrieve.
2680
+ * @param listUserIds.page - Returns the requested page number. The page size is determined by the `hitsPerPage` parameter. You can see the number of available pages in the `nbPages` response attribute. When `page` is null, the API response is not paginated.
2681
+ * @param listUserIds.hitsPerPage - Maximum number of hits per page.
2678
2682
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2679
2683
  */
2680
2684
  listUserIds({ page, hitsPerPage } = {}, requestOptions = undefined) {
@@ -2696,9 +2700,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2696
2700
  return transporter.request(request, requestOptions);
2697
2701
  },
2698
2702
  /**
2699
- * Perform multiple write operations, potentially targeting multiple indices, in a single API call.
2703
+ * To reduce the time spent on network round trips, you can perform several write actions in a single request. It\'s a multi-index version of the [`batch` operation](#tag/Records/operation/batch). Actions are applied in the order they are specified. The supported actions are equivalent to the individual operations of the same name.
2700
2704
  *
2701
- * @summary Batch operations to many indices.
2705
+ * @summary Batch write operations on multiple indices.
2702
2706
  * @param batchParams - The batchParams object.
2703
2707
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2704
2708
  */
@@ -2722,11 +2726,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2722
2726
  return transporter.request(request, requestOptions);
2723
2727
  },
2724
2728
  /**
2725
- * Performs a copy or a move operation on a index.
2729
+ * This `operation`, _copy_ or _move_, will copy or move a source index\'s (`IndexName`) records, settings, synonyms, and rules to a `destination` index. If the destination index exists, it will be replaced, except for index-specific API keys and analytics data. If the destination index doesn\'t exist, it will be created. The choice between moving or copying an index depends on your needs. Choose: - **Move** to rename an index. - **Copy** to create a new index with the same records and configuration as an existing one. > **Note**: When considering copying or moving, be aware of the [rate limitations](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits) on these processes and the [impact on your analytics data](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/concepts/indices-analytics/).
2726
2730
  *
2727
- * @summary Copy/move index.
2731
+ * @summary Copy, move, or rename an index.
2728
2732
  * @param operationIndex - The operationIndex object.
2729
- * @param operationIndex.indexName - The index in which to perform the request.
2733
+ * @param operationIndex.indexName - Index on which to perform the request.
2730
2734
  * @param operationIndex.operationIndexParams - The operationIndexParams object.
2731
2735
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2732
2736
  */
@@ -2756,14 +2760,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2756
2760
  return transporter.request(request, requestOptions);
2757
2761
  },
2758
2762
  /**
2759
- * Update one or more attributes of an existing object. This method lets you update only a part of an existing object, either by adding new attributes or updating existing ones. You can partially update several objects in a single method call. If the index targeted by this operation doesn\'t exist yet, it\'s automatically created.
2763
+ * Add new attributes or update current ones in an existing record. You can use any first-level attribute but not nested attributes. If you specify a [nested attribute](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/creating-and-using-nested-attributes/), the engine treats it as a replacement for its first-level ancestor.
2760
2764
  *
2761
- * @summary Partially update an object.
2765
+ * @summary Update record attributes.
2762
2766
  * @param partialUpdateObject - The partialUpdateObject object.
2763
- * @param partialUpdateObject.indexName - The index in which to perform the request.
2764
- * @param partialUpdateObject.objectID - Unique identifier of an object.
2765
- * @param partialUpdateObject.attributesToUpdate - Map of attribute(s) to update.
2766
- * @param partialUpdateObject.createIfNotExists - Creates the record if it does not exist yet.
2767
+ * @param partialUpdateObject.indexName - Index on which to perform the request.
2768
+ * @param partialUpdateObject.objectID - Unique record (object) identifier.
2769
+ * @param partialUpdateObject.attributesToUpdate - Object with attributes to update.
2770
+ * @param partialUpdateObject.createIfNotExists - Indicates whether to create a new record if it doesn\'t exist yet.
2767
2771
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2768
2772
  */
2769
2773
  partialUpdateObject({ indexName, objectID, attributesToUpdate, createIfNotExists, }, requestOptions) {
@@ -2798,9 +2802,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2798
2802
  *
2799
2803
  * @summary Send requests to the Algolia REST API.
2800
2804
  * @param post - The post object.
2801
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2802
- * @param post.parameters - Query parameters to be applied to the current query.
2803
- * @param post.body - The parameters to send with the custom request.
2805
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
2806
+ * @param post.parameters - Query parameters to apply to the current query.
2807
+ * @param post.body - Parameters to send with the custom request.
2804
2808
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2805
2809
  */
2806
2810
  post({ path, parameters, body }, requestOptions) {
@@ -2824,9 +2828,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2824
2828
  *
2825
2829
  * @summary Send requests to the Algolia REST API.
2826
2830
  * @param put - The put object.
2827
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2828
- * @param put.parameters - Query parameters to be applied to the current query.
2829
- * @param put.body - The parameters to send with the custom request.
2831
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
2832
+ * @param put.parameters - Query parameters to apply to the current query.
2833
+ * @param put.body - Parameters to send with the custom request.
2830
2834
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2831
2835
  */
2832
2836
  put({ path, parameters, body }, requestOptions) {
@@ -2846,7 +2850,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2846
2850
  return transporter.request(request, requestOptions);
2847
2851
  },
2848
2852
  /**
2849
- * Remove a userID and its associated data from the multi-clusters. Upon success, the response is 200 OK and a task is created to remove the userID data and mapping.
2853
+ * Remove a userID and its associated data from the multi-clusters.
2850
2854
  *
2851
2855
  * @summary Remove userID.
2852
2856
  * @param removeUserId - The removeUserId object.
@@ -2871,9 +2875,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2871
2875
  /**
2872
2876
  * Replace all allowed sources.
2873
2877
  *
2874
- * @summary Replace all allowed sources.
2878
+ * @summary Replace all sources.
2875
2879
  * @param replaceSources - The replaceSources object.
2876
- * @param replaceSources.source - The sources to allow.
2880
+ * @param replaceSources.source - Allowed sources.
2877
2881
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2878
2882
  */
2879
2883
  replaceSources({ source }, requestOptions) {
@@ -2893,11 +2897,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2893
2897
  return transporter.request(request, requestOptions);
2894
2898
  },
2895
2899
  /**
2896
- * Restore a deleted API key, along with its associated rights.
2900
+ * Restore a deleted API key, along with its associated permissions. The request must be authenticated with the admin API key.
2897
2901
  *
2898
- * @summary Restore an API key.
2902
+ * @summary Restore API key.
2899
2903
  * @param restoreApiKey - The restoreApiKey object.
2900
- * @param restoreApiKey.key - API Key string.
2904
+ * @param restoreApiKey.key - API key.
2901
2905
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2902
2906
  */
2903
2907
  restoreApiKey({ key }, requestOptions) {
@@ -2916,11 +2920,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2916
2920
  return transporter.request(request, requestOptions);
2917
2921
  },
2918
2922
  /**
2919
- * Add an object to the index, automatically assigning it an object ID.
2923
+ * Add a record (object) to an index or replace it. If the record doesn\'t contain an `objectID`, Algolia automatically adds it. If you use an existing `objectID`, the existing record is replaced with the new one. To add multiple records to your index in a single API request, use the [`batch` operation](#tag/Records/operation/batch).
2920
2924
  *
2921
- * @summary Add an object to the index.
2925
+ * @summary Add or update a record.
2922
2926
  * @param saveObject - The saveObject object.
2923
- * @param saveObject.indexName - The index in which to perform the request.
2927
+ * @param saveObject.indexName - Index on which to perform the request.
2924
2928
  * @param saveObject.body - The Algolia record.
2925
2929
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2926
2930
  */
@@ -2944,14 +2948,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2944
2948
  return transporter.request(request, requestOptions);
2945
2949
  },
2946
2950
  /**
2947
- * Create or update the Rule with the specified objectID.
2951
+ * To create or update more than one rule, use the [`batch` operation](#tag/Rules/operation/saveRules).
2948
2952
  *
2949
- * @summary Save/Update a rule.
2953
+ * @summary Create or update a rule.
2950
2954
  * @param saveRule - The saveRule object.
2951
- * @param saveRule.indexName - The index in which to perform the request.
2952
- * @param saveRule.objectID - Unique identifier of an object.
2955
+ * @param saveRule.indexName - Index on which to perform the request.
2956
+ * @param saveRule.objectID - Unique identifier of a rule object.
2953
2957
  * @param saveRule.rule - The rule object.
2954
- * @param saveRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2958
+ * @param saveRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2955
2959
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2956
2960
  */
2957
2961
  saveRule({ indexName, objectID, rule, forwardToReplicas }, requestOptions) {
@@ -2985,14 +2989,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2985
2989
  return transporter.request(request, requestOptions);
2986
2990
  },
2987
2991
  /**
2988
- * Create/update multiple rules objects at once.
2992
+ * Create or update multiple rules.
2989
2993
  *
2990
2994
  * @summary Save a batch of rules.
2991
2995
  * @param saveRules - The saveRules object.
2992
- * @param saveRules.indexName - The index in which to perform the request.
2996
+ * @param saveRules.indexName - Index on which to perform the request.
2993
2997
  * @param saveRules.rules - The rules object.
2994
- * @param saveRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2995
- * @param saveRules.clearExistingRules - When true, existing Rules are cleared before adding this batch. When false, existing Rules are kept.
2998
+ * @param saveRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2999
+ * @param saveRules.clearExistingRules - Indicates whether existing rules should be deleted before adding this batch.
2996
3000
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2997
3001
  */
2998
3002
  saveRules({ indexName, rules, forwardToReplicas, clearExistingRules, }, requestOptions) {
@@ -3021,14 +3025,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3021
3025
  return transporter.request(request, requestOptions);
3022
3026
  },
3023
3027
  /**
3024
- * Create a new synonym object or update the existing synonym object with the given object ID.
3028
+ * Add a [synonym](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/#the-different-types-of-synonyms) to an index or replace it. If the synonym `objectID` doesn\'t exist, Algolia adds a new one. If you use an existing synonym `objectID`, the existing synonym is replaced with the new one. To add multiple synonyms in a single API request, use the [`batch` operation](#tag/Synonyms/operation/saveSynonyms).
3025
3029
  *
3026
- * @summary Save synonym.
3030
+ * @summary Save a synonym.
3027
3031
  * @param saveSynonym - The saveSynonym object.
3028
- * @param saveSynonym.indexName - The index in which to perform the request.
3029
- * @param saveSynonym.objectID - Unique identifier of an object.
3032
+ * @param saveSynonym.indexName - Index on which to perform the request.
3033
+ * @param saveSynonym.objectID - Unique identifier of a synonym object.
3030
3034
  * @param saveSynonym.synonymHit - The synonymHit object.
3031
- * @param saveSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3035
+ * @param saveSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3032
3036
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3033
3037
  */
3034
3038
  saveSynonym({ indexName, objectID, synonymHit, forwardToReplicas }, requestOptions) {
@@ -3065,14 +3069,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3065
3069
  return transporter.request(request, requestOptions);
3066
3070
  },
3067
3071
  /**
3068
- * Create/update multiple synonym objects at once, potentially replacing the entire list of synonyms if replaceExistingSynonyms is true.
3072
+ * Create or update multiple synonyms.
3069
3073
  *
3070
3074
  * @summary Save a batch of synonyms.
3071
3075
  * @param saveSynonyms - The saveSynonyms object.
3072
- * @param saveSynonyms.indexName - The index in which to perform the request.
3076
+ * @param saveSynonyms.indexName - Index on which to perform the request.
3073
3077
  * @param saveSynonyms.synonymHit - The synonymHit object.
3074
- * @param saveSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3075
- * @param saveSynonyms.replaceExistingSynonyms - Replace all synonyms of the index with the ones sent with this request.
3078
+ * @param saveSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3079
+ * @param saveSynonyms.replaceExistingSynonyms - Indicates whether to replace all synonyms in the index with the ones sent with this request.
3076
3080
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3077
3081
  */
3078
3082
  saveSynonyms({ indexName, synonymHit, forwardToReplicas, replaceExistingSynonyms, }, requestOptions) {
@@ -3102,10 +3106,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3102
3106
  return transporter.request(request, requestOptions);
3103
3107
  },
3104
3108
  /**
3105
- * Perform a search operation targeting one or many indices.
3109
+ * Send multiple search queries to one or more indices.
3106
3110
  *
3107
3111
  * @summary Search multiple indices.
3108
- * @param searchMethodParams - The `search` requests and strategy.
3112
+ * @param searchMethodParams - Query requests and strategies. Results will be received in the same order as the queries.
3109
3113
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3110
3114
  */
3111
3115
  search(searchMethodParams, requestOptions) {
@@ -3152,11 +3156,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3152
3156
  return transporter.request(request, requestOptions);
3153
3157
  },
3154
3158
  /**
3155
- * Search the dictionary entries.
3159
+ * Search for standard and [custom](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/) entries in the [stop words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words/), [plurals](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-plurals-and-other-declensions/), or [segmentation (compounds)](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation/) dictionaries.
3156
3160
  *
3157
- * @summary Search a dictionary entries.
3161
+ * @summary Search dictionary entries.
3158
3162
  * @param searchDictionaryEntries - The searchDictionaryEntries object.
3159
- * @param searchDictionaryEntries.dictionaryName - The dictionary to search in.
3163
+ * @param searchDictionaryEntries.dictionaryName - Dictionary to search in.
3160
3164
  * @param searchDictionaryEntries.searchDictionaryEntriesParams - The searchDictionaryEntriesParams object.
3161
3165
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3162
3166
  */
@@ -3185,12 +3189,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3185
3189
  return transporter.request(request, requestOptions);
3186
3190
  },
3187
3191
  /**
3188
- * Search for values of a given facet, optionally restricting the returned values to those contained in objects matching other search criteria.
3192
+ * [Search for a facet\'s values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values), optionally restricting the returned values to those contained in records matching other search criteria. > **Note**: Pagination isn\'t supported (`page` and `hitsPerPage` are ignored). By default, the engine returns a maximum of 10 values but you can adjust this with `maxFacetHits`.
3189
3193
  *
3190
- * @summary Search for values of a given facet.
3194
+ * @summary Search for facet values.
3191
3195
  * @param searchForFacetValues - The searchForFacetValues object.
3192
- * @param searchForFacetValues.indexName - The index in which to perform the request.
3193
- * @param searchForFacetValues.facetName - The facet name.
3196
+ * @param searchForFacetValues.indexName - Index on which to perform the request.
3197
+ * @param searchForFacetValues.facetName - Facet name.
3194
3198
  * @param searchForFacetValues.searchForFacetValuesRequest - The searchForFacetValuesRequest object.
3195
3199
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3196
3200
  */
@@ -3218,11 +3222,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3218
3222
  return transporter.request(request, requestOptions);
3219
3223
  },
3220
3224
  /**
3221
- * Search for rules matching various criteria.
3225
+ * Search for rules in your index. You can control the search with parameters. To list all rules, send an empty request body.
3222
3226
  *
3223
3227
  * @summary Search for rules.
3224
3228
  * @param searchRules - The searchRules object.
3225
- * @param searchRules.indexName - The index in which to perform the request.
3229
+ * @param searchRules.indexName - Index on which to perform the request.
3226
3230
  * @param searchRules.searchRulesParams - The searchRulesParams object.
3227
3231
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3228
3232
  */
@@ -3245,11 +3249,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3245
3249
  return transporter.request(request, requestOptions);
3246
3250
  },
3247
3251
  /**
3248
- * Perform a search operation targeting one specific index.
3252
+ * Return records that match the query.
3249
3253
  *
3250
- * @summary Search in a single index.
3254
+ * @summary Search an index.
3251
3255
  * @param searchSingleIndex - The searchSingleIndex object.
3252
- * @param searchSingleIndex.indexName - The index in which to perform the request.
3256
+ * @param searchSingleIndex.indexName - Index on which to perform the request.
3253
3257
  * @param searchSingleIndex.searchParams - The searchParams object.
3254
3258
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3255
3259
  */
@@ -3272,15 +3276,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3272
3276
  return transporter.request(request, requestOptions);
3273
3277
  },
3274
3278
  /**
3275
- * Search or browse all synonyms, optionally filtering them by type.
3279
+ * Search for synonyms in your index. You can control and filter the search with parameters. To get all synonyms, send an empty request body.
3276
3280
  *
3277
- * @summary Search synonyms.
3281
+ * @summary Search for synonyms.
3278
3282
  * @param searchSynonyms - The searchSynonyms object.
3279
- * @param searchSynonyms.indexName - The index in which to perform the request.
3280
- * @param searchSynonyms.type - Only search for specific types of synonyms.
3281
- * @param searchSynonyms.page - Requested page (zero-based). When specified, will retrieve a specific page; the page size is implicitly set to 100. When null, will retrieve all indices (no pagination).
3282
- * @param searchSynonyms.hitsPerPage - Maximum number of objects to retrieve.
3283
- * @param searchSynonyms.searchSynonymsParams - The body of the the `searchSynonyms` method.
3283
+ * @param searchSynonyms.indexName - Index on which to perform the request.
3284
+ * @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).
3285
+ * @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.
3286
+ * @param searchSynonyms.hitsPerPage - Maximum number of hits per page.
3287
+ * @param searchSynonyms.searchSynonymsParams - Body of the `searchSynonyms` operation.
3284
3288
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3285
3289
  */
3286
3290
  searchSynonyms({ indexName, type, page, hitsPerPage, searchSynonymsParams, }, requestOptions) {
@@ -3311,9 +3315,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3311
3315
  return transporter.request(request, requestOptions);
3312
3316
  },
3313
3317
  /**
3314
- * Search for userIDs. The data returned will usually be a few seconds behind real time, because userID usage may take up to a few seconds propagate to the different clusters. To keep updates moving quickly, the index of userIDs isn\'t built synchronously with the mapping. Instead, the index is built once every 12h, at the same time as the update of userID usage. For example, when you perform a modification like adding or moving a userID, the search will report an outdated value until the next rebuild of the mapping, which takes place every 12h. Upon success, the response is 200 OK and contains the following userIDs data.
3318
+ * Since it can take up to a few seconds to get the data from the different clusters, the response isn\'t real-time. To ensure rapid updates, the user IDs index isn\'t built at the same time as the mapping. Instead, it\'s built every 12 hours, at the same time as the update of user ID usage. For example, if you add or move a user ID, the search will show an old value until the next time the mapping is rebuilt (every 12 hours).
3315
3319
  *
3316
- * @summary Search userID.
3320
+ * @summary Search for a user ID.
3317
3321
  * @param searchUserIdsParams - The searchUserIdsParams object.
3318
3322
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3319
3323
  */
@@ -3339,9 +3343,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3339
3343
  return transporter.request(request, requestOptions);
3340
3344
  },
3341
3345
  /**
3342
- * Set dictionaries settings.
3346
+ * Set stop word settings for a specific language.
3343
3347
  *
3344
- * @summary Set dictionaries settings.
3348
+ * @summary Set stop word settings.
3345
3349
  * @param dictionarySettingsParams - The dictionarySettingsParams object.
3346
3350
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3347
3351
  */
@@ -3365,13 +3369,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3365
3369
  return transporter.request(request, requestOptions);
3366
3370
  },
3367
3371
  /**
3368
- * Update settings of an index. Only specified settings are overridden; unspecified settings are left unchanged. Specifying null for a setting resets it to its default value.
3372
+ * Update the specified [index settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/). Specifying null for a setting resets it to its default value.
3369
3373
  *
3370
- * @summary Update settings of an index.
3374
+ * @summary Update index settings.
3371
3375
  * @param setSettings - The setSettings object.
3372
- * @param setSettings.indexName - The index in which to perform the request.
3376
+ * @param setSettings.indexName - Index on which to perform the request.
3373
3377
  * @param setSettings.indexSettings - The indexSettings object.
3374
- * @param setSettings.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3378
+ * @param setSettings.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3375
3379
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3376
3380
  */
3377
3381
  setSettings({ indexName, indexSettings, forwardToReplicas }, requestOptions) {
@@ -3397,11 +3401,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3397
3401
  return transporter.request(request, requestOptions);
3398
3402
  },
3399
3403
  /**
3400
- * Replace every permission of an existing API key.
3404
+ * Replace the permissions of an existing API key. Any unspecified parameter resets that permission to its default value. The request must be authenticated with the admin API key.
3401
3405
  *
3402
3406
  * @summary Update an API key.
3403
3407
  * @param updateApiKey - The updateApiKey object.
3404
- * @param updateApiKey.key - API Key string.
3408
+ * @param updateApiKey.key - API key.
3405
3409
  * @param updateApiKey.apiKey - The apiKey object.
3406
3410
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3407
3411
  */