@algolia/client-search 5.0.0-alpha.73 → 5.0.0-alpha.76

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 (240) hide show
  1. package/dist/client-search.cjs.js +188 -186
  2. package/dist/client-search.esm.browser.js +188 -184
  3. package/dist/client-search.esm.node.js +188 -184
  4. package/dist/client-search.umd.js +2 -2
  5. package/dist/model/acl.d.ts +1 -1
  6. package/dist/model/action.d.ts +1 -1
  7. package/dist/model/addApiKeyResponse.d.ts +2 -2
  8. package/dist/model/anchoring.d.ts +1 -1
  9. package/dist/model/apiKey.d.ts +9 -9
  10. package/dist/model/aroundRadius.d.ts +1 -1
  11. package/dist/model/assignUserIdParams.d.ts +1 -1
  12. package/dist/model/baseGetApiKeyResponse.d.ts +2 -2
  13. package/dist/model/baseIndexSettings.d.ts +14 -14
  14. package/dist/model/baseSearchParamsWithoutQuery.d.ts +25 -25
  15. package/dist/model/baseSearchResponse.d.ts +20 -20
  16. package/dist/model/baseSearchResponseRedirect.d.ts +1 -1
  17. package/dist/model/batchAssignUserIdsParams.d.ts +2 -2
  18. package/dist/model/batchDictionaryEntriesParams.d.ts +3 -3
  19. package/dist/model/batchParams.d.ts +1 -1
  20. package/dist/model/batchRequest.d.ts +1 -1
  21. package/dist/model/batchResponse.d.ts +2 -2
  22. package/dist/model/batchWriteParams.d.ts +1 -1
  23. package/dist/model/builtInOperation.d.ts +1 -1
  24. package/dist/model/builtInOperationType.d.ts +1 -1
  25. package/dist/model/clientMethodProps.d.ts +88 -84
  26. package/dist/model/clientMethodProps.d.ts.map +1 -1
  27. package/dist/model/consequence.d.ts +4 -4
  28. package/dist/model/consequenceHide.d.ts +2 -2
  29. package/dist/model/createdAtResponse.d.ts +2 -2
  30. package/dist/model/cursor.d.ts +1 -1
  31. package/dist/model/deleteApiKeyResponse.d.ts +1 -1
  32. package/dist/model/deleteByParams.d.ts +4 -4
  33. package/dist/model/deleteSourceResponse.d.ts +1 -1
  34. package/dist/model/deletedAtResponse.d.ts +3 -3
  35. package/dist/model/dictionaryEntry.d.ts +6 -6
  36. package/dist/model/dictionaryEntryState.d.ts +1 -1
  37. package/dist/model/dictionaryLanguage.d.ts +2 -2
  38. package/dist/model/dictionarySettingsParams.d.ts +1 -1
  39. package/dist/model/distinct.d.ts +1 -1
  40. package/dist/model/exactOnSingleWordQuery.d.ts +1 -1
  41. package/dist/model/facetFilters.d.ts +1 -1
  42. package/dist/model/facetHits.d.ts +3 -3
  43. package/dist/model/facetOrdering.d.ts +2 -2
  44. package/dist/model/facets.d.ts +1 -1
  45. package/dist/model/facetsStats.d.ts +4 -4
  46. package/dist/model/fetchedIndex.d.ts +1 -1
  47. package/dist/model/getObjectsParams.d.ts +1 -1
  48. package/dist/model/getObjectsRequest.d.ts +4 -4
  49. package/dist/model/getObjectsResponse.d.ts +1 -1
  50. package/dist/model/getTopUserIdsResponse.d.ts +2 -2
  51. package/dist/model/hasPendingMappingsResponse.d.ts +2 -2
  52. package/dist/model/highlightResultOption.d.ts +1 -1
  53. package/dist/model/hit.d.ts +1 -1
  54. package/dist/model/ignorePlurals.d.ts +1 -1
  55. package/dist/model/index.d.ts +1 -0
  56. package/dist/model/index.d.ts.map +1 -1
  57. package/dist/model/indexSettings.d.ts +1 -1
  58. package/dist/model/indexSettingsAsSearchParams.d.ts +30 -30
  59. package/dist/model/indexSettingsAsSearchParamsSemanticSearch.d.ts +2 -2
  60. package/dist/model/languages.d.ts +1 -1
  61. package/dist/model/listApiKeysResponse.d.ts +1 -1
  62. package/dist/model/listClustersResponse.d.ts +2 -2
  63. package/dist/model/listIndicesResponse.d.ts +1 -1
  64. package/dist/model/listUserIdsResponse.d.ts +2 -2
  65. package/dist/model/log.d.ts +7 -7
  66. package/dist/model/logQuery.d.ts +1 -1
  67. package/dist/model/mode.d.ts +1 -1
  68. package/dist/model/multipleBatchRequest.d.ts +1 -1
  69. package/dist/model/multipleBatchResponse.d.ts +2 -2
  70. package/dist/model/numericFilters.d.ts +1 -1
  71. package/dist/model/operationIndexParams.d.ts +2 -2
  72. package/dist/model/operationType.d.ts +1 -1
  73. package/dist/model/optionalFilters.d.ts +1 -1
  74. package/dist/model/params.d.ts +1 -1
  75. package/dist/model/promoteObjectID.d.ts +3 -3
  76. package/dist/model/promoteObjectIDs.d.ts +3 -3
  77. package/dist/model/queryType.d.ts +1 -1
  78. package/dist/model/reRankingApplyFilter.d.ts +1 -1
  79. package/dist/model/redirectRuleIndexMetadata.d.ts +1 -1
  80. package/dist/model/redirectRuleIndexMetadataData.d.ts +1 -1
  81. package/dist/model/removeStopWords.d.ts +1 -1
  82. package/dist/model/removeUserIdResponse.d.ts +1 -1
  83. package/dist/model/removeWordsIfNoResults.d.ts +1 -1
  84. package/dist/model/renderingContent.d.ts +1 -1
  85. package/dist/model/replaceSourceResponse.d.ts +1 -1
  86. package/dist/model/rule.d.ts +5 -5
  87. package/dist/model/saveObjectResponse.d.ts +5 -2
  88. package/dist/model/saveObjectResponse.d.ts.map +1 -1
  89. package/dist/model/saveSynonymResponse.d.ts +3 -3
  90. package/dist/model/searchDictionaryEntriesParams.d.ts +5 -5
  91. package/dist/model/searchForFacetValuesRequest.d.ts +2 -2
  92. package/dist/model/searchForFacetsOptions.d.ts +3 -3
  93. package/dist/model/searchForHitsOptions.d.ts +1 -1
  94. package/dist/model/searchParamsQuery.d.ts +1 -1
  95. package/dist/model/searchParamsString.d.ts +1 -1
  96. package/dist/model/searchResponses.d.ts +2 -2
  97. package/dist/model/searchResponses.d.ts.map +1 -1
  98. package/dist/model/searchResult.d.ts +4 -0
  99. package/dist/model/searchResult.d.ts.map +1 -0
  100. package/dist/model/searchRulesParams.d.ts +7 -7
  101. package/dist/model/searchStrategy.d.ts +3 -0
  102. package/dist/model/searchStrategy.d.ts.map +1 -1
  103. package/dist/model/searchSynonymsParams.d.ts +1 -1
  104. package/dist/model/searchSynonymsResponse.d.ts +2 -2
  105. package/dist/model/searchTypeDefault.d.ts +1 -1
  106. package/dist/model/searchTypeFacet.d.ts +1 -1
  107. package/dist/model/searchUserIdsParams.d.ts +4 -4
  108. package/dist/model/searchUserIdsResponse.d.ts +5 -5
  109. package/dist/model/snippetResultOption.d.ts +1 -1
  110. package/dist/model/sortRemainingBy.d.ts +1 -1
  111. package/dist/model/source.d.ts +3 -3
  112. package/dist/model/standardEntries.d.ts +4 -4
  113. package/dist/model/synonymHit.d.ts +6 -6
  114. package/dist/model/synonymType.d.ts +1 -1
  115. package/dist/model/tagFilters.d.ts +1 -1
  116. package/dist/model/taskStatus.d.ts +3 -0
  117. package/dist/model/taskStatus.d.ts.map +1 -1
  118. package/dist/model/typoTolerance.d.ts +1 -1
  119. package/dist/model/updateApiKeyResponse.d.ts +2 -2
  120. package/dist/model/updatedAtResponse.d.ts +3 -3
  121. package/dist/model/updatedAtWithObjectIdResponse.d.ts +4 -4
  122. package/dist/model/updatedRuleResponse.d.ts +3 -3
  123. package/dist/model/userHit.d.ts +1 -1
  124. package/dist/model/userId.d.ts +2 -2
  125. package/dist/src/searchClient.d.ts +185 -184
  126. package/dist/src/searchClient.d.ts.map +1 -1
  127. package/model/acl.ts +1 -1
  128. package/model/action.ts +1 -1
  129. package/model/addApiKeyResponse.ts +2 -2
  130. package/model/anchoring.ts +1 -1
  131. package/model/apiKey.ts +9 -9
  132. package/model/aroundRadius.ts +1 -1
  133. package/model/assignUserIdParams.ts +1 -1
  134. package/model/baseGetApiKeyResponse.ts +2 -2
  135. package/model/baseIndexSettings.ts +14 -14
  136. package/model/baseSearchParamsWithoutQuery.ts +25 -25
  137. package/model/baseSearchResponse.ts +20 -20
  138. package/model/baseSearchResponseRedirect.ts +1 -1
  139. package/model/batchAssignUserIdsParams.ts +2 -2
  140. package/model/batchDictionaryEntriesParams.ts +3 -3
  141. package/model/batchParams.ts +1 -1
  142. package/model/batchRequest.ts +1 -1
  143. package/model/batchResponse.ts +2 -2
  144. package/model/batchWriteParams.ts +1 -1
  145. package/model/builtInOperation.ts +1 -1
  146. package/model/builtInOperationType.ts +1 -1
  147. package/model/clientMethodProps.ts +88 -84
  148. package/model/consequence.ts +4 -4
  149. package/model/consequenceHide.ts +2 -2
  150. package/model/createdAtResponse.ts +2 -2
  151. package/model/cursor.ts +1 -1
  152. package/model/deleteApiKeyResponse.ts +1 -1
  153. package/model/deleteByParams.ts +4 -4
  154. package/model/deleteSourceResponse.ts +1 -1
  155. package/model/deletedAtResponse.ts +3 -3
  156. package/model/dictionaryEntry.ts +6 -6
  157. package/model/dictionaryEntryState.ts +1 -1
  158. package/model/dictionaryLanguage.ts +2 -2
  159. package/model/dictionarySettingsParams.ts +1 -1
  160. package/model/distinct.ts +1 -1
  161. package/model/exactOnSingleWordQuery.ts +1 -1
  162. package/model/facetFilters.ts +1 -1
  163. package/model/facetHits.ts +3 -3
  164. package/model/facetOrdering.ts +2 -2
  165. package/model/facets.ts +1 -1
  166. package/model/facetsStats.ts +4 -4
  167. package/model/fetchedIndex.ts +1 -1
  168. package/model/getObjectsParams.ts +1 -1
  169. package/model/getObjectsRequest.ts +4 -4
  170. package/model/getObjectsResponse.ts +1 -1
  171. package/model/getTopUserIdsResponse.ts +2 -2
  172. package/model/hasPendingMappingsResponse.ts +2 -2
  173. package/model/highlightResultOption.ts +1 -1
  174. package/model/hit.ts +1 -1
  175. package/model/ignorePlurals.ts +1 -1
  176. package/model/index.ts +1 -0
  177. package/model/indexSettings.ts +1 -1
  178. package/model/indexSettingsAsSearchParams.ts +30 -30
  179. package/model/indexSettingsAsSearchParamsSemanticSearch.ts +2 -2
  180. package/model/languages.ts +1 -1
  181. package/model/listApiKeysResponse.ts +1 -1
  182. package/model/listClustersResponse.ts +2 -2
  183. package/model/listIndicesResponse.ts +1 -1
  184. package/model/listUserIdsResponse.ts +2 -2
  185. package/model/log.ts +7 -7
  186. package/model/logQuery.ts +1 -1
  187. package/model/mode.ts +1 -1
  188. package/model/multipleBatchRequest.ts +1 -1
  189. package/model/multipleBatchResponse.ts +2 -2
  190. package/model/numericFilters.ts +1 -1
  191. package/model/operationIndexParams.ts +2 -2
  192. package/model/operationType.ts +1 -1
  193. package/model/optionalFilters.ts +1 -1
  194. package/model/params.ts +1 -1
  195. package/model/promoteObjectID.ts +3 -3
  196. package/model/promoteObjectIDs.ts +3 -3
  197. package/model/queryType.ts +1 -1
  198. package/model/reRankingApplyFilter.ts +1 -1
  199. package/model/redirectRuleIndexMetadata.ts +1 -1
  200. package/model/redirectRuleIndexMetadataData.ts +1 -1
  201. package/model/removeStopWords.ts +1 -1
  202. package/model/removeUserIdResponse.ts +1 -1
  203. package/model/removeWordsIfNoResults.ts +1 -1
  204. package/model/renderingContent.ts +1 -1
  205. package/model/replaceSourceResponse.ts +1 -1
  206. package/model/rule.ts +5 -5
  207. package/model/saveObjectResponse.ts +5 -2
  208. package/model/saveSynonymResponse.ts +3 -3
  209. package/model/searchDictionaryEntriesParams.ts +5 -5
  210. package/model/searchForFacetValuesRequest.ts +2 -2
  211. package/model/searchForFacetsOptions.ts +3 -3
  212. package/model/searchForHitsOptions.ts +1 -1
  213. package/model/searchParamsQuery.ts +1 -1
  214. package/model/searchParamsString.ts +1 -1
  215. package/model/searchResponses.ts +2 -2
  216. package/model/searchResult.ts +8 -0
  217. package/model/searchRulesParams.ts +7 -7
  218. package/model/searchStrategy.ts +3 -0
  219. package/model/searchSynonymsParams.ts +1 -1
  220. package/model/searchSynonymsResponse.ts +2 -2
  221. package/model/searchTypeDefault.ts +1 -1
  222. package/model/searchTypeFacet.ts +1 -1
  223. package/model/searchUserIdsParams.ts +4 -4
  224. package/model/searchUserIdsResponse.ts +5 -5
  225. package/model/snippetResultOption.ts +1 -1
  226. package/model/sortRemainingBy.ts +1 -1
  227. package/model/source.ts +3 -3
  228. package/model/standardEntries.ts +4 -4
  229. package/model/synonymHit.ts +6 -6
  230. package/model/synonymType.ts +1 -1
  231. package/model/tagFilters.ts +1 -1
  232. package/model/taskStatus.ts +3 -0
  233. package/model/typoTolerance.ts +1 -1
  234. package/model/updateApiKeyResponse.ts +2 -2
  235. package/model/updatedAtResponse.ts +3 -3
  236. package/model/updatedAtWithObjectIdResponse.ts +4 -4
  237. package/model/updatedRuleResponse.ts +3 -3
  238. package/model/userHit.ts +1 -1
  239. package/model/userId.ts +2 -2
  240. package/package.json +8 -7
@@ -3,35 +3,35 @@ import type { FacetsStats } from './facetsStats';
3
3
  import type { RenderingContent } from './renderingContent';
4
4
  export type BaseSearchResponse = {
5
5
  /**
6
- * If a search encounters an index that is being A/B tested, abTestID reports the ongoing A/B test ID.
6
+ * A/B test ID. This is only included in the response for indices that are part of an A/B test.
7
7
  */
8
8
  abTestID?: number;
9
9
  /**
10
- * If a search encounters an index that is being A/B tested, abTestVariantID reports the variant ID of the index used (starting at 1).
10
+ * Variant ID. This is only included in the response for indices that are part of an A/B test.
11
11
  */
12
12
  abTestVariantID?: number;
13
13
  /**
14
- * The computed geo location.
14
+ * Computed geographical location.
15
15
  */
16
16
  aroundLatLng?: string;
17
17
  /**
18
- * The automatically computed radius. For legacy reasons, this parameter is a string and not an integer.
18
+ * Automatically-computed radius.
19
19
  */
20
20
  automaticRadius?: string;
21
21
  /**
22
- * Whether the facet count is exhaustive or approximate.
22
+ * Indicates whether the facet count is exhaustive (exact) or approximate.
23
23
  */
24
24
  exhaustiveFacetsCount?: boolean;
25
25
  /**
26
- * Indicate if the nbHits count was exhaustive or approximate.
26
+ * Indicates whether the number of hits `nbHits` is exhaustive (exact) or approximate.
27
27
  */
28
28
  exhaustiveNbHits: boolean;
29
29
  /**
30
- * Indicate if the typo-tolerance search was exhaustive or approximate (only included when typo-tolerance is enabled).
30
+ * Indicates whether the search for typos was exhaustive (exact) or approximate.
31
31
  */
32
32
  exhaustiveTypo?: boolean;
33
33
  /**
34
- * A mapping of each facet name to the corresponding facet counts.
34
+ * Mapping of each facet name to the corresponding facet counts.
35
35
  */
36
36
  facets?: Record<string, Record<string, number>>;
37
37
  /**
@@ -39,7 +39,7 @@ export type BaseSearchResponse = {
39
39
  */
40
40
  facets_stats?: Record<string, FacetsStats>;
41
41
  /**
42
- * Set the number of hits per page.
42
+ * Number of hits per page.
43
43
  */
44
44
  hitsPerPage: number;
45
45
  /**
@@ -47,36 +47,36 @@ export type BaseSearchResponse = {
47
47
  */
48
48
  index?: string;
49
49
  /**
50
- * Index name used for the query. In the case of an A/B test, the targeted index isn\'t always the index used by the query.
50
+ * Index name used for the query. During A/B testing, the targeted index isn\'t always the index used by the query.
51
51
  */
52
52
  indexUsed?: string;
53
53
  /**
54
- * Used to return warnings about the query.
54
+ * Warnings about the query.
55
55
  */
56
56
  message?: string;
57
57
  /**
58
- * Number of hits that the search query matched.
58
+ * Number of hits the search query matched.
59
59
  */
60
60
  nbHits: number;
61
61
  /**
62
- * Number of pages available for the current query.
62
+ * Number of pages of results for the current query.
63
63
  */
64
64
  nbPages: number;
65
65
  /**
66
- * The number of hits selected and sorted by the relevant sort algorithm.
66
+ * Number of hits selected and sorted by the relevant sort algorithm.
67
67
  */
68
68
  nbSortedHits?: number;
69
69
  /**
70
- * Specify the page to retrieve.
70
+ * Page to retrieve (the first page is `0`, not `1`).
71
71
  */
72
72
  page: number;
73
73
  /**
74
- * A url-encoded string of all search parameters.
74
+ * URL-encoded string of all search parameters.
75
75
  */
76
76
  params: string;
77
77
  redirect?: BaseSearchResponseRedirect;
78
78
  /**
79
- * The query string that will be searched, after normalization.
79
+ * Post-[normalization](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/#what-does-normalization-mean) query string that will be searched.
80
80
  */
81
81
  parsedQuery?: string;
82
82
  /**
@@ -84,15 +84,15 @@ export type BaseSearchResponse = {
84
84
  */
85
85
  processingTimeMS: number;
86
86
  /**
87
- * The text to search in the index.
87
+ * Text to search for in an index.
88
88
  */
89
89
  query: string;
90
90
  /**
91
- * A markup text indicating which parts of the original query have been removed in order to retrieve a non-empty result set.
91
+ * Markup text indicating which parts of the original query have been removed to retrieve a non-empty result set.
92
92
  */
93
93
  queryAfterRemoval?: string;
94
94
  /**
95
- * Actual host name of the server that processed the request.
95
+ * Host name of the server that processed the request.
96
96
  */
97
97
  serverUsed?: string;
98
98
  /**
@@ -1,6 +1,6 @@
1
1
  import type { RedirectRuleIndexMetadata } from './redirectRuleIndexMetadata';
2
2
  /**
3
- * This parameter is for internal use only.
3
+ * [Redirect results to a URL](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/redirects/).
4
4
  */
5
5
  export type BaseSearchResponseRedirect = {
6
6
  index?: RedirectRuleIndexMetadata[];
@@ -3,11 +3,11 @@
3
3
  */
4
4
  export type BatchAssignUserIdsParams = {
5
5
  /**
6
- * Name of the cluster.
6
+ * Cluster name.
7
7
  */
8
8
  cluster: string;
9
9
  /**
10
- * UserIDs to assign. Note you cannot move users with this method.
10
+ * User IDs to assign.
11
11
  */
12
12
  users: string[];
13
13
  };
@@ -1,14 +1,14 @@
1
1
  import type { BatchDictionaryEntriesRequest } from './batchDictionaryEntriesRequest';
2
2
  /**
3
- * The `batchDictionaryEntries` parameters.
3
+ * `batchDictionaryEntries` parameters.
4
4
  */
5
5
  export type BatchDictionaryEntriesParams = {
6
6
  /**
7
- * When `true`, start the batch by removing all the custom entries from the dictionary.
7
+ * Incidates whether to replace all custom entries in the dictionary with the ones sent with this request.
8
8
  */
9
9
  clearExistingDictionaryEntries?: boolean;
10
10
  /**
11
- * List of operations to batch. Each operation is described by an `action` and a `body`.
11
+ * Operations to batch.
12
12
  */
13
13
  requests: BatchDictionaryEntriesRequest[];
14
14
  };
@@ -1,6 +1,6 @@
1
1
  import type { MultipleBatchRequest } from './multipleBatchRequest';
2
2
  /**
3
- * The `multipleBatch` parameters.
3
+ * Batch parameters.
4
4
  */
5
5
  export type BatchParams = {
6
6
  requests: MultipleBatchRequest[];
@@ -2,7 +2,7 @@ import type { Action } from './action';
2
2
  export type BatchRequest = {
3
3
  action: Action;
4
4
  /**
5
- * Arguments to the operation (depends on the type of the operation).
5
+ * Operation arguments (varies with specified `action`).
6
6
  */
7
7
  body: Record<string, any>;
8
8
  };
@@ -1,10 +1,10 @@
1
1
  export type BatchResponse = {
2
2
  /**
3
- * TaskID of the task to wait for.
3
+ * Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task\'s progress with the `task` operation and this `taskID`.
4
4
  */
5
5
  taskID: number;
6
6
  /**
7
- * List of objectID.
7
+ * Unique object (record) identifiers.
8
8
  */
9
9
  objectIDs: string[];
10
10
  };
@@ -1,6 +1,6 @@
1
1
  import type { BatchRequest } from './batchRequest';
2
2
  /**
3
- * The `batch` parameters.
3
+ * Batch parameters.
4
4
  */
5
5
  export type BatchWriteParams = {
6
6
  requests: BatchRequest[];
@@ -5,7 +5,7 @@ import type { BuiltInOperationType } from './builtInOperationType';
5
5
  export type BuiltInOperation = {
6
6
  _operation: BuiltInOperationType;
7
7
  /**
8
- * The right-hand side argument to the operation, for example, increment or decrement step, value to add or remove.
8
+ * Value that corresponds to the operation, for example an `Increment` or `Decrement` step, `Add` or `Remove` value.
9
9
  */
10
10
  value: string;
11
11
  };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * The operation to apply on the attribute.
2
+ * Operation to apply to the attribute.
3
3
  */
4
4
  export type BuiltInOperationType = 'Add' | 'AddUnique' | 'Decrement' | 'Increment' | 'IncrementFrom' | 'IncrementSet' | 'Remove';
5
5
  //# sourceMappingURL=builtInOperationType.d.ts.map