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
@@ -1,12 +1,10 @@
1
1
  'use strict';
2
2
 
3
- Object.defineProperty(exports, '__esModule', { value: true });
4
-
5
3
  var clientCommon = require('@algolia/client-common');
6
4
  var requesterNodeHttp = require('@algolia/requester-node-http');
7
5
 
8
6
  // 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.
9
- const apiClientVersion$4 = '5.0.0-alpha.72';
7
+ const apiClientVersion$4 = '5.0.0-alpha.75';
10
8
  const REGIONS$2 = ['de', 'us'];
11
9
  function getDefaultHosts$3(region) {
12
10
  const url = !region
@@ -66,9 +64,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
66
64
  transporter.algoliaAgent.add({ segment, version });
67
65
  },
68
66
  /**
69
- * 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.
67
+ * Creates an A/B test.
70
68
  *
71
- * @summary Create a test.
69
+ * @summary Create an A/B test.
72
70
  * @param addABTestsRequest - The addABTestsRequest object.
73
71
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
74
72
  */
@@ -79,8 +77,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
79
77
  if (!addABTestsRequest.name) {
80
78
  throw new Error('Parameter `addABTestsRequest.name` is required when calling `addABTests`.');
81
79
  }
82
- if (!addABTestsRequest.variant) {
83
- throw new Error('Parameter `addABTestsRequest.variant` is required when calling `addABTests`.');
80
+ if (!addABTestsRequest.variants) {
81
+ throw new Error('Parameter `addABTestsRequest.variants` is required when calling `addABTests`.');
84
82
  }
85
83
  if (!addABTestsRequest.endAt) {
86
84
  throw new Error('Parameter `addABTestsRequest.endAt` is required when calling `addABTests`.');
@@ -102,8 +100,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
102
100
  *
103
101
  * @summary Send requests to the Algolia REST API.
104
102
  * @param del - The del object.
105
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
106
- * @param del.parameters - Query parameters to be applied to the current query.
103
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
104
+ * @param del.parameters - Query parameters to apply to the current query.
107
105
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
108
106
  */
109
107
  del({ path, parameters }, requestOptions) {
@@ -122,11 +120,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
122
120
  return transporter.request(request, requestOptions);
123
121
  },
124
122
  /**
125
- * Delete a test.
123
+ * Delete an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
126
124
  *
127
- * @summary Delete a test.
125
+ * @summary Delete an A/B test.
128
126
  * @param deleteABTest - The deleteABTest object.
129
- * @param deleteABTest.id - The A/B test ID.
127
+ * @param deleteABTest.id - Unique A/B test ID.
130
128
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
131
129
  */
132
130
  deleteABTest({ id }, requestOptions) {
@@ -149,8 +147,8 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
149
147
  *
150
148
  * @summary Send requests to the Algolia REST API.
151
149
  * @param get - The get object.
152
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
153
- * @param get.parameters - Query parameters to be applied to the current query.
150
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
151
+ * @param get.parameters - Query parameters to apply to the current query.
154
152
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
155
153
  */
156
154
  get({ path, parameters }, requestOptions) {
@@ -169,11 +167,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
169
167
  return transporter.request(request, requestOptions);
170
168
  },
171
169
  /**
172
- * Returns metadata and metrics for an A/B test.
170
+ * 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).
173
171
  *
174
- * @summary Get a test.
172
+ * @summary Get A/B test details.
175
173
  * @param getABTest - The getABTest object.
176
- * @param getABTest.id - The A/B test ID.
174
+ * @param getABTest.id - Unique A/B test ID.
177
175
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
178
176
  */
179
177
  getABTest({ id }, requestOptions) {
@@ -192,14 +190,14 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
192
190
  return transporter.request(request, requestOptions);
193
191
  },
194
192
  /**
195
- * 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.
193
+ * List all A/B tests.
196
194
  *
197
- * @summary List all tests.
195
+ * @summary List all A/B tests.
198
196
  * @param listABTests - The listABTests object.
199
197
  * @param listABTests.offset - Position of the starting record. Used for paging. 0 is the first record.
200
- * @param listABTests.limit - Number of records to return. Limit is the size of the page.
201
- * @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.
202
- * @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.
198
+ * @param listABTests.limit - Number of records to return (page size).
199
+ * @param listABTests.indexPrefix - Only return A/B tests for indices starting with this prefix.
200
+ * @param listABTests.indexSuffix - Only return A/B tests for indices ending with this suffix.
203
201
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
204
202
  */
205
203
  listABTests({ offset, limit, indexPrefix, indexSuffix } = {}, requestOptions = undefined) {
@@ -231,9 +229,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
231
229
  *
232
230
  * @summary Send requests to the Algolia REST API.
233
231
  * @param post - The post object.
234
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
235
- * @param post.parameters - Query parameters to be applied to the current query.
236
- * @param post.body - The parameters to send with the custom request.
232
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
233
+ * @param post.parameters - Query parameters to apply to the current query.
234
+ * @param post.body - Parameters to send with the custom request.
237
235
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
238
236
  */
239
237
  post({ path, parameters, body }, requestOptions) {
@@ -257,9 +255,9 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
257
255
  *
258
256
  * @summary Send requests to the Algolia REST API.
259
257
  * @param put - The put object.
260
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
261
- * @param put.parameters - Query parameters to be applied to the current query.
262
- * @param put.body - The parameters to send with the custom request.
258
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
259
+ * @param put.parameters - Query parameters to apply to the current query.
260
+ * @param put.body - Parameters to send with the custom request.
263
261
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
264
262
  */
265
263
  put({ path, parameters, body }, requestOptions) {
@@ -279,11 +277,11 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
279
277
  return transporter.request(request, requestOptions);
280
278
  },
281
279
  /**
282
- * 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.
280
+ * 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).
283
281
  *
284
- * @summary Stop a test.
282
+ * @summary Stop an A/B test.
285
283
  * @param stopABTest - The stopABTest object.
286
- * @param stopABTest.id - The A/B test ID.
284
+ * @param stopABTest.id - Unique A/B test ID.
287
285
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
288
286
  */
289
287
  stopABTest({ id }, requestOptions) {
@@ -305,7 +303,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
305
303
  }
306
304
 
307
305
  // 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.
308
- const apiClientVersion$3 = '5.0.0-alpha.72';
306
+ const apiClientVersion$3 = '5.0.0-alpha.75';
309
307
  const REGIONS$1 = ['de', 'us'];
310
308
  function getDefaultHosts$2(region) {
311
309
  const url = !region
@@ -369,8 +367,8 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
369
367
  *
370
368
  * @summary Send requests to the Algolia REST API.
371
369
  * @param del - The del object.
372
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
373
- * @param del.parameters - Query parameters to be applied to the current query.
370
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
371
+ * @param del.parameters - Query parameters to apply to the current query.
374
372
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
375
373
  */
376
374
  del({ path, parameters }, requestOptions) {
@@ -393,8 +391,8 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
393
391
  *
394
392
  * @summary Send requests to the Algolia REST API.
395
393
  * @param get - The get object.
396
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
397
- * @param get.parameters - Query parameters to be applied to the current query.
394
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
395
+ * @param get.parameters - Query parameters to apply to the current query.
398
396
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
399
397
  */
400
398
  get({ path, parameters }, requestOptions) {
@@ -413,14 +411,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
413
411
  return transporter.request(request, requestOptions);
414
412
  },
415
413
  /**
416
- * Returns the average click position. The endpoint returns a value for the complete given time range, as well as a value per day.
414
+ * 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`.
417
415
  *
418
416
  * @summary Get average click position.
419
417
  * @param getAverageClickPosition - The getAverageClickPosition object.
420
- * @param getAverageClickPosition.index - The index name to target.
421
- * @param getAverageClickPosition.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
422
- * @param getAverageClickPosition.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
423
- * @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.
418
+ * @param getAverageClickPosition.index - Index name to target.
419
+ * @param getAverageClickPosition.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
420
+ * @param getAverageClickPosition.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
421
+ * @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.
424
422
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
425
423
  */
426
424
  getAverageClickPosition({ index, startDate, endDate, tags }, requestOptions) {
@@ -451,14 +449,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
451
449
  return transporter.request(request, requestOptions);
452
450
  },
453
451
  /**
454
- * 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.
452
+ * 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`.
455
453
  *
456
- * @summary Get clicks per positions.
454
+ * @summary Get click positions.
457
455
  * @param getClickPositions - The getClickPositions object.
458
- * @param getClickPositions.index - The index name to target.
459
- * @param getClickPositions.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
460
- * @param getClickPositions.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
461
- * @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.
456
+ * @param getClickPositions.index - Index name to target.
457
+ * @param getClickPositions.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
458
+ * @param getClickPositions.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
459
+ * @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.
462
460
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
463
461
  */
464
462
  getClickPositions({ index, startDate, endDate, tags }, requestOptions) {
@@ -489,14 +487,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
489
487
  return transporter.request(request, requestOptions);
490
488
  },
491
489
  /**
492
- * 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.
490
+ * Returns a [click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
493
491
  *
494
492
  * @summary Get click-through rate (CTR).
495
493
  * @param getClickThroughRate - The getClickThroughRate object.
496
- * @param getClickThroughRate.index - The index name to target.
497
- * @param getClickThroughRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
498
- * @param getClickThroughRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
499
- * @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.
494
+ * @param getClickThroughRate.index - Index name to target.
495
+ * @param getClickThroughRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
496
+ * @param getClickThroughRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
497
+ * @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.
500
498
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
501
499
  */
502
500
  getClickThroughRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -527,14 +525,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
527
525
  return transporter.request(request, requestOptions);
528
526
  },
529
527
  /**
530
- * 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.
528
+ * Return a [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
531
529
  *
532
530
  * @summary Get conversion rate (CR).
533
531
  * @param getConversationRate - The getConversationRate object.
534
- * @param getConversationRate.index - The index name to target.
535
- * @param getConversationRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
536
- * @param getConversationRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
537
- * @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.
532
+ * @param getConversationRate.index - Index name to target.
533
+ * @param getConversationRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
534
+ * @param getConversationRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
535
+ * @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.
538
536
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
539
537
  */
540
538
  getConversationRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -565,14 +563,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
565
563
  return transporter.request(request, requestOptions);
566
564
  },
567
565
  /**
568
- * 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.
566
+ * 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.
569
567
  *
570
568
  * @summary Get no click rate.
571
569
  * @param getNoClickRate - The getNoClickRate object.
572
- * @param getNoClickRate.index - The index name to target.
573
- * @param getNoClickRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
574
- * @param getNoClickRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
575
- * @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.
570
+ * @param getNoClickRate.index - Index name to target.
571
+ * @param getNoClickRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
572
+ * @param getNoClickRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
573
+ * @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.
576
574
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
577
575
  */
578
576
  getNoClickRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -603,14 +601,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
603
601
  return transporter.request(request, requestOptions);
604
602
  },
605
603
  /**
606
- * 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.
604
+ * Returns the rate at which searches didn\'t return any results.
607
605
  *
608
606
  * @summary Get no results rate.
609
607
  * @param getNoResultsRate - The getNoResultsRate object.
610
- * @param getNoResultsRate.index - The index name to target.
611
- * @param getNoResultsRate.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
612
- * @param getNoResultsRate.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
613
- * @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.
608
+ * @param getNoResultsRate.index - Index name to target.
609
+ * @param getNoResultsRate.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
610
+ * @param getNoResultsRate.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
611
+ * @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.
614
612
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
615
613
  */
616
614
  getNoResultsRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -641,14 +639,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
641
639
  return transporter.request(request, requestOptions);
642
640
  },
643
641
  /**
644
- * 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.
642
+ * Returns the number of searches within a time range.
645
643
  *
646
- * @summary Get searches count.
644
+ * @summary Get number of searches.
647
645
  * @param getSearchesCount - The getSearchesCount object.
648
- * @param getSearchesCount.index - The index name to target.
649
- * @param getSearchesCount.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
650
- * @param getSearchesCount.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
651
- * @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.
646
+ * @param getSearchesCount.index - Index name to target.
647
+ * @param getSearchesCount.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
648
+ * @param getSearchesCount.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
649
+ * @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.
652
650
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
653
651
  */
654
652
  getSearchesCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -679,16 +677,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
679
677
  return transporter.request(request, requestOptions);
680
678
  },
681
679
  /**
682
- * 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.
680
+ * Return the most popular of the last 1,000 searches that didn\'t lead to any clicks.
683
681
  *
684
682
  * @summary Get top searches with no clicks.
685
683
  * @param getSearchesNoClicks - The getSearchesNoClicks object.
686
- * @param getSearchesNoClicks.index - The index name to target.
687
- * @param getSearchesNoClicks.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
688
- * @param getSearchesNoClicks.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
689
- * @param getSearchesNoClicks.limit - Number of records to return. Limit is the size of the page.
684
+ * @param getSearchesNoClicks.index - Index name to target.
685
+ * @param getSearchesNoClicks.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
686
+ * @param getSearchesNoClicks.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
687
+ * @param getSearchesNoClicks.limit - Number of records to return (page size).
690
688
  * @param getSearchesNoClicks.offset - Position of the starting record. Used for paging. 0 is the first record.
691
- * @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.
689
+ * @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.
692
690
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
693
691
  */
694
692
  getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -725,16 +723,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
725
723
  return transporter.request(request, requestOptions);
726
724
  },
727
725
  /**
728
- * Returns top searches that didn\'t return any results. Limited to the 1000 most frequent ones.
726
+ * Returns the most popular of the latest 1,000 searches that didn\'t return any results.
729
727
  *
730
728
  * @summary Get top searches with no results.
731
729
  * @param getSearchesNoResults - The getSearchesNoResults object.
732
- * @param getSearchesNoResults.index - The index name to target.
733
- * @param getSearchesNoResults.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
734
- * @param getSearchesNoResults.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
735
- * @param getSearchesNoResults.limit - Number of records to return. Limit is the size of the page.
730
+ * @param getSearchesNoResults.index - Index name to target.
731
+ * @param getSearchesNoResults.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
732
+ * @param getSearchesNoResults.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
733
+ * @param getSearchesNoResults.limit - Number of records to return (page size).
736
734
  * @param getSearchesNoResults.offset - Position of the starting record. Used for paging. 0 is the first record.
737
- * @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.
735
+ * @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.
738
736
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
739
737
  */
740
738
  getSearchesNoResults({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -771,11 +769,11 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
771
769
  return transporter.request(request, requestOptions);
772
770
  },
773
771
  /**
774
- * 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.
772
+ * 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.
775
773
  *
776
774
  * @summary Get Analytics API status.
777
775
  * @param getStatus - The getStatus object.
778
- * @param getStatus.index - The index name to target.
776
+ * @param getStatus.index - Index name to target.
779
777
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
780
778
  */
781
779
  getStatus({ index }, requestOptions) {
@@ -797,16 +795,16 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
797
795
  return transporter.request(request, requestOptions);
798
796
  },
799
797
  /**
800
- * Returns top countries. Limited to the 1000 most frequent ones.
798
+ * Returns top countries. Limited to the 1,000 most frequent ones.
801
799
  *
802
800
  * @summary Get top countries.
803
801
  * @param getTopCountries - The getTopCountries object.
804
- * @param getTopCountries.index - The index name to target.
805
- * @param getTopCountries.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
806
- * @param getTopCountries.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
807
- * @param getTopCountries.limit - Number of records to return. Limit is the size of the page.
802
+ * @param getTopCountries.index - Index name to target.
803
+ * @param getTopCountries.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
804
+ * @param getTopCountries.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
805
+ * @param getTopCountries.limit - Number of records to return (page size).
808
806
  * @param getTopCountries.offset - Position of the starting record. Used for paging. 0 is the first record.
809
- * @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.
807
+ * @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.
810
808
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
811
809
  */
812
810
  getTopCountries({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
@@ -843,17 +841,17 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
843
841
  return transporter.request(request, requestOptions);
844
842
  },
845
843
  /**
846
- * Returns top filter attributes. Limited to the 1000 most used filters.
844
+ * 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.
847
845
  *
848
- * @summary Get top filter attributes.
846
+ * @summary Get top filterable attributes.
849
847
  * @param getTopFilterAttributes - The getTopFilterAttributes object.
850
- * @param getTopFilterAttributes.index - The index name to target.
851
- * @param getTopFilterAttributes.search - The query term to search for. Must match the exact user input.
852
- * @param getTopFilterAttributes.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
853
- * @param getTopFilterAttributes.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
854
- * @param getTopFilterAttributes.limit - Number of records to return. Limit is the size of the page.
848
+ * @param getTopFilterAttributes.index - Index name to target.
849
+ * @param getTopFilterAttributes.search - User query.
850
+ * @param getTopFilterAttributes.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
851
+ * @param getTopFilterAttributes.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
852
+ * @param getTopFilterAttributes.limit - Number of records to return (page size).
855
853
  * @param getTopFilterAttributes.offset - Position of the starting record. Used for paging. 0 is the first record.
856
- * @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.
854
+ * @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.
857
855
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
858
856
  */
859
857
  getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -893,18 +891,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
893
891
  return transporter.request(request, requestOptions);
894
892
  },
895
893
  /**
896
- * Returns top filters for the given attribute. Limited to the 1000 most used filters.
894
+ * Returns the most popular filter values for an attribute in the 1,000 most recently used filters.
897
895
  *
898
- * @summary Get top filters for the an attribute.
896
+ * @summary Get top filter values for an attribute.
899
897
  * @param getTopFilterForAttribute - The getTopFilterForAttribute object.
900
- * @param getTopFilterForAttribute.attribute - The exact name of the attribute.
901
- * @param getTopFilterForAttribute.index - The index name to target.
902
- * @param getTopFilterForAttribute.search - The query term to search for. Must match the exact user input.
903
- * @param getTopFilterForAttribute.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
904
- * @param getTopFilterForAttribute.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
905
- * @param getTopFilterForAttribute.limit - Number of records to return. Limit is the size of the page.
898
+ * @param getTopFilterForAttribute.attribute - Attribute name.
899
+ * @param getTopFilterForAttribute.index - Index name to target.
900
+ * @param getTopFilterForAttribute.search - User query.
901
+ * @param getTopFilterForAttribute.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
902
+ * @param getTopFilterForAttribute.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
903
+ * @param getTopFilterForAttribute.limit - Number of records to return (page size).
906
904
  * @param getTopFilterForAttribute.offset - Position of the starting record. Used for paging. 0 is the first record.
907
- * @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.
905
+ * @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.
908
906
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
909
907
  */
910
908
  getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -947,17 +945,17 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
947
945
  return transporter.request(request, requestOptions);
948
946
  },
949
947
  /**
950
- * Returns top filters with no results. Limited to the 1000 most used filters.
948
+ * Returns top filters for filter-enabled searches that don\'t return results. Limited to the 1,000 most recently used filters.
951
949
  *
952
950
  * @summary Get top filters for a no result search.
953
951
  * @param getTopFiltersNoResults - The getTopFiltersNoResults object.
954
- * @param getTopFiltersNoResults.index - The index name to target.
955
- * @param getTopFiltersNoResults.search - The query term to search for. Must match the exact user input.
956
- * @param getTopFiltersNoResults.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
957
- * @param getTopFiltersNoResults.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
958
- * @param getTopFiltersNoResults.limit - Number of records to return. Limit is the size of the page.
952
+ * @param getTopFiltersNoResults.index - Index name to target.
953
+ * @param getTopFiltersNoResults.search - User query.
954
+ * @param getTopFiltersNoResults.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
955
+ * @param getTopFiltersNoResults.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
956
+ * @param getTopFiltersNoResults.limit - Number of records to return (page size).
959
957
  * @param getTopFiltersNoResults.offset - Position of the starting record. Used for paging. 0 is the first record.
960
- * @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.
958
+ * @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.
961
959
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
962
960
  */
963
961
  getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -997,18 +995,18 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
997
995
  return transporter.request(request, requestOptions);
998
996
  },
999
997
  /**
1000
- * Returns top hits. Limited to the 1000 most frequent ones.
998
+ * Return the most popular clicked results in the last 1,000 searches.
1001
999
  *
1002
1000
  * @summary Get top hits.
1003
1001
  * @param getTopHits - The getTopHits object.
1004
- * @param getTopHits.index - The index name to target.
1005
- * @param getTopHits.search - The query term to search for. Must match the exact user input.
1006
- * @param getTopHits.clickAnalytics - Whether to include the click-through and conversion rates for a search.
1007
- * @param getTopHits.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1008
- * @param getTopHits.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1009
- * @param getTopHits.limit - Number of records to return. Limit is the size of the page.
1002
+ * @param getTopHits.index - Index name to target.
1003
+ * @param getTopHits.search - User query.
1004
+ * @param getTopHits.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1005
+ * @param getTopHits.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1006
+ * @param getTopHits.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1007
+ * @param getTopHits.limit - Number of records to return (page size).
1010
1008
  * @param getTopHits.offset - Position of the starting record. Used for paging. 0 is the first record.
1011
- * @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.
1009
+ * @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.
1012
1010
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1013
1011
  */
1014
1012
  getTopHits({ index, search, clickAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1051,19 +1049,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1051
1049
  return transporter.request(request, requestOptions);
1052
1050
  },
1053
1051
  /**
1054
- * Returns top searches. Limited to the 1000 most frequent ones. For each search, also returns the average number of hits returned.
1052
+ * Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.
1055
1053
  *
1056
1054
  * @summary Get top searches.
1057
1055
  * @param getTopSearches - The getTopSearches object.
1058
- * @param getTopSearches.index - The index name to target.
1059
- * @param getTopSearches.clickAnalytics - Whether to include the click-through and conversion rates for a search.
1060
- * @param getTopSearches.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1061
- * @param getTopSearches.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1056
+ * @param getTopSearches.index - Index name to target.
1057
+ * @param getTopSearches.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1058
+ * @param getTopSearches.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1059
+ * @param getTopSearches.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1062
1060
  * @param getTopSearches.orderBy - Reorder the results.
1063
- * @param getTopSearches.direction - The sorting of the result.
1064
- * @param getTopSearches.limit - Number of records to return. Limit is the size of the page.
1061
+ * @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
1062
+ * @param getTopSearches.limit - Number of records to return (page size).
1065
1063
  * @param getTopSearches.offset - Position of the starting record. Used for paging. 0 is the first record.
1066
- * @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.
1064
+ * @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.
1067
1065
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1068
1066
  */
1069
1067
  getTopSearches({ index, clickAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
@@ -1109,14 +1107,14 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1109
1107
  return transporter.request(request, requestOptions);
1110
1108
  },
1111
1109
  /**
1112
- * 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.
1110
+ * Return the count of unique users.
1113
1111
  *
1114
- * @summary Get users count.
1112
+ * @summary Get user count.
1115
1113
  * @param getUsersCount - The getUsersCount object.
1116
- * @param getUsersCount.index - The index name to target.
1117
- * @param getUsersCount.startDate - The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1118
- * @param getUsersCount.endDate - The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
1119
- * @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.
1114
+ * @param getUsersCount.index - Index name to target.
1115
+ * @param getUsersCount.startDate - Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1116
+ * @param getUsersCount.endDate - End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
1117
+ * @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.
1120
1118
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1121
1119
  */
1122
1120
  getUsersCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -1151,9 +1149,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1151
1149
  *
1152
1150
  * @summary Send requests to the Algolia REST API.
1153
1151
  * @param post - The post object.
1154
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1155
- * @param post.parameters - Query parameters to be applied to the current query.
1156
- * @param post.body - The parameters to send with the custom request.
1152
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
1153
+ * @param post.parameters - Query parameters to apply to the current query.
1154
+ * @param post.body - Parameters to send with the custom request.
1157
1155
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1158
1156
  */
1159
1157
  post({ path, parameters, body }, requestOptions) {
@@ -1177,9 +1175,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1177
1175
  *
1178
1176
  * @summary Send requests to the Algolia REST API.
1179
1177
  * @param put - The put object.
1180
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1181
- * @param put.parameters - Query parameters to be applied to the current query.
1182
- * @param put.body - The parameters to send with the custom request.
1178
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
1179
+ * @param put.parameters - Query parameters to apply to the current query.
1180
+ * @param put.body - Parameters to send with the custom request.
1183
1181
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1184
1182
  */
1185
1183
  put({ path, parameters, body }, requestOptions) {
@@ -1202,7 +1200,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1202
1200
  }
1203
1201
 
1204
1202
  // 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.
1205
- const apiClientVersion$2 = '5.0.0-alpha.72';
1203
+ const apiClientVersion$2 = '5.0.0-alpha.75';
1206
1204
  const REGIONS = ['eu', 'us'];
1207
1205
  function getDefaultHosts$1(region) {
1208
1206
  const url = 'personalization.{region}.algolia.com'.replace('{region}', region);
@@ -1264,8 +1262,8 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1264
1262
  *
1265
1263
  * @summary Send requests to the Algolia REST API.
1266
1264
  * @param del - The del object.
1267
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1268
- * @param del.parameters - Query parameters to be applied to the current query.
1265
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
1266
+ * @param del.parameters - Query parameters to apply to the current query.
1269
1267
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1270
1268
  */
1271
1269
  del({ path, parameters }, requestOptions) {
@@ -1311,8 +1309,8 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1311
1309
  *
1312
1310
  * @summary Send requests to the Algolia REST API.
1313
1311
  * @param get - The get object.
1314
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1315
- * @param get.parameters - Query parameters to be applied to the current query.
1312
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
1313
+ * @param get.parameters - Query parameters to apply to the current query.
1316
1314
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1317
1315
  */
1318
1316
  get({ path, parameters }, requestOptions) {
@@ -1376,9 +1374,9 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1376
1374
  *
1377
1375
  * @summary Send requests to the Algolia REST API.
1378
1376
  * @param post - The post object.
1379
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1380
- * @param post.parameters - Query parameters to be applied to the current query.
1381
- * @param post.body - The parameters to send with the custom request.
1377
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
1378
+ * @param post.parameters - Query parameters to apply to the current query.
1379
+ * @param post.body - Parameters to send with the custom request.
1382
1380
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1383
1381
  */
1384
1382
  post({ path, parameters, body }, requestOptions) {
@@ -1402,9 +1400,9 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1402
1400
  *
1403
1401
  * @summary Send requests to the Algolia REST API.
1404
1402
  * @param put - The put object.
1405
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
1406
- * @param put.parameters - Query parameters to be applied to the current query.
1407
- * @param put.body - The parameters to send with the custom request.
1403
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
1404
+ * @param put.parameters - Query parameters to apply to the current query.
1405
+ * @param put.body - Parameters to send with the custom request.
1408
1406
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1409
1407
  */
1410
1408
  put({ path, parameters, body }, requestOptions) {
@@ -1459,7 +1457,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1459
1457
  }
1460
1458
 
1461
1459
  // 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.
1462
- const apiClientVersion$1 = '5.0.0-alpha.72';
1460
+ const apiClientVersion$1 = '5.0.0-alpha.75';
1463
1461
  function getDefaultHosts(appId) {
1464
1462
  return [
1465
1463
  {
@@ -1706,9 +1704,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1706
1704
  });
1707
1705
  },
1708
1706
  /**
1709
- * Add a new API Key with specific permissions/restrictions.
1707
+ * 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.
1710
1708
  *
1711
- * @summary Create an API key.
1709
+ * @summary Add API key.
1712
1710
  * @param apiKey - The apiKey object.
1713
1711
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1714
1712
  */
@@ -1732,13 +1730,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1732
1730
  return transporter.request(request, requestOptions);
1733
1731
  },
1734
1732
  /**
1735
- * 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.
1733
+ * 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).
1736
1734
  *
1737
- * @summary Add or replace an object.
1735
+ * @summary Add or update a record (using objectID).
1738
1736
  * @param addOrUpdateObject - The addOrUpdateObject object.
1739
- * @param addOrUpdateObject.indexName - The index in which to perform the request.
1740
- * @param addOrUpdateObject.objectID - Unique identifier of an object.
1741
- * @param addOrUpdateObject.body - The Algolia object.
1737
+ * @param addOrUpdateObject.indexName - Index on which to perform the request.
1738
+ * @param addOrUpdateObject.objectID - Unique record (object) identifier.
1739
+ * @param addOrUpdateObject.body - Algolia record.
1742
1740
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1743
1741
  */
1744
1742
  addOrUpdateObject({ indexName, objectID, body }, requestOptions) {
@@ -1766,10 +1764,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1766
1764
  return transporter.request(request, requestOptions);
1767
1765
  },
1768
1766
  /**
1769
- * Add a single source to the list of allowed sources.
1767
+ * Add a source to the list of allowed sources.
1770
1768
  *
1771
- * @summary Add a single source.
1772
- * @param source - The source to add.
1769
+ * @summary Add a source.
1770
+ * @param source - Source to add.
1773
1771
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1774
1772
  */
1775
1773
  appendSource(source, requestOptions) {
@@ -1792,9 +1790,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1792
1790
  return transporter.request(request, requestOptions);
1793
1791
  },
1794
1792
  /**
1795
- * 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.
1793
+ * 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.
1796
1794
  *
1797
- * @summary Assign or Move userID.
1795
+ * @summary Assign or move a user ID.
1798
1796
  * @param assignUserId - The assignUserId object.
1799
1797
  * @param assignUserId.xAlgoliaUserID - UserID to assign.
1800
1798
  * @param assignUserId.assignUserIdParams - The assignUserIdParams object.
@@ -1826,11 +1824,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1826
1824
  return transporter.request(request, requestOptions);
1827
1825
  },
1828
1826
  /**
1829
- * Perform multiple write operations targeting one index, in a single API call.
1827
+ * 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.
1830
1828
  *
1831
- * @summary Batch operations to one index.
1829
+ * @summary Batch write operations on one index.
1832
1830
  * @param batch - The batch object.
1833
- * @param batch.indexName - The index in which to perform the request.
1831
+ * @param batch.indexName - Index on which to perform the request.
1834
1832
  * @param batch.batchWriteParams - The batchWriteParams object.
1835
1833
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1836
1834
  */
@@ -1857,7 +1855,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1857
1855
  return transporter.request(request, requestOptions);
1858
1856
  },
1859
1857
  /**
1860
- * 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.
1858
+ * Assign multiple user IDs to a cluster. **You can\'t _move_ users with this operation.**.
1861
1859
  *
1862
1860
  * @summary Batch assign userIDs.
1863
1861
  * @param batchAssignUserIds - The batchAssignUserIds object.
@@ -1894,11 +1892,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1894
1892
  return transporter.request(request, requestOptions);
1895
1893
  },
1896
1894
  /**
1897
- * Send a batch of dictionary entries.
1895
+ * Add or remove a batch of dictionary entries.
1898
1896
  *
1899
1897
  * @summary Batch dictionary entries.
1900
1898
  * @param batchDictionaryEntries - The batchDictionaryEntries object.
1901
- * @param batchDictionaryEntries.dictionaryName - The dictionary to search in.
1899
+ * @param batchDictionaryEntries.dictionaryName - Dictionary to search in.
1902
1900
  * @param batchDictionaryEntries.batchDictionaryEntriesParams - The batchDictionaryEntriesParams object.
1903
1901
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1904
1902
  */
@@ -1925,11 +1923,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1925
1923
  return transporter.request(request, requestOptions);
1926
1924
  },
1927
1925
  /**
1928
- * 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.
1926
+ * 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.
1929
1927
  *
1930
- * @summary Retrieve all index content.
1928
+ * @summary Get all records from an index.
1931
1929
  * @param browse - The browse object.
1932
- * @param browse.indexName - The index in which to perform the request.
1930
+ * @param browse.indexName - Index on which to perform the request.
1933
1931
  * @param browse.browseParams - The browseParams object.
1934
1932
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1935
1933
  */
@@ -1950,12 +1948,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1950
1948
  return transporter.request(request, requestOptions);
1951
1949
  },
1952
1950
  /**
1953
- * Remove all synonyms from an index.
1951
+ * Delete all synonyms in the index.
1954
1952
  *
1955
- * @summary Clear all synonyms.
1953
+ * @summary Delete all synonyms.
1956
1954
  * @param clearAllSynonyms - The clearAllSynonyms object.
1957
- * @param clearAllSynonyms.indexName - The index in which to perform the request.
1958
- * @param clearAllSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
1955
+ * @param clearAllSynonyms.indexName - Index on which to perform the request.
1956
+ * @param clearAllSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
1959
1957
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1960
1958
  */
1961
1959
  clearAllSynonyms({ indexName, forwardToReplicas }, requestOptions) {
@@ -1977,11 +1975,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
1977
1975
  return transporter.request(request, requestOptions);
1978
1976
  },
1979
1977
  /**
1980
- * Delete an index\'s content, but leave settings and index-specific API keys untouched.
1978
+ * Delete the records but leave settings and index-specific API keys untouched.
1981
1979
  *
1982
- * @summary Clear all objects from an index.
1980
+ * @summary Delete all records from an index.
1983
1981
  * @param clearObjects - The clearObjects object.
1984
- * @param clearObjects.indexName - The index in which to perform the request.
1982
+ * @param clearObjects.indexName - Index on which to perform the request.
1985
1983
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1986
1984
  */
1987
1985
  clearObjects({ indexName }, requestOptions) {
@@ -2000,12 +1998,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2000
1998
  return transporter.request(request, requestOptions);
2001
1999
  },
2002
2000
  /**
2003
- * Delete all Rules in the index.
2001
+ * Delete all rules in the index.
2004
2002
  *
2005
- * @summary Clear Rules.
2003
+ * @summary Delete all rules.
2006
2004
  * @param clearRules - The clearRules object.
2007
- * @param clearRules.indexName - The index in which to perform the request.
2008
- * @param clearRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2005
+ * @param clearRules.indexName - Index on which to perform the request.
2006
+ * @param clearRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2009
2007
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2010
2008
  */
2011
2009
  clearRules({ indexName, forwardToReplicas }, requestOptions) {
@@ -2031,8 +2029,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2031
2029
  *
2032
2030
  * @summary Send requests to the Algolia REST API.
2033
2031
  * @param del - The del object.
2034
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2035
- * @param del.parameters - Query parameters to be applied to the current query.
2032
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
2033
+ * @param del.parameters - Query parameters to apply to the current query.
2036
2034
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2037
2035
  */
2038
2036
  del({ path, parameters }, requestOptions) {
@@ -2051,11 +2049,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2051
2049
  return transporter.request(request, requestOptions);
2052
2050
  },
2053
2051
  /**
2054
- * Delete an existing API Key.
2052
+ * Delete an existing API key. The request must be authenticated with the admin API key.
2055
2053
  *
2056
- * @summary Delete an API key.
2054
+ * @summary Delete API key.
2057
2055
  * @param deleteApiKey - The deleteApiKey object.
2058
- * @param deleteApiKey.key - API Key string.
2056
+ * @param deleteApiKey.key - API key.
2059
2057
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2060
2058
  */
2061
2059
  deleteApiKey({ key }, requestOptions) {
@@ -2074,11 +2072,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2074
2072
  return transporter.request(request, requestOptions);
2075
2073
  },
2076
2074
  /**
2077
- * 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.
2075
+ * 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.
2078
2076
  *
2079
- * @summary Delete all records matching the query.
2077
+ * @summary Delete all records matching a query.
2080
2078
  * @param deleteBy - The deleteBy object.
2081
- * @param deleteBy.indexName - The index in which to perform the request.
2079
+ * @param deleteBy.indexName - Index on which to perform the request.
2082
2080
  * @param deleteBy.deleteByParams - The deleteByParams object.
2083
2081
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2084
2082
  */
@@ -2106,7 +2104,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2106
2104
  *
2107
2105
  * @summary Delete index.
2108
2106
  * @param deleteIndex - The deleteIndex object.
2109
- * @param deleteIndex.indexName - The index in which to perform the request.
2107
+ * @param deleteIndex.indexName - Index on which to perform the request.
2110
2108
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2111
2109
  */
2112
2110
  deleteIndex({ indexName }, requestOptions) {
@@ -2125,12 +2123,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2125
2123
  return transporter.request(request, requestOptions);
2126
2124
  },
2127
2125
  /**
2128
- * Delete an existing object.
2126
+ * To delete a set of records matching a query, use the [`deleteByQuery` operation](#tag/Records/operation/deleteBy) instead.
2129
2127
  *
2130
- * @summary Delete an object.
2128
+ * @summary Delete a record.
2131
2129
  * @param deleteObject - The deleteObject object.
2132
- * @param deleteObject.indexName - The index in which to perform the request.
2133
- * @param deleteObject.objectID - Unique identifier of an object.
2130
+ * @param deleteObject.indexName - Index on which to perform the request.
2131
+ * @param deleteObject.objectID - Unique record (object) identifier.
2134
2132
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2135
2133
  */
2136
2134
  deleteObject({ indexName, objectID }, requestOptions) {
@@ -2154,13 +2152,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2154
2152
  return transporter.request(request, requestOptions);
2155
2153
  },
2156
2154
  /**
2157
- * Delete the Rule with the specified objectID.
2155
+ * Delete a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
2158
2156
  *
2159
2157
  * @summary Delete a rule.
2160
2158
  * @param deleteRule - The deleteRule object.
2161
- * @param deleteRule.indexName - The index in which to perform the request.
2162
- * @param deleteRule.objectID - Unique identifier of an object.
2163
- * @param deleteRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2159
+ * @param deleteRule.indexName - Index on which to perform the request.
2160
+ * @param deleteRule.objectID - Unique identifier of a rule object.
2161
+ * @param deleteRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2164
2162
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2165
2163
  */
2166
2164
  deleteRule({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -2187,11 +2185,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2187
2185
  return transporter.request(request, requestOptions);
2188
2186
  },
2189
2187
  /**
2190
- * Remove a single source from the list of allowed sources.
2188
+ * Remove a source from the list of allowed sources.
2191
2189
  *
2192
- * @summary Remove a single source.
2190
+ * @summary Remove a source.
2193
2191
  * @param deleteSource - The deleteSource object.
2194
- * @param deleteSource.source - The IP range of the source.
2192
+ * @param deleteSource.source - IP address range of the source.
2195
2193
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2196
2194
  */
2197
2195
  deleteSource({ source }, requestOptions) {
@@ -2210,13 +2208,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2210
2208
  return transporter.request(request, requestOptions);
2211
2209
  },
2212
2210
  /**
2213
- * Delete a single synonyms set, identified by the given objectID.
2211
+ * Delete a synonym by its `objectID`. To find the object IDs of your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
2214
2212
  *
2215
- * @summary Delete synonym.
2213
+ * @summary Delete a synonym.
2216
2214
  * @param deleteSynonym - The deleteSynonym object.
2217
- * @param deleteSynonym.indexName - The index in which to perform the request.
2218
- * @param deleteSynonym.objectID - Unique identifier of an object.
2219
- * @param deleteSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2215
+ * @param deleteSynonym.indexName - Index on which to perform the request.
2216
+ * @param deleteSynonym.objectID - Unique identifier of a synonym object.
2217
+ * @param deleteSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2220
2218
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2221
2219
  */
2222
2220
  deleteSynonym({ indexName, objectID, forwardToReplicas }, requestOptions) {
@@ -2247,8 +2245,8 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2247
2245
  *
2248
2246
  * @summary Send requests to the Algolia REST API.
2249
2247
  * @param get - The get object.
2250
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2251
- * @param get.parameters - Query parameters to be applied to the current query.
2248
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
2249
+ * @param get.parameters - Query parameters to apply to the current query.
2252
2250
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2253
2251
  */
2254
2252
  get({ path, parameters }, requestOptions) {
@@ -2267,11 +2265,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2267
2265
  return transporter.request(request, requestOptions);
2268
2266
  },
2269
2267
  /**
2270
- * Get the permissions of an API key.
2268
+ * 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.
2271
2269
  *
2272
- * @summary Get an API key.
2270
+ * @summary Get API key permissions.
2273
2271
  * @param getApiKey - The getApiKey object.
2274
- * @param getApiKey.key - API Key string.
2272
+ * @param getApiKey.key - API key.
2275
2273
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2276
2274
  */
2277
2275
  getApiKey({ key }, requestOptions) {
@@ -2290,7 +2288,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2290
2288
  return transporter.request(request, requestOptions);
2291
2289
  },
2292
2290
  /**
2293
- * List dictionaries supported per language.
2291
+ * 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.
2294
2292
  *
2295
2293
  * @summary List available languages.
2296
2294
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2308,9 +2306,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2308
2306
  return transporter.request(request, requestOptions);
2309
2307
  },
2310
2308
  /**
2311
- * Retrieve dictionaries settings. The API stores languages whose standard entries are disabled. Fetch settings does not return false values.
2309
+ * Get the languages for which [stop words are turned off](#tag/Dictionaries/operation/setDictionarySettings).
2312
2310
  *
2313
- * @summary Retrieve dictionaries settings.
2311
+ * @summary Get stop word settings.
2314
2312
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2315
2313
  */
2316
2314
  getDictionarySettings(requestOptions) {
@@ -2326,13 +2324,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2326
2324
  return transporter.request(request, requestOptions);
2327
2325
  },
2328
2326
  /**
2329
- * Return the latest log entries.
2327
+ * 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).
2330
2328
  *
2331
2329
  * @summary Return the latest log entries.
2332
2330
  * @param getLogs - The getLogs object.
2333
- * @param getLogs.offset - First entry to retrieve (zero-based). Log entries are sorted by decreasing date, therefore 0 designates the most recent log entry.
2334
- * @param getLogs.length - Maximum number of entries to retrieve. The maximum allowed value is 1000.
2335
- * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved across all indices.
2331
+ * @param getLogs.offset - First log entry to retrieve. Sorted by decreasing date with 0 being the most recent.
2332
+ * @param getLogs.length - Maximum number of entries to retrieve.
2333
+ * @param getLogs.indexName - Index for which log entries should be retrieved. When omitted, log entries are retrieved for all indices.
2336
2334
  * @param getLogs.type - Type of log entries to retrieve. When omitted, all log entries are retrieved.
2337
2335
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2338
2336
  */
@@ -2361,13 +2359,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2361
2359
  return transporter.request(request, requestOptions);
2362
2360
  },
2363
2361
  /**
2364
- * Retrieve one object from the index.
2362
+ * To get more than one record, use the [`objects` operation](#tag/Records/operation/getObjects).
2365
2363
  *
2366
- * @summary Retrieve an object.
2364
+ * @summary Get a record.
2367
2365
  * @param getObject - The getObject object.
2368
- * @param getObject.indexName - The index in which to perform the request.
2369
- * @param getObject.objectID - Unique identifier of an object.
2370
- * @param getObject.attributesToRetrieve - List of attributes to retrieve. If not specified, all retrievable attributes are returned.
2366
+ * @param getObject.indexName - Index on which to perform the request.
2367
+ * @param getObject.objectID - Unique record (object) identifier.
2368
+ * @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.
2371
2369
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2372
2370
  */
2373
2371
  getObject({ indexName, objectID, attributesToRetrieve }, requestOptions) {
@@ -2394,10 +2392,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2394
2392
  return transporter.request(request, requestOptions);
2395
2393
  },
2396
2394
  /**
2397
- * Retrieve one or more objects, potentially from different indices, in a single API call.
2395
+ * 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.
2398
2396
  *
2399
- * @summary Retrieve one or more objects.
2400
- * @param getObjectsParams - The Algolia object.
2397
+ * @summary Get multiple records.
2398
+ * @param getObjectsParams - Request object.
2401
2399
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2402
2400
  */
2403
2401
  getObjects(getObjectsParams, requestOptions) {
@@ -2422,12 +2420,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2422
2420
  return transporter.request(request, requestOptions);
2423
2421
  },
2424
2422
  /**
2425
- * Retrieve the Rule with the specified objectID.
2423
+ * Get a rule by its `objectID`. To find the `objectID` for rules, use the [`search` operation](#tag/Rules/operation/searchRules).
2426
2424
  *
2427
2425
  * @summary Get a rule.
2428
2426
  * @param getRule - The getRule object.
2429
- * @param getRule.indexName - The index in which to perform the request.
2430
- * @param getRule.objectID - Unique identifier of an object.
2427
+ * @param getRule.indexName - Index on which to perform the request.
2428
+ * @param getRule.objectID - Unique identifier of a rule object.
2431
2429
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2432
2430
  */
2433
2431
  getRule({ indexName, objectID }, requestOptions) {
@@ -2451,11 +2449,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2451
2449
  return transporter.request(request, requestOptions);
2452
2450
  },
2453
2451
  /**
2454
- * Retrieve settings of an index.
2452
+ * Return an object containing an index\'s [configuration settings](https://www.algolia.com/doc/api-reference/settings-api-parameters/).
2455
2453
  *
2456
- * @summary Retrieve settings of an index.
2454
+ * @summary Get index settings.
2457
2455
  * @param getSettings - The getSettings object.
2458
- * @param getSettings.indexName - The index in which to perform the request.
2456
+ * @param getSettings.indexName - Index on which to perform the request.
2459
2457
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2460
2458
  */
2461
2459
  getSettings({ indexName }, requestOptions) {
@@ -2474,9 +2472,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2474
2472
  return transporter.request(request, requestOptions);
2475
2473
  },
2476
2474
  /**
2477
- * List all allowed sources.
2475
+ * Get all allowed sources (IP addresses).
2478
2476
  *
2479
- * @summary List all allowed sources.
2477
+ * @summary Get all allowed IP addresses.
2480
2478
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2481
2479
  */
2482
2480
  getSources(requestOptions) {
@@ -2492,12 +2490,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2492
2490
  return transporter.request(request, requestOptions);
2493
2491
  },
2494
2492
  /**
2495
- * Fetch a synonym object identified by its objectID.
2493
+ * Get a syonym by its `objectID`. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
2496
2494
  *
2497
- * @summary Get synonym.
2495
+ * @summary Get a synonym object.
2498
2496
  * @param getSynonym - The getSynonym object.
2499
- * @param getSynonym.indexName - The index in which to perform the request.
2500
- * @param getSynonym.objectID - Unique identifier of an object.
2497
+ * @param getSynonym.indexName - Index on which to perform the request.
2498
+ * @param getSynonym.objectID - Unique identifier of a synonym object.
2501
2499
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2502
2500
  */
2503
2501
  getSynonym({ indexName, objectID }, requestOptions) {
@@ -2521,12 +2519,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2521
2519
  return transporter.request(request, requestOptions);
2522
2520
  },
2523
2521
  /**
2524
- * Check the current status of a given task.
2522
+ * Some operations, such as copying an index, will respond with a `taskID` value. Use this value here to check the status of that task.
2525
2523
  *
2526
- * @summary Check the status of a task.
2524
+ * @summary Check a task\'s status.
2527
2525
  * @param getTask - The getTask object.
2528
- * @param getTask.indexName - The index in which to perform the request.
2529
- * @param getTask.taskID - Unique identifier of an task. Numeric value (up to 64bits).
2526
+ * @param getTask.indexName - Index on which to perform the request.
2527
+ * @param getTask.taskID - Unique task identifier.
2530
2528
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2531
2529
  */
2532
2530
  getTask({ indexName, taskID }, requestOptions) {
@@ -2550,7 +2548,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2550
2548
  return transporter.request(request, requestOptions);
2551
2549
  },
2552
2550
  /**
2553
- * 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.
2551
+ * 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.
2554
2552
  *
2555
2553
  * @summary Get top userID.
2556
2554
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2568,7 +2566,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2568
2566
  return transporter.request(request, requestOptions);
2569
2567
  },
2570
2568
  /**
2571
- * 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.
2569
+ * 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.
2572
2570
  *
2573
2571
  * @summary Get userID.
2574
2572
  * @param getUserId - The getUserId object.
@@ -2591,11 +2589,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2591
2589
  return transporter.request(request, requestOptions);
2592
2590
  },
2593
2591
  /**
2594
- * 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.
2592
+ * 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.
2595
2593
  *
2596
- * @summary Get migration status.
2594
+ * @summary Get migration and user mapping status.
2597
2595
  * @param hasPendingMappings - The hasPendingMappings object.
2598
- * @param hasPendingMappings.getClusters - If the clusters pending mapping state should be on the response.
2596
+ * @param hasPendingMappings.getClusters - Indicates whether to include the cluster\'s pending mapping state in the response.
2599
2597
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2600
2598
  */
2601
2599
  hasPendingMappings({ getClusters } = {}, requestOptions = undefined) {
@@ -2614,9 +2612,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2614
2612
  return transporter.request(request, requestOptions);
2615
2613
  },
2616
2614
  /**
2617
- * List API keys, along with their associated rights.
2615
+ * List all API keys associated with your Algolia application, including their permissions and restrictions.
2618
2616
  *
2619
- * @summary List API Keys.
2617
+ * @summary List API keys.
2620
2618
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2621
2619
  */
2622
2620
  listApiKeys(requestOptions) {
@@ -2632,7 +2630,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2632
2630
  return transporter.request(request, requestOptions);
2633
2631
  },
2634
2632
  /**
2635
- * 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.
2633
+ * List the available clusters in a multi-cluster setup.
2636
2634
  *
2637
2635
  * @summary List clusters.
2638
2636
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
@@ -2650,20 +2648,24 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2650
2648
  return transporter.request(request, requestOptions);
2651
2649
  },
2652
2650
  /**
2653
- * List existing indexes from an application.
2651
+ * List indices in an Algolia application.
2654
2652
  *
2655
- * @summary List existing indexes.
2653
+ * @summary List indices.
2656
2654
  * @param listIndices - The listIndices object.
2657
- * @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).
2655
+ * @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.
2656
+ * @param listIndices.hitsPerPage - Maximum number of hits per page.
2658
2657
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2659
2658
  */
2660
- listIndices({ page } = {}, requestOptions = undefined) {
2659
+ listIndices({ page, hitsPerPage } = {}, requestOptions = undefined) {
2661
2660
  const requestPath = '/1/indexes';
2662
2661
  const headers = {};
2663
2662
  const queryParameters = {};
2664
2663
  if (page !== undefined) {
2665
2664
  queryParameters.page = page.toString();
2666
2665
  }
2666
+ if (hitsPerPage !== undefined) {
2667
+ queryParameters.hitsPerPage = hitsPerPage.toString();
2668
+ }
2667
2669
  const request = {
2668
2670
  method: 'GET',
2669
2671
  path: requestPath,
@@ -2673,12 +2675,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2673
2675
  return transporter.request(request, requestOptions);
2674
2676
  },
2675
2677
  /**
2676
- * 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.
2678
+ * 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.
2677
2679
  *
2678
2680
  * @summary List userIDs.
2679
2681
  * @param listUserIds - The listUserIds object.
2680
- * @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).
2681
- * @param listUserIds.hitsPerPage - Maximum number of objects to retrieve.
2682
+ * @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.
2683
+ * @param listUserIds.hitsPerPage - Maximum number of hits per page.
2682
2684
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2683
2685
  */
2684
2686
  listUserIds({ page, hitsPerPage } = {}, requestOptions = undefined) {
@@ -2700,9 +2702,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2700
2702
  return transporter.request(request, requestOptions);
2701
2703
  },
2702
2704
  /**
2703
- * Perform multiple write operations, potentially targeting multiple indices, in a single API call.
2705
+ * 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.
2704
2706
  *
2705
- * @summary Batch operations to many indices.
2707
+ * @summary Batch write operations on multiple indices.
2706
2708
  * @param batchParams - The batchParams object.
2707
2709
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2708
2710
  */
@@ -2726,11 +2728,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2726
2728
  return transporter.request(request, requestOptions);
2727
2729
  },
2728
2730
  /**
2729
- * Performs a copy or a move operation on a index.
2731
+ * 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/).
2730
2732
  *
2731
- * @summary Copy/move index.
2733
+ * @summary Copy, move, or rename an index.
2732
2734
  * @param operationIndex - The operationIndex object.
2733
- * @param operationIndex.indexName - The index in which to perform the request.
2735
+ * @param operationIndex.indexName - Index on which to perform the request.
2734
2736
  * @param operationIndex.operationIndexParams - The operationIndexParams object.
2735
2737
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2736
2738
  */
@@ -2760,14 +2762,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2760
2762
  return transporter.request(request, requestOptions);
2761
2763
  },
2762
2764
  /**
2763
- * 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.
2765
+ * 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.
2764
2766
  *
2765
- * @summary Partially update an object.
2767
+ * @summary Update record attributes.
2766
2768
  * @param partialUpdateObject - The partialUpdateObject object.
2767
- * @param partialUpdateObject.indexName - The index in which to perform the request.
2768
- * @param partialUpdateObject.objectID - Unique identifier of an object.
2769
- * @param partialUpdateObject.attributesToUpdate - Map of attribute(s) to update.
2770
- * @param partialUpdateObject.createIfNotExists - Creates the record if it does not exist yet.
2769
+ * @param partialUpdateObject.indexName - Index on which to perform the request.
2770
+ * @param partialUpdateObject.objectID - Unique record (object) identifier.
2771
+ * @param partialUpdateObject.attributesToUpdate - Object with attributes to update.
2772
+ * @param partialUpdateObject.createIfNotExists - Indicates whether to create a new record if it doesn\'t exist yet.
2771
2773
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2772
2774
  */
2773
2775
  partialUpdateObject({ indexName, objectID, attributesToUpdate, createIfNotExists, }, requestOptions) {
@@ -2802,9 +2804,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2802
2804
  *
2803
2805
  * @summary Send requests to the Algolia REST API.
2804
2806
  * @param post - The post object.
2805
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2806
- * @param post.parameters - Query parameters to be applied to the current query.
2807
- * @param post.body - The parameters to send with the custom request.
2807
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
2808
+ * @param post.parameters - Query parameters to apply to the current query.
2809
+ * @param post.body - Parameters to send with the custom request.
2808
2810
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2809
2811
  */
2810
2812
  post({ path, parameters, body }, requestOptions) {
@@ -2828,9 +2830,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2828
2830
  *
2829
2831
  * @summary Send requests to the Algolia REST API.
2830
2832
  * @param put - The put object.
2831
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
2832
- * @param put.parameters - Query parameters to be applied to the current query.
2833
- * @param put.body - The parameters to send with the custom request.
2833
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
2834
+ * @param put.parameters - Query parameters to apply to the current query.
2835
+ * @param put.body - Parameters to send with the custom request.
2834
2836
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2835
2837
  */
2836
2838
  put({ path, parameters, body }, requestOptions) {
@@ -2850,7 +2852,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2850
2852
  return transporter.request(request, requestOptions);
2851
2853
  },
2852
2854
  /**
2853
- * 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.
2855
+ * Remove a userID and its associated data from the multi-clusters.
2854
2856
  *
2855
2857
  * @summary Remove userID.
2856
2858
  * @param removeUserId - The removeUserId object.
@@ -2875,9 +2877,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2875
2877
  /**
2876
2878
  * Replace all allowed sources.
2877
2879
  *
2878
- * @summary Replace all allowed sources.
2880
+ * @summary Replace all sources.
2879
2881
  * @param replaceSources - The replaceSources object.
2880
- * @param replaceSources.source - The sources to allow.
2882
+ * @param replaceSources.source - Allowed sources.
2881
2883
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2882
2884
  */
2883
2885
  replaceSources({ source }, requestOptions) {
@@ -2897,11 +2899,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2897
2899
  return transporter.request(request, requestOptions);
2898
2900
  },
2899
2901
  /**
2900
- * Restore a deleted API key, along with its associated rights.
2902
+ * Restore a deleted API key, along with its associated permissions. The request must be authenticated with the admin API key.
2901
2903
  *
2902
- * @summary Restore an API key.
2904
+ * @summary Restore API key.
2903
2905
  * @param restoreApiKey - The restoreApiKey object.
2904
- * @param restoreApiKey.key - API Key string.
2906
+ * @param restoreApiKey.key - API key.
2905
2907
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2906
2908
  */
2907
2909
  restoreApiKey({ key }, requestOptions) {
@@ -2920,11 +2922,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2920
2922
  return transporter.request(request, requestOptions);
2921
2923
  },
2922
2924
  /**
2923
- * Add an object to the index, automatically assigning it an object ID.
2925
+ * 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).
2924
2926
  *
2925
- * @summary Add an object to the index.
2927
+ * @summary Add or update a record.
2926
2928
  * @param saveObject - The saveObject object.
2927
- * @param saveObject.indexName - The index in which to perform the request.
2929
+ * @param saveObject.indexName - Index on which to perform the request.
2928
2930
  * @param saveObject.body - The Algolia record.
2929
2931
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2930
2932
  */
@@ -2948,14 +2950,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2948
2950
  return transporter.request(request, requestOptions);
2949
2951
  },
2950
2952
  /**
2951
- * Create or update the Rule with the specified objectID.
2953
+ * To create or update more than one rule, use the [`batch` operation](#tag/Rules/operation/saveRules).
2952
2954
  *
2953
- * @summary Save/Update a rule.
2955
+ * @summary Create or update a rule.
2954
2956
  * @param saveRule - The saveRule object.
2955
- * @param saveRule.indexName - The index in which to perform the request.
2956
- * @param saveRule.objectID - Unique identifier of an object.
2957
+ * @param saveRule.indexName - Index on which to perform the request.
2958
+ * @param saveRule.objectID - Unique identifier of a rule object.
2957
2959
  * @param saveRule.rule - The rule object.
2958
- * @param saveRule.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2960
+ * @param saveRule.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
2959
2961
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
2960
2962
  */
2961
2963
  saveRule({ indexName, objectID, rule, forwardToReplicas }, requestOptions) {
@@ -2989,14 +2991,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2989
2991
  return transporter.request(request, requestOptions);
2990
2992
  },
2991
2993
  /**
2992
- * Create/update multiple rules objects at once.
2994
+ * Create or update multiple rules.
2993
2995
  *
2994
2996
  * @summary Save a batch of rules.
2995
2997
  * @param saveRules - The saveRules object.
2996
- * @param saveRules.indexName - The index in which to perform the request.
2998
+ * @param saveRules.indexName - Index on which to perform the request.
2997
2999
  * @param saveRules.rules - The rules object.
2998
- * @param saveRules.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
2999
- * @param saveRules.clearExistingRules - When true, existing Rules are cleared before adding this batch. When false, existing Rules are kept.
3000
+ * @param saveRules.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3001
+ * @param saveRules.clearExistingRules - Indicates whether existing rules should be deleted before adding this batch.
3000
3002
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3001
3003
  */
3002
3004
  saveRules({ indexName, rules, forwardToReplicas, clearExistingRules, }, requestOptions) {
@@ -3025,14 +3027,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3025
3027
  return transporter.request(request, requestOptions);
3026
3028
  },
3027
3029
  /**
3028
- * Create a new synonym object or update the existing synonym object with the given object ID.
3030
+ * 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).
3029
3031
  *
3030
- * @summary Save synonym.
3032
+ * @summary Save a synonym.
3031
3033
  * @param saveSynonym - The saveSynonym object.
3032
- * @param saveSynonym.indexName - The index in which to perform the request.
3033
- * @param saveSynonym.objectID - Unique identifier of an object.
3034
+ * @param saveSynonym.indexName - Index on which to perform the request.
3035
+ * @param saveSynonym.objectID - Unique identifier of a synonym object.
3034
3036
  * @param saveSynonym.synonymHit - The synonymHit object.
3035
- * @param saveSynonym.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3037
+ * @param saveSynonym.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3036
3038
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3037
3039
  */
3038
3040
  saveSynonym({ indexName, objectID, synonymHit, forwardToReplicas }, requestOptions) {
@@ -3069,14 +3071,14 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3069
3071
  return transporter.request(request, requestOptions);
3070
3072
  },
3071
3073
  /**
3072
- * Create/update multiple synonym objects at once, potentially replacing the entire list of synonyms if replaceExistingSynonyms is true.
3074
+ * Create or update multiple synonyms.
3073
3075
  *
3074
3076
  * @summary Save a batch of synonyms.
3075
3077
  * @param saveSynonyms - The saveSynonyms object.
3076
- * @param saveSynonyms.indexName - The index in which to perform the request.
3078
+ * @param saveSynonyms.indexName - Index on which to perform the request.
3077
3079
  * @param saveSynonyms.synonymHit - The synonymHit object.
3078
- * @param saveSynonyms.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3079
- * @param saveSynonyms.replaceExistingSynonyms - Replace all synonyms of the index with the ones sent with this request.
3080
+ * @param saveSynonyms.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3081
+ * @param saveSynonyms.replaceExistingSynonyms - Indicates whether to replace all synonyms in the index with the ones sent with this request.
3080
3082
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3081
3083
  */
3082
3084
  saveSynonyms({ indexName, synonymHit, forwardToReplicas, replaceExistingSynonyms, }, requestOptions) {
@@ -3106,10 +3108,10 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3106
3108
  return transporter.request(request, requestOptions);
3107
3109
  },
3108
3110
  /**
3109
- * Perform a search operation targeting one or many indices.
3111
+ * Send multiple search queries to one or more indices.
3110
3112
  *
3111
3113
  * @summary Search multiple indices.
3112
- * @param searchMethodParams - The `search` requests and strategy.
3114
+ * @param searchMethodParams - Query requests and strategies. Results will be received in the same order as the queries.
3113
3115
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3114
3116
  */
3115
3117
  search(searchMethodParams, requestOptions) {
@@ -3156,11 +3158,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3156
3158
  return transporter.request(request, requestOptions);
3157
3159
  },
3158
3160
  /**
3159
- * Search the dictionary entries.
3161
+ * 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.
3160
3162
  *
3161
- * @summary Search a dictionary entries.
3163
+ * @summary Search dictionary entries.
3162
3164
  * @param searchDictionaryEntries - The searchDictionaryEntries object.
3163
- * @param searchDictionaryEntries.dictionaryName - The dictionary to search in.
3165
+ * @param searchDictionaryEntries.dictionaryName - Dictionary to search in.
3164
3166
  * @param searchDictionaryEntries.searchDictionaryEntriesParams - The searchDictionaryEntriesParams object.
3165
3167
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3166
3168
  */
@@ -3189,12 +3191,12 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3189
3191
  return transporter.request(request, requestOptions);
3190
3192
  },
3191
3193
  /**
3192
- * Search for values of a given facet, optionally restricting the returned values to those contained in objects matching other search criteria.
3194
+ * [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`.
3193
3195
  *
3194
- * @summary Search for values of a given facet.
3196
+ * @summary Search for facet values.
3195
3197
  * @param searchForFacetValues - The searchForFacetValues object.
3196
- * @param searchForFacetValues.indexName - The index in which to perform the request.
3197
- * @param searchForFacetValues.facetName - The facet name.
3198
+ * @param searchForFacetValues.indexName - Index on which to perform the request.
3199
+ * @param searchForFacetValues.facetName - Facet name.
3198
3200
  * @param searchForFacetValues.searchForFacetValuesRequest - The searchForFacetValuesRequest object.
3199
3201
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3200
3202
  */
@@ -3222,11 +3224,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3222
3224
  return transporter.request(request, requestOptions);
3223
3225
  },
3224
3226
  /**
3225
- * Search for rules matching various criteria.
3227
+ * Search for rules in your index. You can control the search with parameters. To list all rules, send an empty request body.
3226
3228
  *
3227
3229
  * @summary Search for rules.
3228
3230
  * @param searchRules - The searchRules object.
3229
- * @param searchRules.indexName - The index in which to perform the request.
3231
+ * @param searchRules.indexName - Index on which to perform the request.
3230
3232
  * @param searchRules.searchRulesParams - The searchRulesParams object.
3231
3233
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3232
3234
  */
@@ -3249,11 +3251,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3249
3251
  return transporter.request(request, requestOptions);
3250
3252
  },
3251
3253
  /**
3252
- * Perform a search operation targeting one specific index.
3254
+ * Return records that match the query.
3253
3255
  *
3254
- * @summary Search in a single index.
3256
+ * @summary Search an index.
3255
3257
  * @param searchSingleIndex - The searchSingleIndex object.
3256
- * @param searchSingleIndex.indexName - The index in which to perform the request.
3258
+ * @param searchSingleIndex.indexName - Index on which to perform the request.
3257
3259
  * @param searchSingleIndex.searchParams - The searchParams object.
3258
3260
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3259
3261
  */
@@ -3276,15 +3278,15 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3276
3278
  return transporter.request(request, requestOptions);
3277
3279
  },
3278
3280
  /**
3279
- * Search or browse all synonyms, optionally filtering them by type.
3281
+ * Search for synonyms in your index. You can control and filter the search with parameters. To get all synonyms, send an empty request body.
3280
3282
  *
3281
- * @summary Search synonyms.
3283
+ * @summary Search for synonyms.
3282
3284
  * @param searchSynonyms - The searchSynonyms object.
3283
- * @param searchSynonyms.indexName - The index in which to perform the request.
3284
- * @param searchSynonyms.type - Only search for specific types of synonyms.
3285
- * @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).
3286
- * @param searchSynonyms.hitsPerPage - Maximum number of objects to retrieve.
3287
- * @param searchSynonyms.searchSynonymsParams - The body of the the `searchSynonyms` method.
3285
+ * @param searchSynonyms.indexName - Index on which to perform the request.
3286
+ * @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).
3287
+ * @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.
3288
+ * @param searchSynonyms.hitsPerPage - Maximum number of hits per page.
3289
+ * @param searchSynonyms.searchSynonymsParams - Body of the `searchSynonyms` operation.
3288
3290
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3289
3291
  */
3290
3292
  searchSynonyms({ indexName, type, page, hitsPerPage, searchSynonymsParams, }, requestOptions) {
@@ -3315,9 +3317,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3315
3317
  return transporter.request(request, requestOptions);
3316
3318
  },
3317
3319
  /**
3318
- * 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.
3320
+ * 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).
3319
3321
  *
3320
- * @summary Search userID.
3322
+ * @summary Search for a user ID.
3321
3323
  * @param searchUserIdsParams - The searchUserIdsParams object.
3322
3324
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3323
3325
  */
@@ -3343,9 +3345,9 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3343
3345
  return transporter.request(request, requestOptions);
3344
3346
  },
3345
3347
  /**
3346
- * Set dictionaries settings.
3348
+ * Set stop word settings for a specific language.
3347
3349
  *
3348
- * @summary Set dictionaries settings.
3350
+ * @summary Set stop word settings.
3349
3351
  * @param dictionarySettingsParams - The dictionarySettingsParams object.
3350
3352
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3351
3353
  */
@@ -3369,13 +3371,13 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3369
3371
  return transporter.request(request, requestOptions);
3370
3372
  },
3371
3373
  /**
3372
- * 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.
3374
+ * 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.
3373
3375
  *
3374
- * @summary Update settings of an index.
3376
+ * @summary Update index settings.
3375
3377
  * @param setSettings - The setSettings object.
3376
- * @param setSettings.indexName - The index in which to perform the request.
3378
+ * @param setSettings.indexName - Index on which to perform the request.
3377
3379
  * @param setSettings.indexSettings - The indexSettings object.
3378
- * @param setSettings.forwardToReplicas - When true, changes are also propagated to replicas of the given indexName.
3380
+ * @param setSettings.forwardToReplicas - Indicates whether changed index settings are forwarded to the replica indices.
3379
3381
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3380
3382
  */
3381
3383
  setSettings({ indexName, indexSettings, forwardToReplicas }, requestOptions) {
@@ -3401,11 +3403,11 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
3401
3403
  return transporter.request(request, requestOptions);
3402
3404
  },
3403
3405
  /**
3404
- * Replace every permission of an existing API key.
3406
+ * 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.
3405
3407
  *
3406
3408
  * @summary Update an API key.
3407
3409
  * @param updateApiKey - The updateApiKey object.
3408
- * @param updateApiKey.key - API Key string.
3410
+ * @param updateApiKey.key - API key.
3409
3411
  * @param updateApiKey.apiKey - The apiKey object.
3410
3412
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
3411
3413
  */