@algolia/recommend 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 (154) hide show
  1. package/dist/model/anchoring.d.ts +5 -0
  2. package/dist/model/anchoring.d.ts.map +1 -0
  3. package/dist/model/aroundRadius.d.ts +1 -1
  4. package/dist/model/automaticFacetFilter.d.ts +18 -0
  5. package/dist/model/automaticFacetFilter.d.ts.map +1 -0
  6. package/dist/model/automaticFacetFilters.d.ts +6 -0
  7. package/dist/model/automaticFacetFilters.d.ts.map +1 -0
  8. package/dist/model/baseRecommendRequest.d.ts +3 -3
  9. package/dist/model/baseRecommendationRequest.d.ts +1 -1
  10. package/dist/model/baseSearchParamsWithoutQuery.d.ts +25 -25
  11. package/dist/model/baseSearchResponse.d.ts +20 -20
  12. package/dist/model/baseSearchResponseRedirect.d.ts +1 -1
  13. package/dist/model/baseTrendingRequest.d.ts +2 -2
  14. package/dist/model/clientMethodProps.d.ts +77 -10
  15. package/dist/model/clientMethodProps.d.ts.map +1 -1
  16. package/dist/model/condition.d.ts +17 -0
  17. package/dist/model/condition.d.ts.map +1 -0
  18. package/dist/model/consequence.d.ts +26 -0
  19. package/dist/model/consequence.d.ts.map +1 -0
  20. package/dist/model/consequenceHide.d.ts +10 -0
  21. package/dist/model/consequenceHide.d.ts.map +1 -0
  22. package/dist/model/consequenceParams.d.ts +5 -0
  23. package/dist/model/consequenceParams.d.ts.map +1 -0
  24. package/dist/model/consequenceQuery.d.ts +6 -0
  25. package/dist/model/consequenceQuery.d.ts.map +1 -0
  26. package/dist/model/consequenceQueryObject.d.ts +12 -0
  27. package/dist/model/consequenceQueryObject.d.ts.map +1 -0
  28. package/dist/model/deletedAtResponse.d.ts +14 -0
  29. package/dist/model/deletedAtResponse.d.ts.map +1 -0
  30. package/dist/model/distinct.d.ts +1 -1
  31. package/dist/model/edit.d.ts +13 -0
  32. package/dist/model/edit.d.ts.map +1 -0
  33. package/dist/model/editType.d.ts +5 -0
  34. package/dist/model/editType.d.ts.map +1 -0
  35. package/dist/model/exactOnSingleWordQuery.d.ts +1 -1
  36. package/dist/model/facetFilters.d.ts +1 -1
  37. package/dist/model/facetOrdering.d.ts +2 -2
  38. package/dist/model/facets.d.ts +1 -1
  39. package/dist/model/facetsStats.d.ts +4 -4
  40. package/dist/model/getRecommendTaskResponse.d.ts +5 -0
  41. package/dist/model/getRecommendTaskResponse.d.ts.map +1 -0
  42. package/dist/model/getRecommendationsParams.d.ts +2 -2
  43. package/dist/model/highlightResultOption.d.ts +1 -1
  44. package/dist/model/ignorePlurals.d.ts +1 -1
  45. package/dist/model/index.d.ts +23 -0
  46. package/dist/model/index.d.ts.map +1 -1
  47. package/dist/model/indexSettingsAsSearchParams.d.ts +30 -30
  48. package/dist/model/indexSettingsAsSearchParamsSemanticSearch.d.ts +2 -2
  49. package/dist/model/mode.d.ts +1 -1
  50. package/dist/model/numericFilters.d.ts +1 -1
  51. package/dist/model/optionalFilters.d.ts +1 -1
  52. package/dist/model/params.d.ts +13 -0
  53. package/dist/model/params.d.ts.map +1 -0
  54. package/dist/model/promote.d.ts +4 -0
  55. package/dist/model/promote.d.ts.map +1 -0
  56. package/dist/model/promoteObjectID.d.ts +14 -0
  57. package/dist/model/promoteObjectID.d.ts.map +1 -0
  58. package/dist/model/promoteObjectIDs.d.ts +14 -0
  59. package/dist/model/promoteObjectIDs.d.ts.map +1 -0
  60. package/dist/model/queryType.d.ts +1 -1
  61. package/dist/model/reRankingApplyFilter.d.ts +1 -1
  62. package/dist/model/recommendHit.d.ts +3 -3
  63. package/dist/model/recommendModels.d.ts +2 -0
  64. package/dist/model/recommendModels.d.ts.map +1 -0
  65. package/dist/model/recommendationModels.d.ts +1 -1
  66. package/dist/model/redirectRuleIndexMetadata.d.ts +1 -1
  67. package/dist/model/redirectRuleIndexMetadataData.d.ts +1 -1
  68. package/dist/model/removeStopWords.d.ts +1 -1
  69. package/dist/model/removeWordsIfNoResults.d.ts +1 -1
  70. package/dist/model/renderingContent.d.ts +1 -1
  71. package/dist/model/ruleResponse.d.ts +27 -0
  72. package/dist/model/ruleResponse.d.ts.map +1 -0
  73. package/dist/model/ruleResponseMetadata.d.ts +7 -0
  74. package/dist/model/ruleResponseMetadata.d.ts.map +1 -0
  75. package/dist/model/searchParamsQuery.d.ts +1 -1
  76. package/dist/model/searchRecommendRulesParams.d.ts +30 -0
  77. package/dist/model/searchRecommendRulesParams.d.ts.map +1 -0
  78. package/dist/model/searchRecommendRulesResponse.d.ts +20 -0
  79. package/dist/model/searchRecommendRulesResponse.d.ts.map +1 -0
  80. package/dist/model/snippetResultOption.d.ts +1 -1
  81. package/dist/model/sortRemainingBy.d.ts +1 -1
  82. package/dist/model/tagFilters.d.ts +1 -1
  83. package/dist/model/taskStatus.d.ts +5 -0
  84. package/dist/model/taskStatus.d.ts.map +1 -0
  85. package/dist/model/trendingModels.d.ts +1 -1
  86. package/dist/model/typoTolerance.d.ts +1 -1
  87. package/dist/recommend.cjs.js +148 -15
  88. package/dist/recommend.esm.browser.js +148 -13
  89. package/dist/recommend.esm.node.js +148 -13
  90. package/dist/recommend.umd.js +2 -2
  91. package/dist/src/recommendClient.d.ts +62 -14
  92. package/dist/src/recommendClient.d.ts.map +1 -1
  93. package/model/anchoring.ts +6 -0
  94. package/model/aroundRadius.ts +1 -1
  95. package/model/automaticFacetFilter.ts +21 -0
  96. package/model/automaticFacetFilters.ts +8 -0
  97. package/model/baseRecommendRequest.ts +3 -3
  98. package/model/baseRecommendationRequest.ts +1 -1
  99. package/model/baseSearchParamsWithoutQuery.ts +25 -25
  100. package/model/baseSearchResponse.ts +20 -20
  101. package/model/baseSearchResponseRedirect.ts +1 -1
  102. package/model/baseTrendingRequest.ts +2 -2
  103. package/model/clientMethodProps.ts +82 -10
  104. package/model/condition.ts +22 -0
  105. package/model/consequence.ts +32 -0
  106. package/model/consequenceHide.ts +11 -0
  107. package/model/consequenceParams.ts +9 -0
  108. package/model/consequenceQuery.ts +8 -0
  109. package/model/consequenceQueryObject.ts +15 -0
  110. package/model/deletedAtResponse.ts +16 -0
  111. package/model/distinct.ts +1 -1
  112. package/model/edit.ts +17 -0
  113. package/model/editType.ts +6 -0
  114. package/model/exactOnSingleWordQuery.ts +1 -1
  115. package/model/facetFilters.ts +1 -1
  116. package/model/facetOrdering.ts +2 -2
  117. package/model/facets.ts +1 -1
  118. package/model/facetsStats.ts +4 -4
  119. package/model/getRecommendTaskResponse.ts +7 -0
  120. package/model/getRecommendationsParams.ts +2 -2
  121. package/model/highlightResultOption.ts +1 -1
  122. package/model/ignorePlurals.ts +1 -1
  123. package/model/index.ts +23 -0
  124. package/model/indexSettingsAsSearchParams.ts +30 -30
  125. package/model/indexSettingsAsSearchParamsSemanticSearch.ts +2 -2
  126. package/model/mode.ts +1 -1
  127. package/model/numericFilters.ts +1 -1
  128. package/model/optionalFilters.ts +1 -1
  129. package/model/params.ts +18 -0
  130. package/model/promote.ts +6 -0
  131. package/model/promoteObjectID.ts +16 -0
  132. package/model/promoteObjectIDs.ts +16 -0
  133. package/model/queryType.ts +1 -1
  134. package/model/reRankingApplyFilter.ts +1 -1
  135. package/model/recommendHit.ts +3 -3
  136. package/model/recommendModels.ts +7 -0
  137. package/model/recommendationModels.ts +1 -1
  138. package/model/redirectRuleIndexMetadata.ts +1 -1
  139. package/model/redirectRuleIndexMetadataData.ts +1 -1
  140. package/model/removeStopWords.ts +1 -1
  141. package/model/removeWordsIfNoResults.ts +1 -1
  142. package/model/renderingContent.ts +1 -1
  143. package/model/ruleResponse.ts +34 -0
  144. package/model/ruleResponseMetadata.ts +8 -0
  145. package/model/searchParamsQuery.ts +1 -1
  146. package/model/searchRecommendRulesParams.ts +36 -0
  147. package/model/searchRecommendRulesResponse.ts +25 -0
  148. package/model/snippetResultOption.ts +1 -1
  149. package/model/sortRemainingBy.ts +1 -1
  150. package/model/tagFilters.ts +1 -1
  151. package/model/taskStatus.ts +6 -0
  152. package/model/trendingModels.ts +1 -1
  153. package/model/typoTolerance.ts +1 -1
  154. package/package.json +8 -7
@@ -4,13 +4,13 @@ import type { Facets } from './facets';
4
4
  import type { Value } from './value';
5
5
 
6
6
  /**
7
- * Defining how facets should be ordered.
7
+ * Defines the ordering of facets (widgets).
8
8
  */
9
9
  export type FacetOrdering = {
10
10
  facets?: Facets;
11
11
 
12
12
  /**
13
- * The ordering of facet values, within an individual list.
13
+ * Ordering of facet values within an individual facet.
14
14
  */
15
15
  values?: Record<string, Value>;
16
16
  };
package/model/facets.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * The ordering of facets (widgets).
4
+ * Ordering of facets (widgets).
5
5
  */
6
6
  export type Facets = {
7
7
  /**
@@ -2,22 +2,22 @@
2
2
 
3
3
  export type FacetsStats = {
4
4
  /**
5
- * The minimum value in the result set.
5
+ * Minimum value in the results.
6
6
  */
7
7
  min?: number;
8
8
 
9
9
  /**
10
- * The maximum value in the result set.
10
+ * Maximum value in the results.
11
11
  */
12
12
  max?: number;
13
13
 
14
14
  /**
15
- * The average facet value in the result set.
15
+ * Average facet value in the results.
16
16
  */
17
17
  avg?: number;
18
18
 
19
19
  /**
20
- * The sum of all values in the result set.
20
+ * Sum of all values in the results.
21
21
  */
22
22
  sum?: number;
23
23
  };
@@ -0,0 +1,7 @@
1
+ // 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.
2
+
3
+ import type { TaskStatus } from './taskStatus';
4
+
5
+ export type GetRecommendTaskResponse = {
6
+ status: TaskStatus;
7
+ };
@@ -3,11 +3,11 @@
3
3
  import type { RecommendationsRequest } from './recommendationsRequest';
4
4
 
5
5
  /**
6
- * The `getRecommendations` parameters.
6
+ * Recommend parameters.
7
7
  */
8
8
  export type GetRecommendationsParams = {
9
9
  /**
10
- * The `getRecommendations` requests.
10
+ * Request parameters depend on the model (recommendations or trending).
11
11
  */
12
12
  requests: RecommendationsRequest[];
13
13
  };
@@ -7,7 +7,7 @@ import type { MatchLevel } from './matchLevel';
7
7
  */
8
8
  export type HighlightResultOption = {
9
9
  /**
10
- * Markup text with occurrences highlighted.
10
+ * Markup text with `facetQuery` matches highlighted.
11
11
  */
12
12
  value: string;
13
13
 
@@ -1,6 +1,6 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * Treats singular, plurals, and other forms of declensions as matching terms. IgnorePlurals is used in conjunction with the queryLanguages setting. List: language ISO codes for which ignoring plurals should be enabled. This list will override any values that you may have set in queryLanguages. True: enables the ignore plurals functionality, where singulars and plurals are considered equivalent (foot = feet). The languages supported here are either every language (this is the default, see list of languages below), or those set by queryLanguages. False: disables ignore plurals, where singulars and plurals are not considered the same for matching purposes (foot will not find feet).
4
+ * Treats singular, plurals, and other forms of declensions as matching terms. `ignorePlurals` is used in conjunction with the `queryLanguages` setting. _list_: language ISO codes for which ignoring plurals should be enabled. This list will override any values that you may have set in `queryLanguages`. _true_: enables the ignore plurals feature, where singulars and plurals are considered equivalent (\"foot\" = \"feet\"). The languages supported here are either [every language](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/) (this is the default) or those set by `queryLanguages`. _false_: turns off the ignore plurals feature, so that singulars and plurals aren\'t considered to be the same (\"foot\" will not find \"feet\").
5
5
  */
6
6
  export type IgnorePlurals = string[] | boolean;
package/model/index.ts CHANGED
@@ -2,8 +2,11 @@
2
2
 
3
3
  export * from './advancedSyntaxFeatures';
4
4
  export * from './alternativesAsExact';
5
+ export * from './anchoring';
5
6
  export * from './aroundRadius';
6
7
  export * from './aroundRadiusAll';
8
+ export * from './automaticFacetFilter';
9
+ export * from './automaticFacetFilters';
7
10
  export * from './baseRecommendRequest';
8
11
  export * from './baseRecommendationRequest';
9
12
  export * from './baseSearchParams';
@@ -11,13 +14,23 @@ export * from './baseSearchParamsWithoutQuery';
11
14
  export * from './baseSearchResponse';
12
15
  export * from './baseSearchResponseRedirect';
13
16
  export * from './baseTrendingRequest';
17
+ export * from './condition';
18
+ export * from './consequence';
19
+ export * from './consequenceHide';
20
+ export * from './consequenceParams';
21
+ export * from './consequenceQuery';
22
+ export * from './consequenceQueryObject';
23
+ export * from './deletedAtResponse';
14
24
  export * from './distinct';
25
+ export * from './edit';
26
+ export * from './editType';
15
27
  export * from './errorBase';
16
28
  export * from './exactOnSingleWordQuery';
17
29
  export * from './facetFilters';
18
30
  export * from './facetOrdering';
19
31
  export * from './facets';
20
32
  export * from './facetsStats';
33
+ export * from './getRecommendTaskResponse';
21
34
  export * from './getRecommendationsParams';
22
35
  export * from './getRecommendationsResponse';
23
36
  export * from './highlightResult';
@@ -31,12 +44,17 @@ export * from './mixedSearchFilters';
31
44
  export * from './mode';
32
45
  export * from './numericFilters';
33
46
  export * from './optionalFilters';
47
+ export * from './params';
34
48
  export * from './personalization';
49
+ export * from './promote';
50
+ export * from './promoteObjectID';
51
+ export * from './promoteObjectIDs';
35
52
  export * from './queryType';
36
53
  export * from './rankingInfo';
37
54
  export * from './reRankingApplyFilter';
38
55
  export * from './recommendHit';
39
56
  export * from './recommendHits';
57
+ export * from './recommendModels';
40
58
  export * from './recommendationModels';
41
59
  export * from './recommendationRequest';
42
60
  export * from './recommendationsRequest';
@@ -46,12 +64,17 @@ export * from './redirectRuleIndexMetadataData';
46
64
  export * from './removeStopWords';
47
65
  export * from './removeWordsIfNoResults';
48
66
  export * from './renderingContent';
67
+ export * from './ruleResponse';
68
+ export * from './ruleResponseMetadata';
49
69
  export * from './searchParamsObject';
50
70
  export * from './searchParamsQuery';
71
+ export * from './searchRecommendRulesParams';
72
+ export * from './searchRecommendRulesResponse';
51
73
  export * from './snippetResult';
52
74
  export * from './snippetResultOption';
53
75
  export * from './sortRemainingBy';
54
76
  export * from './tagFilters';
77
+ export * from './taskStatus';
55
78
  export * from './trendingModels';
56
79
  export * from './trendingRequest';
57
80
  export * from './typoTolerance';
@@ -15,52 +15,52 @@ import type { TypoTolerance } from './typoTolerance';
15
15
 
16
16
  export type IndexSettingsAsSearchParams = {
17
17
  /**
18
- * The complete list of attributes that will be used for faceting.
18
+ * Attributes used for [faceting](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/) and the [modifiers](https://www.algolia.com/doc/api-reference/api-parameters/attributesForFaceting/#modifiers) that can be applied: `filterOnly`, `searchable`, and `afterDistinct`.
19
19
  */
20
20
  attributesForFaceting?: string[];
21
21
 
22
22
  /**
23
- * This parameter controls which attributes to retrieve and which not to retrieve.
23
+ * Attributes to include in the API response. To reduce the size of your response, you can retrieve only some of the attributes. By default, the response includes all attributes.
24
24
  */
25
25
  attributesToRetrieve?: string[];
26
26
 
27
27
  /**
28
- * Restricts a given query to look in only a subset of your searchable attributes.
28
+ * Restricts a query to only look at a subset of your [searchable attributes](https://www.algolia.com/doc/guides/managing-results/must-do/searchable-attributes/).
29
29
  */
30
30
  restrictSearchableAttributes?: string[];
31
31
 
32
32
  /**
33
- * Controls how Algolia should sort your results.
33
+ * Determines the order in which Algolia [returns your results](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/).
34
34
  */
35
35
  ranking?: string[];
36
36
 
37
37
  /**
38
- * Specifies the custom ranking criterion.
38
+ * Specifies the [Custom ranking criterion](https://www.algolia.com/doc/guides/managing-results/must-do/custom-ranking/). Use the `asc` and `desc` modifiers to specify the ranking order: ascending or descending.
39
39
  */
40
40
  customRanking?: string[];
41
41
 
42
42
  /**
43
- * Controls the relevancy threshold below which less relevant results aren\'t included in the results.
43
+ * Relevancy threshold below which less relevant results aren\'t included in the results.
44
44
  */
45
45
  relevancyStrictness?: number;
46
46
 
47
47
  /**
48
- * List of attributes to highlight.
48
+ * Attributes to highlight. Strings that match the search query in the attributes are highlighted by surrounding them with HTML tags (`highlightPreTag` and `highlightPostTag`).
49
49
  */
50
50
  attributesToHighlight?: string[];
51
51
 
52
52
  /**
53
- * List of attributes to snippet, with an optional maximum number of words to snippet.
53
+ * Attributes to _snippet_. \'Snippeting\' is shortening the attribute to a certain number of words. If not specified, the attribute is shortened to the 10 words around the matching string but you can specify the number. For example: `body:20`.
54
54
  */
55
55
  attributesToSnippet?: string[];
56
56
 
57
57
  /**
58
- * The HTML string to insert before the highlighted parts in all highlight and snippet results.
58
+ * HTML string to insert before the highlighted parts in all highlight and snippet results.
59
59
  */
60
60
  highlightPreTag?: string;
61
61
 
62
62
  /**
63
- * The HTML string to insert after the highlighted parts in all highlight and snippet results.
63
+ * HTML string to insert after the highlighted parts in all highlight and snippet results.
64
64
  */
65
65
  highlightPostTag?: string;
66
66
 
@@ -75,17 +75,17 @@ export type IndexSettingsAsSearchParams = {
75
75
  restrictHighlightAndSnippetArrays?: boolean;
76
76
 
77
77
  /**
78
- * Set the number of hits per page.
78
+ * Number of hits per page.
79
79
  */
80
80
  hitsPerPage?: number;
81
81
 
82
82
  /**
83
- * Minimum number of characters a word in the query string must contain to accept matches with 1 typo.
83
+ * Minimum number of characters a word in the query string must contain to accept matches with [one typo](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance/#configuring-word-length-for-typos).
84
84
  */
85
85
  minWordSizefor1Typo?: number;
86
86
 
87
87
  /**
88
- * Minimum number of characters a word in the query string must contain to accept matches with 2 typos.
88
+ * Minimum number of characters a word in the query string must contain to accept matches with [two typos](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance/#configuring-word-length-for-typos).
89
89
  */
90
90
  minWordSizefor2Typos?: number;
91
91
 
@@ -97,7 +97,7 @@ export type IndexSettingsAsSearchParams = {
97
97
  allowTyposOnNumericTokens?: boolean;
98
98
 
99
99
  /**
100
- * List of attributes on which you want to disable typo tolerance.
100
+ * Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/).
101
101
  */
102
102
  disableTypoToleranceOnAttributes?: string[];
103
103
 
@@ -106,27 +106,27 @@ export type IndexSettingsAsSearchParams = {
106
106
  removeStopWords?: RemoveStopWords;
107
107
 
108
108
  /**
109
- * List of characters that the engine shouldn\'t automatically normalize.
109
+ * Characters that the engine shouldn\'t automatically [normalize](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/).
110
110
  */
111
111
  keepDiacriticsOnCharacters?: string;
112
112
 
113
113
  /**
114
- * Sets the languages to be used by language-specific settings and functionalities such as ignorePlurals, removeStopWords, and CJK word-detection.
114
+ * Sets your user\'s search language. This adjusts language-specific settings and features such as `ignorePlurals`, `removeStopWords`, and [CJK](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/#normalization-for-logogram-based-languages-cjk) word detection.
115
115
  */
116
116
  queryLanguages?: string[];
117
117
 
118
118
  /**
119
- * Splits compound words into their composing atoms in the query.
119
+ * [Splits compound words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations/#splitting-compound-words) into their component word parts in the query.
120
120
  */
121
121
  decompoundQuery?: boolean;
122
122
 
123
123
  /**
124
- * Whether Rules should be globally enabled.
124
+ * Incidates whether [Rules](https://www.algolia.com/doc/guides/managing-results/rules/rules-overview/) are enabled.
125
125
  */
126
126
  enableRules?: boolean;
127
127
 
128
128
  /**
129
- * Enable the Personalization feature.
129
+ * Incidates whether [Personalization](https://www.algolia.com/doc/guides/personalization/what-is-personalization/) is enabled.
130
130
  */
131
131
  enablePersonalization?: boolean;
132
132
 
@@ -139,41 +139,41 @@ export type IndexSettingsAsSearchParams = {
139
139
  semanticSearch?: IndexSettingsAsSearchParamsSemanticSearch;
140
140
 
141
141
  /**
142
- * Enables the advanced query syntax.
142
+ * Enables the [advanced query syntax](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/#advanced-syntax).
143
143
  */
144
144
  advancedSyntax?: boolean;
145
145
 
146
146
  /**
147
- * A list of words that should be considered as optional when found in the query.
147
+ * Words which should be considered [optional](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/#creating-a-list-of-optional-words) when found in a query.
148
148
  */
149
149
  optionalWords?: string[];
150
150
 
151
151
  /**
152
- * List of attributes on which you want to disable the exact ranking criterion.
152
+ * Attributes for which you want to [turn off the exact ranking criterion](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/adjust-exact-settings/#turn-off-exact-for-some-attributes).
153
153
  */
154
154
  disableExactOnAttributes?: string[];
155
155
 
156
156
  exactOnSingleWordQuery?: ExactOnSingleWordQuery;
157
157
 
158
158
  /**
159
- * List of alternatives that should be considered an exact match by the exact ranking criterion.
159
+ * Alternatives that should be considered an exact match by [the exact ranking criterion](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/adjust-exact-settings/#turn-off-exact-for-some-attributes).
160
160
  */
161
161
  alternativesAsExact?: AlternativesAsExact[];
162
162
 
163
163
  /**
164
- * Allows you to specify which advanced syntax features are active when advancedSyntax\' is enabled.
164
+ * Allows you to specify which advanced syntax features are active when `advancedSyntax` is enabled.
165
165
  */
166
166
  advancedSyntaxFeatures?: AdvancedSyntaxFeatures[];
167
167
 
168
168
  /**
169
- * Enriches the APIs response with meta-information as to how the query was processed.
169
+ * Enriches the API\'s response with information about how the query was processed.
170
170
  */
171
171
  explain?: string[];
172
172
 
173
173
  distinct?: Distinct;
174
174
 
175
175
  /**
176
- * Name of the de-duplication attribute to be used with the distinct feature.
176
+ * Name of the deduplication attribute to be used with Algolia\'s [_distinct_ feature](https://www.algolia.com/doc/guides/managing-results/refine-results/grouping/#introducing-algolias-distinct-feature).
177
177
  */
178
178
  attributeForDistinct?: string;
179
179
 
@@ -188,22 +188,22 @@ export type IndexSettingsAsSearchParams = {
188
188
  replaceSynonymsInHighlight?: boolean;
189
189
 
190
190
  /**
191
- * Precision of the proximity ranking criterion.
191
+ * Precision of the [proximity ranking criterion](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/#proximity).
192
192
  */
193
193
  minProximity?: number;
194
194
 
195
195
  /**
196
- * Choose which fields to return in the API response. This parameters applies to search and browse queries.
196
+ * Attributes to include in the API response for search and browse queries.
197
197
  */
198
198
  responseFields?: string[];
199
199
 
200
200
  /**
201
- * Maximum number of facet hits to return during a search for facet values. For performance reasons, the maximum allowed number of returned values is 100.
201
+ * Maximum number of facet hits to return when [searching for facet values](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#search-for-facet-values).
202
202
  */
203
203
  maxFacetHits?: number;
204
204
 
205
205
  /**
206
- * When attribute is ranked above proximity in your ranking formula, proximity is used to select which searchable attribute is matched in the attribute ranking stage.
206
+ * When the [Attribute criterion is ranked above Proximity](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/#attribute-and-proximity-combinations) in your ranking formula, Proximity is used to select which searchable attribute is matched in the Attribute ranking stage.
207
207
  */
208
208
  attributeCriteriaComputedByMinProximity?: boolean;
209
209
 
@@ -1,11 +1,11 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * The settings relevant for configuration of the semantic search engine. These settings are only used when the mode is set to \'neuralSearch\'.
4
+ * Settings for the semantic search part of NeuralSearch. Only used when `mode` is _neuralSearch_.
5
5
  */
6
6
  export type IndexSettingsAsSearchParamsSemanticSearch = {
7
7
  /**
8
- * When null, the current index / replica group will be used as the event source.
8
+ * Indices from which to collect click and conversion events. If null, the current index and replica group will be used as the event source.
9
9
  */
10
10
  eventSources?: string[] | null;
11
11
  };
package/model/mode.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * The search mode that the index will use to query for results.
4
+ * Search mode the index will use to query for results.
5
5
  */
6
6
  export type Mode = 'keywordSearch' | 'neuralSearch';
@@ -3,6 +3,6 @@
3
3
  import type { MixedSearchFilters } from './mixedSearchFilters';
4
4
 
5
5
  /**
6
- * Filter on numeric attributes.
6
+ * [Filter on numeric attributes](https://www.algolia.com/doc/api-reference/api-parameters/numericFilters/).
7
7
  */
8
8
  export type NumericFilters = MixedSearchFilters[] | string;
@@ -3,6 +3,6 @@
3
3
  import type { MixedSearchFilters } from './mixedSearchFilters';
4
4
 
5
5
  /**
6
- * Create filters for ranking purposes, where records that match the filter are ranked higher, or lower in the case of a negative optional filter.
6
+ * Create filters to boost or demote records. Records that match the filter are ranked higher for positive and lower for negative optional filters. In contrast to regular filters, records that don\'t match the optional filter are still included in the results, only their ranking is affected.
7
7
  */
8
8
  export type OptionalFilters = MixedSearchFilters[] | string;
@@ -0,0 +1,18 @@
1
+ // 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.
2
+
3
+ import type { AutomaticFacetFilters } from './automaticFacetFilters';
4
+ import type { ConsequenceQuery } from './consequenceQuery';
5
+ import type { RenderingContent } from './renderingContent';
6
+
7
+ /**
8
+ * Additional search parameters.
9
+ */
10
+ export type Params = {
11
+ query?: ConsequenceQuery;
12
+
13
+ automaticFacetFilters?: AutomaticFacetFilters;
14
+
15
+ automaticOptionalFacetFilters?: AutomaticFacetFilters;
16
+
17
+ renderingContent?: RenderingContent;
18
+ };
@@ -0,0 +1,6 @@
1
+ // 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.
2
+
3
+ import type { PromoteObjectID } from './promoteObjectID';
4
+ import type { PromoteObjectIDs } from './promoteObjectIDs';
5
+
6
+ export type Promote = PromoteObjectID | PromoteObjectIDs;
@@ -0,0 +1,16 @@
1
+ // 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.
2
+
3
+ /**
4
+ * Record to promote.
5
+ */
6
+ export type PromoteObjectID = {
7
+ /**
8
+ * Unique identifier of the record to promote.
9
+ */
10
+ objectID: string;
11
+
12
+ /**
13
+ * The position to promote the records to. If you pass objectIDs, the records are placed at this position as a group. For example, if you pronmote four objectIDs to position 0, the records take the first four positions.
14
+ */
15
+ position: number;
16
+ };
@@ -0,0 +1,16 @@
1
+ // 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.
2
+
3
+ /**
4
+ * Records to promote.
5
+ */
6
+ export type PromoteObjectIDs = {
7
+ /**
8
+ * Unique identifiers of the records to promote.
9
+ */
10
+ objectIDs: string[];
11
+
12
+ /**
13
+ * The position to promote the records to. If you pass objectIDs, the records are placed at this position as a group. For example, if you pronmote four objectIDs to position 0, the records take the first four positions.
14
+ */
15
+ position: number;
16
+ };
@@ -1,6 +1,6 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * Controls if and how query words are interpreted as prefixes.
4
+ * Determines how query words are [interpreted as prefixes](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/prefix-searching/).
5
5
  */
6
6
  export type QueryType = 'prefixAll' | 'prefixLast' | 'prefixNone';
@@ -3,6 +3,6 @@
3
3
  import type { MixedSearchFilters } from './mixedSearchFilters';
4
4
 
5
5
  /**
6
- * When Dynamic Re-Ranking is enabled, only records that match these filters will be impacted by Dynamic Re-Ranking.
6
+ * When [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking/) is enabled, only records that match these filters will be affected by Dynamic Re-Ranking.
7
7
  */
8
8
  export type ReRankingApplyFilter = MixedSearchFilters[] | string;
@@ -5,11 +5,11 @@ import type { RankingInfo } from './rankingInfo';
5
5
  import type { SnippetResult } from './snippetResult';
6
6
 
7
7
  /**
8
- * A Recommend hit.
8
+ * Recommend hit.
9
9
  */
10
10
  export type RecommendHit = Record<string, any> & {
11
11
  /**
12
- * Unique identifier of the object.
12
+ * Unique object identifier.
13
13
  */
14
14
  objectID: string;
15
15
 
@@ -28,7 +28,7 @@ export type RecommendHit = Record<string, any> & {
28
28
  _distinctSeqID?: number;
29
29
 
30
30
  /**
31
- * The recommendation score.
31
+ * Recommendation score.
32
32
  */
33
33
  _score: number;
34
34
  };
@@ -0,0 +1,7 @@
1
+ // 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.
2
+
3
+ export type RecommendModels =
4
+ | 'bought-together'
5
+ | 'related-products'
6
+ | 'trending-facets'
7
+ | 'trending-items';
@@ -1,6 +1,6 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * The recommendation model to use.
4
+ * Recommendation model.
5
5
  */
6
6
  export type RecommendationModels = 'bought-together' | 'related-products';
@@ -19,7 +19,7 @@ export type RedirectRuleIndexMetadata = {
19
19
  reason: string;
20
20
 
21
21
  /**
22
- * Status for the redirect rule.
22
+ * Redirect rule status.
23
23
  */
24
24
  succeed: boolean;
25
25
 
@@ -1,7 +1,7 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * Data for the redirect rule.
4
+ * Redirect rule data.
5
5
  */
6
6
  export type RedirectRuleIndexMetadataData = {
7
7
  ruleObjectID: string;
@@ -1,6 +1,6 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * Removes stop (common) words from the query before executing it. RemoveStopWords is used in conjunction with the queryLanguages setting. List: language ISO codes for which ignoring plurals should be enabled. This list will override any values that you may have set in queryLanguages. True: enables the stop word functionality, ensuring that stop words are removed from consideration in a search. The languages supported here are either every language, or those set by queryLanguages. False: disables stop word functionality, allowing stop words to be taken into account in a search.
4
+ * Removes stop (common) words from the query before executing it. `removeStopWords` is used in conjunction with the `queryLanguages` setting. _list_: language ISO codes for which stop words should be enabled. This list will override any values that you may have set in `queryLanguages`. _true_: enables the stop words feature, ensuring that stop words are removed from consideration in a search. The languages supported here are either [every language](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/) (this is the default) or those set by `queryLanguages`. _false_: turns off the stop words feature, allowing stop words to be taken into account in a search.
5
5
  */
6
6
  export type RemoveStopWords = string[] | boolean;
@@ -1,7 +1,7 @@
1
1
  // 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.
2
2
 
3
3
  /**
4
- * Selects a strategy to remove words from the query when it doesn\'t match any hits.
4
+ * Strategy to [remove words](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/in-depth/why-use-remove-words-if-no-results/) from the query when it doesn\'t match any hits.
5
5
  */
6
6
  export type RemoveWordsIfNoResults =
7
7
  | 'allOptional'
@@ -3,7 +3,7 @@
3
3
  import type { FacetOrdering } from './facetOrdering';
4
4
 
5
5
  /**
6
- * Content defining how the search interface should be rendered. Can be set via the settings for a default value and can be overridden via rules.
6
+ * Extra content for the search UI, for example, to control the [ordering and display of facets](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/merchandising-facets/#merchandise-facets-and-their-values-in-the-manual-editor). You can set a default value and dynamically override it with [Rules](https://www.algolia.com/doc/guides/managing-results/rules/rules-overview/).
7
7
  */
8
8
  export type RenderingContent = {
9
9
  facetOrdering?: FacetOrdering;
@@ -0,0 +1,34 @@
1
+ // 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.
2
+
3
+ import type { Condition } from './condition';
4
+ import type { Consequence } from './consequence';
5
+ import type { RuleResponseMetadata } from './ruleResponseMetadata';
6
+
7
+ /**
8
+ * Rule object.
9
+ */
10
+ export type RuleResponse = {
11
+ _metadata?: RuleResponseMetadata;
12
+
13
+ /**
14
+ * Unique identifier for a rule object.
15
+ */
16
+ objectID: string;
17
+
18
+ /**
19
+ * [Conditions](https://www.algolia.com/doc/guides/managing-results/rules/rules-overview/#conditions) required to activate a rule. You can use up to 25 conditions per rule.
20
+ */
21
+ conditions?: Condition[];
22
+
23
+ consequence?: Consequence;
24
+
25
+ /**
26
+ * Description of the rule\'s purpose. This can be helpful for display in the Algolia dashboard.
27
+ */
28
+ description?: string;
29
+
30
+ /**
31
+ * Indicates whether to enable the rule. If it isn\'t enabled, it isn\'t applied at query time.
32
+ */
33
+ enabled?: boolean;
34
+ };