@algolia/recommend 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 (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
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Selects a strategy to remove words from the query when it doesn\'t match any hits.
2
+ * 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.
3
3
  */
4
4
  export type RemoveWordsIfNoResults = 'allOptional' | 'firstWords' | 'lastWords' | 'none';
5
5
  //# sourceMappingURL=removeWordsIfNoResults.d.ts.map
@@ -1,6 +1,6 @@
1
1
  import type { FacetOrdering } from './facetOrdering';
2
2
  /**
3
- * 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.
3
+ * 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/).
4
4
  */
5
5
  export type RenderingContent = {
6
6
  facetOrdering?: FacetOrdering;
@@ -0,0 +1,27 @@
1
+ import type { Condition } from './condition';
2
+ import type { Consequence } from './consequence';
3
+ import type { RuleResponseMetadata } from './ruleResponseMetadata';
4
+ /**
5
+ * Rule object.
6
+ */
7
+ export type RuleResponse = {
8
+ _metadata?: RuleResponseMetadata;
9
+ /**
10
+ * Unique identifier for a rule object.
11
+ */
12
+ objectID: string;
13
+ /**
14
+ * [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.
15
+ */
16
+ conditions?: Condition[];
17
+ consequence?: Consequence;
18
+ /**
19
+ * Description of the rule\'s purpose. This can be helpful for display in the Algolia dashboard.
20
+ */
21
+ description?: string;
22
+ /**
23
+ * Indicates whether to enable the rule. If it isn\'t enabled, it isn\'t applied at query time.
24
+ */
25
+ enabled?: boolean;
26
+ };
27
+ //# sourceMappingURL=ruleResponse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ruleResponse.d.ts","sourceRoot":"","sources":["../../model/ruleResponse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAEjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IAEzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC"}
@@ -0,0 +1,7 @@
1
+ export type RuleResponseMetadata = {
2
+ /**
3
+ * Timestamp of the last update in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format.
4
+ */
5
+ lastUpdate?: string;
6
+ };
7
+ //# sourceMappingURL=ruleResponseMetadata.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ruleResponseMetadata.d.ts","sourceRoot":"","sources":["../../model/ruleResponseMetadata.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC"}
@@ -1,6 +1,6 @@
1
1
  export type SearchParamsQuery = {
2
2
  /**
3
- * The text to search in the index.
3
+ * Text to search for in an index.
4
4
  */
5
5
  query?: string;
6
6
  };
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Recommend rules search parameters.
3
+ */
4
+ export type SearchRecommendRulesParams = {
5
+ /**
6
+ * Full-text query.
7
+ */
8
+ query?: string;
9
+ /**
10
+ * Restricts responses to the specified [contextual rule](https://www.algolia.com/doc/guides/managing-results/rules/rules-overview/how-to/customize-search-results-by-platform/#creating-contextual-rules).
11
+ */
12
+ context?: string;
13
+ /**
14
+ * Requested page (the first page is page 0).
15
+ */
16
+ page?: number;
17
+ /**
18
+ * Maximum number of hits per page.
19
+ */
20
+ hitsPerPage?: number;
21
+ /**
22
+ * Restricts responses to enabled rules. When absent (default), _all_ rules are retrieved.
23
+ */
24
+ enabled?: boolean | null;
25
+ /**
26
+ * Request options to send with the API call.
27
+ */
28
+ _requestOptions?: Array<Record<string, any>>;
29
+ };
30
+ //# sourceMappingURL=searchRecommendRulesParams.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"searchRecommendRulesParams.d.ts","sourceRoot":"","sources":["../../model/searchRecommendRulesParams.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CAC9C,CAAC"}
@@ -0,0 +1,20 @@
1
+ import type { RuleResponse } from './ruleResponse';
2
+ export type SearchRecommendRulesResponse = {
3
+ /**
4
+ * Fetched rules.
5
+ */
6
+ hits: RuleResponse[];
7
+ /**
8
+ * Number of fetched rules.
9
+ */
10
+ nbHits: number;
11
+ /**
12
+ * Current page.
13
+ */
14
+ page: number;
15
+ /**
16
+ * Number of pages.
17
+ */
18
+ nbPages: number;
19
+ };
20
+ //# sourceMappingURL=searchRecommendRulesResponse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"searchRecommendRulesResponse.d.ts","sourceRoot":"","sources":["../../model/searchRecommendRulesResponse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,4BAA4B,GAAG;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,EAAE,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}
@@ -4,7 +4,7 @@ import type { MatchLevel } from './matchLevel';
4
4
  */
5
5
  export type SnippetResultOption = {
6
6
  /**
7
- * Markup text with occurrences highlighted.
7
+ * Markup text with `facetQuery` matches highlighted.
8
8
  */
9
9
  value: string;
10
10
  matchLevel: MatchLevel;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * How to display the remaining items. - `count`: facet count (descending). - `alpha`: alphabetical (ascending). - `hidden`: show only pinned values.
2
+ * How to display the remaining items: - `count`: facet count (descending). - `alpha`: alphabetical (ascending). - `hidden`: show only pinned values.
3
3
  */
4
4
  export type SortRemainingBy = 'alpha' | 'count' | 'hidden';
5
5
  //# sourceMappingURL=sortRemainingBy.d.ts.map
@@ -1,6 +1,6 @@
1
1
  import type { MixedSearchFilters } from './mixedSearchFilters';
2
2
  /**
3
- * Filter hits by tags.
3
+ * [Filter hits by tags](https://www.algolia.com/doc/api-reference/api-parameters/tagFilters/).
4
4
  */
5
5
  export type TagFilters = MixedSearchFilters[] | string;
6
6
  //# sourceMappingURL=tagFilters.d.ts.map
@@ -0,0 +1,5 @@
1
+ /**
2
+ * _published_ if the task has been processed, _notPublished_ otherwise.
3
+ */
4
+ export type TaskStatus = 'notPublished' | 'published';
5
+ //# sourceMappingURL=taskStatus.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"taskStatus.d.ts","sourceRoot":"","sources":["../../model/taskStatus.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,WAAW,CAAC"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * The trending model to use.
2
+ * Trending model.
3
3
  */
4
4
  export type TrendingModels = 'trending-facets' | 'trending-items';
5
5
  //# sourceMappingURL=trendingModels.d.ts.map
@@ -1,6 +1,6 @@
1
1
  import type { TypoToleranceEnum } from './typoToleranceEnum';
2
2
  /**
3
- * Controls whether typo tolerance is enabled and how it is applied.
3
+ * Controls whether [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/) is enabled and how it is applied.
4
4
  */
5
5
  export type TypoTolerance = TypoToleranceEnum | boolean;
6
6
  //# sourceMappingURL=typoTolerance.d.ts.map
@@ -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 = '5.0.0-alpha.72';
7
+ const apiClientVersion = '5.0.0-alpha.75';
10
8
  function getDefaultHosts(appId) {
11
9
  return [
12
10
  {
@@ -93,8 +91,8 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
93
91
  *
94
92
  * @summary Send requests to the Algolia REST API.
95
93
  * @param del - The del object.
96
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
97
- * @param del.parameters - Query parameters to be applied to the current query.
94
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
95
+ * @param del.parameters - Query parameters to apply to the current query.
98
96
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
99
97
  */
100
98
  del({ path, parameters }, requestOptions) {
@@ -112,13 +110,47 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
112
110
  };
113
111
  return transporter.request(request, requestOptions);
114
112
  },
113
+ /**
114
+ * Delete a [Recommend rule](https://www.algolia.com/doc/guides/algolia-recommend/how-to/rules/).
115
+ *
116
+ * @summary Delete a Recommend rule.
117
+ * @param deleteRecommendRule - The deleteRecommendRule object.
118
+ * @param deleteRecommendRule.indexName - Index on which to perform the request.
119
+ * @param deleteRecommendRule.model - [Recommend models](https://www.algolia.com/doc/guides/algolia-recommend/overview/#recommend-models).
120
+ * @param deleteRecommendRule.objectID - Unique record (object) identifier.
121
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
122
+ */
123
+ deleteRecommendRule({ indexName, model, objectID }, requestOptions) {
124
+ if (!indexName) {
125
+ throw new Error('Parameter `indexName` is required when calling `deleteRecommendRule`.');
126
+ }
127
+ if (!model) {
128
+ throw new Error('Parameter `model` is required when calling `deleteRecommendRule`.');
129
+ }
130
+ if (!objectID) {
131
+ throw new Error('Parameter `objectID` is required when calling `deleteRecommendRule`.');
132
+ }
133
+ const requestPath = '/1/indexes/{indexName}/{model}/recommend/rules/{objectID}'
134
+ .replace('{indexName}', encodeURIComponent(indexName))
135
+ .replace('{model}', encodeURIComponent(model))
136
+ .replace('{objectID}', encodeURIComponent(objectID));
137
+ const headers = {};
138
+ const queryParameters = {};
139
+ const request = {
140
+ method: 'DELETE',
141
+ path: requestPath,
142
+ queryParameters,
143
+ headers,
144
+ };
145
+ return transporter.request(request, requestOptions);
146
+ },
115
147
  /**
116
148
  * This method allow you to send requests to the Algolia REST API.
117
149
  *
118
150
  * @summary Send requests to the Algolia REST API.
119
151
  * @param get - The get object.
120
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
121
- * @param get.parameters - Query parameters to be applied to the current query.
152
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
153
+ * @param get.parameters - Query parameters to apply to the current query.
122
154
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
123
155
  */
124
156
  get({ path, parameters }, requestOptions) {
@@ -137,9 +169,77 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
137
169
  return transporter.request(request, requestOptions);
138
170
  },
139
171
  /**
140
- * Returns recommendations or trending results, for a specific model and `objectID`.
172
+ * Return a [Recommend rule](https://www.algolia.com/doc/guides/algolia-recommend/how-to/rules/).
173
+ *
174
+ * @summary Get a Recommend rule.
175
+ * @param getRecommendRule - The getRecommendRule object.
176
+ * @param getRecommendRule.indexName - Index on which to perform the request.
177
+ * @param getRecommendRule.model - [Recommend models](https://www.algolia.com/doc/guides/algolia-recommend/overview/#recommend-models).
178
+ * @param getRecommendRule.objectID - Unique record (object) identifier.
179
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
180
+ */
181
+ getRecommendRule({ indexName, model, objectID }, requestOptions) {
182
+ if (!indexName) {
183
+ throw new Error('Parameter `indexName` is required when calling `getRecommendRule`.');
184
+ }
185
+ if (!model) {
186
+ throw new Error('Parameter `model` is required when calling `getRecommendRule`.');
187
+ }
188
+ if (!objectID) {
189
+ throw new Error('Parameter `objectID` is required when calling `getRecommendRule`.');
190
+ }
191
+ const requestPath = '/1/indexes/{indexName}/{model}/recommend/rules/{objectID}'
192
+ .replace('{indexName}', encodeURIComponent(indexName))
193
+ .replace('{model}', encodeURIComponent(model))
194
+ .replace('{objectID}', encodeURIComponent(objectID));
195
+ const headers = {};
196
+ const queryParameters = {};
197
+ const request = {
198
+ method: 'GET',
199
+ path: requestPath,
200
+ queryParameters,
201
+ headers,
202
+ };
203
+ return transporter.request(request, requestOptions);
204
+ },
205
+ /**
206
+ * Some operations, such as deleting a Recommend rule, will respond with a `taskID` value. Use this value here to check the status of that task.
141
207
  *
142
- * @summary Get results.
208
+ * @summary Get a Recommend task\'s status.
209
+ * @param getRecommendStatus - The getRecommendStatus object.
210
+ * @param getRecommendStatus.indexName - Index on which to perform the request.
211
+ * @param getRecommendStatus.model - [Recommend models](https://www.algolia.com/doc/guides/algolia-recommend/overview/#recommend-models).
212
+ * @param getRecommendStatus.taskID - Unique identifier of a task. Numeric value (up to 64bits).
213
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
214
+ */
215
+ getRecommendStatus({ indexName, model, taskID }, requestOptions) {
216
+ if (!indexName) {
217
+ throw new Error('Parameter `indexName` is required when calling `getRecommendStatus`.');
218
+ }
219
+ if (!model) {
220
+ throw new Error('Parameter `model` is required when calling `getRecommendStatus`.');
221
+ }
222
+ if (!taskID) {
223
+ throw new Error('Parameter `taskID` is required when calling `getRecommendStatus`.');
224
+ }
225
+ const requestPath = '/1/indexes/{indexName}/{model}/task/{taskID}'
226
+ .replace('{indexName}', encodeURIComponent(indexName))
227
+ .replace('{model}', encodeURIComponent(model))
228
+ .replace('{taskID}', encodeURIComponent(taskID));
229
+ const headers = {};
230
+ const queryParameters = {};
231
+ const request = {
232
+ method: 'GET',
233
+ path: requestPath,
234
+ queryParameters,
235
+ headers,
236
+ };
237
+ return transporter.request(request, requestOptions);
238
+ },
239
+ /**
240
+ * Returns results from either recommendation or trending models: - **Recommendations** are provided by the [Related Products](https://www.algolia.com/doc/guides/algolia-recommend/overview/#related-products-and-related-content) and [Frequently Bought Together](https://www.algolia.com/doc/guides/algolia-recommend/overview/#frequently-bought-together) models - **Trending** models are [Trending Items and Trending Facet Values](https://www.algolia.com/doc/guides/algolia-recommend/overview/#trending-items-and-trending-facet-values).
241
+ *
242
+ * @summary Get recommendations and trending items.
143
243
  * @param getRecommendationsParams - The getRecommendationsParams object.
144
244
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
145
245
  */
@@ -169,9 +269,9 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
169
269
  *
170
270
  * @summary Send requests to the Algolia REST API.
171
271
  * @param post - The post object.
172
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
173
- * @param post.parameters - Query parameters to be applied to the current query.
174
- * @param post.body - The parameters to send with the custom request.
272
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
273
+ * @param post.parameters - Query parameters to apply to the current query.
274
+ * @param post.body - Parameters to send with the custom request.
175
275
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
176
276
  */
177
277
  post({ path, parameters, body }, requestOptions) {
@@ -195,9 +295,9 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
195
295
  *
196
296
  * @summary Send requests to the Algolia REST API.
197
297
  * @param put - The put object.
198
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
199
- * @param put.parameters - Query parameters to be applied to the current query.
200
- * @param put.body - The parameters to send with the custom request.
298
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
299
+ * @param put.parameters - Query parameters to apply to the current query.
300
+ * @param put.body - Parameters to send with the custom request.
201
301
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
202
302
  */
203
303
  put({ path, parameters, body }, requestOptions) {
@@ -216,6 +316,39 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
216
316
  };
217
317
  return transporter.request(request, requestOptions);
218
318
  },
319
+ /**
320
+ * List [Recommend rules](https://www.algolia.com/doc/guides/algolia-recommend/how-to/rules/).
321
+ *
322
+ * @summary List Recommend rules.
323
+ * @param searchRecommendRules - The searchRecommendRules object.
324
+ * @param searchRecommendRules.indexName - Index on which to perform the request.
325
+ * @param searchRecommendRules.model - [Recommend models](https://www.algolia.com/doc/guides/algolia-recommend/overview/#recommend-models).
326
+ * @param searchRecommendRules.searchRecommendRulesParams - The searchRecommendRulesParams object.
327
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
328
+ */
329
+ searchRecommendRules({ indexName, model, searchRecommendRulesParams, }, requestOptions) {
330
+ if (!indexName) {
331
+ throw new Error('Parameter `indexName` is required when calling `searchRecommendRules`.');
332
+ }
333
+ if (!model) {
334
+ throw new Error('Parameter `model` is required when calling `searchRecommendRules`.');
335
+ }
336
+ const requestPath = '/1/indexes/{indexName}/{model}/recommend/rules/search'
337
+ .replace('{indexName}', encodeURIComponent(indexName))
338
+ .replace('{model}', encodeURIComponent(model));
339
+ const headers = {};
340
+ const queryParameters = {};
341
+ const request = {
342
+ method: 'POST',
343
+ path: requestPath,
344
+ queryParameters,
345
+ headers,
346
+ data: searchRecommendRulesParams ? searchRecommendRulesParams : {},
347
+ useReadTransporter: true,
348
+ cacheable: true,
349
+ };
350
+ return transporter.request(request, requestOptions);
351
+ },
219
352
  };
220
353
  }
221
354
 
@@ -673,7 +673,7 @@ function createXhrRequester() {
673
673
  }
674
674
 
675
675
  // 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.
676
- const apiClientVersion = '5.0.0-alpha.72';
676
+ const apiClientVersion = '5.0.0-alpha.75';
677
677
  function getDefaultHosts(appId) {
678
678
  return [
679
679
  {
@@ -760,8 +760,8 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
760
760
  *
761
761
  * @summary Send requests to the Algolia REST API.
762
762
  * @param del - The del object.
763
- * @param del.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
764
- * @param del.parameters - Query parameters to be applied to the current query.
763
+ * @param del.path - Path of the endpoint, anything after \"/1\" must be specified.
764
+ * @param del.parameters - Query parameters to apply to the current query.
765
765
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
766
766
  */
767
767
  del({ path, parameters }, requestOptions) {
@@ -779,13 +779,47 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
779
779
  };
780
780
  return transporter.request(request, requestOptions);
781
781
  },
782
+ /**
783
+ * Delete a [Recommend rule](https://www.algolia.com/doc/guides/algolia-recommend/how-to/rules/).
784
+ *
785
+ * @summary Delete a Recommend rule.
786
+ * @param deleteRecommendRule - The deleteRecommendRule object.
787
+ * @param deleteRecommendRule.indexName - Index on which to perform the request.
788
+ * @param deleteRecommendRule.model - [Recommend models](https://www.algolia.com/doc/guides/algolia-recommend/overview/#recommend-models).
789
+ * @param deleteRecommendRule.objectID - Unique record (object) identifier.
790
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
791
+ */
792
+ deleteRecommendRule({ indexName, model, objectID }, requestOptions) {
793
+ if (!indexName) {
794
+ throw new Error('Parameter `indexName` is required when calling `deleteRecommendRule`.');
795
+ }
796
+ if (!model) {
797
+ throw new Error('Parameter `model` is required when calling `deleteRecommendRule`.');
798
+ }
799
+ if (!objectID) {
800
+ throw new Error('Parameter `objectID` is required when calling `deleteRecommendRule`.');
801
+ }
802
+ const requestPath = '/1/indexes/{indexName}/{model}/recommend/rules/{objectID}'
803
+ .replace('{indexName}', encodeURIComponent(indexName))
804
+ .replace('{model}', encodeURIComponent(model))
805
+ .replace('{objectID}', encodeURIComponent(objectID));
806
+ const headers = {};
807
+ const queryParameters = {};
808
+ const request = {
809
+ method: 'DELETE',
810
+ path: requestPath,
811
+ queryParameters,
812
+ headers,
813
+ };
814
+ return transporter.request(request, requestOptions);
815
+ },
782
816
  /**
783
817
  * This method allow you to send requests to the Algolia REST API.
784
818
  *
785
819
  * @summary Send requests to the Algolia REST API.
786
820
  * @param get - The get object.
787
- * @param get.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
788
- * @param get.parameters - Query parameters to be applied to the current query.
821
+ * @param get.path - Path of the endpoint, anything after \"/1\" must be specified.
822
+ * @param get.parameters - Query parameters to apply to the current query.
789
823
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
790
824
  */
791
825
  get({ path, parameters }, requestOptions) {
@@ -804,9 +838,77 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
804
838
  return transporter.request(request, requestOptions);
805
839
  },
806
840
  /**
807
- * Returns recommendations or trending results, for a specific model and `objectID`.
841
+ * Return a [Recommend rule](https://www.algolia.com/doc/guides/algolia-recommend/how-to/rules/).
808
842
  *
809
- * @summary Get results.
843
+ * @summary Get a Recommend rule.
844
+ * @param getRecommendRule - The getRecommendRule object.
845
+ * @param getRecommendRule.indexName - Index on which to perform the request.
846
+ * @param getRecommendRule.model - [Recommend models](https://www.algolia.com/doc/guides/algolia-recommend/overview/#recommend-models).
847
+ * @param getRecommendRule.objectID - Unique record (object) identifier.
848
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
849
+ */
850
+ getRecommendRule({ indexName, model, objectID }, requestOptions) {
851
+ if (!indexName) {
852
+ throw new Error('Parameter `indexName` is required when calling `getRecommendRule`.');
853
+ }
854
+ if (!model) {
855
+ throw new Error('Parameter `model` is required when calling `getRecommendRule`.');
856
+ }
857
+ if (!objectID) {
858
+ throw new Error('Parameter `objectID` is required when calling `getRecommendRule`.');
859
+ }
860
+ const requestPath = '/1/indexes/{indexName}/{model}/recommend/rules/{objectID}'
861
+ .replace('{indexName}', encodeURIComponent(indexName))
862
+ .replace('{model}', encodeURIComponent(model))
863
+ .replace('{objectID}', encodeURIComponent(objectID));
864
+ const headers = {};
865
+ const queryParameters = {};
866
+ const request = {
867
+ method: 'GET',
868
+ path: requestPath,
869
+ queryParameters,
870
+ headers,
871
+ };
872
+ return transporter.request(request, requestOptions);
873
+ },
874
+ /**
875
+ * Some operations, such as deleting a Recommend rule, will respond with a `taskID` value. Use this value here to check the status of that task.
876
+ *
877
+ * @summary Get a Recommend task\'s status.
878
+ * @param getRecommendStatus - The getRecommendStatus object.
879
+ * @param getRecommendStatus.indexName - Index on which to perform the request.
880
+ * @param getRecommendStatus.model - [Recommend models](https://www.algolia.com/doc/guides/algolia-recommend/overview/#recommend-models).
881
+ * @param getRecommendStatus.taskID - Unique identifier of a task. Numeric value (up to 64bits).
882
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
883
+ */
884
+ getRecommendStatus({ indexName, model, taskID }, requestOptions) {
885
+ if (!indexName) {
886
+ throw new Error('Parameter `indexName` is required when calling `getRecommendStatus`.');
887
+ }
888
+ if (!model) {
889
+ throw new Error('Parameter `model` is required when calling `getRecommendStatus`.');
890
+ }
891
+ if (!taskID) {
892
+ throw new Error('Parameter `taskID` is required when calling `getRecommendStatus`.');
893
+ }
894
+ const requestPath = '/1/indexes/{indexName}/{model}/task/{taskID}'
895
+ .replace('{indexName}', encodeURIComponent(indexName))
896
+ .replace('{model}', encodeURIComponent(model))
897
+ .replace('{taskID}', encodeURIComponent(taskID));
898
+ const headers = {};
899
+ const queryParameters = {};
900
+ const request = {
901
+ method: 'GET',
902
+ path: requestPath,
903
+ queryParameters,
904
+ headers,
905
+ };
906
+ return transporter.request(request, requestOptions);
907
+ },
908
+ /**
909
+ * Returns results from either recommendation or trending models: - **Recommendations** are provided by the [Related Products](https://www.algolia.com/doc/guides/algolia-recommend/overview/#related-products-and-related-content) and [Frequently Bought Together](https://www.algolia.com/doc/guides/algolia-recommend/overview/#frequently-bought-together) models - **Trending** models are [Trending Items and Trending Facet Values](https://www.algolia.com/doc/guides/algolia-recommend/overview/#trending-items-and-trending-facet-values).
910
+ *
911
+ * @summary Get recommendations and trending items.
810
912
  * @param getRecommendationsParams - The getRecommendationsParams object.
811
913
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
812
914
  */
@@ -836,9 +938,9 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
836
938
  *
837
939
  * @summary Send requests to the Algolia REST API.
838
940
  * @param post - The post object.
839
- * @param post.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
840
- * @param post.parameters - Query parameters to be applied to the current query.
841
- * @param post.body - The parameters to send with the custom request.
941
+ * @param post.path - Path of the endpoint, anything after \"/1\" must be specified.
942
+ * @param post.parameters - Query parameters to apply to the current query.
943
+ * @param post.body - Parameters to send with the custom request.
842
944
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
843
945
  */
844
946
  post({ path, parameters, body }, requestOptions) {
@@ -862,9 +964,9 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
862
964
  *
863
965
  * @summary Send requests to the Algolia REST API.
864
966
  * @param put - The put object.
865
- * @param put.path - The path of the API endpoint to target, anything after the /1 needs to be specified.
866
- * @param put.parameters - Query parameters to be applied to the current query.
867
- * @param put.body - The parameters to send with the custom request.
967
+ * @param put.path - Path of the endpoint, anything after \"/1\" must be specified.
968
+ * @param put.parameters - Query parameters to apply to the current query.
969
+ * @param put.body - Parameters to send with the custom request.
868
970
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
869
971
  */
870
972
  put({ path, parameters, body }, requestOptions) {
@@ -883,6 +985,39 @@ function createRecommendClient({ appId: appIdOption, apiKey: apiKeyOption, authM
883
985
  };
884
986
  return transporter.request(request, requestOptions);
885
987
  },
988
+ /**
989
+ * List [Recommend rules](https://www.algolia.com/doc/guides/algolia-recommend/how-to/rules/).
990
+ *
991
+ * @summary List Recommend rules.
992
+ * @param searchRecommendRules - The searchRecommendRules object.
993
+ * @param searchRecommendRules.indexName - Index on which to perform the request.
994
+ * @param searchRecommendRules.model - [Recommend models](https://www.algolia.com/doc/guides/algolia-recommend/overview/#recommend-models).
995
+ * @param searchRecommendRules.searchRecommendRulesParams - The searchRecommendRulesParams object.
996
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
997
+ */
998
+ searchRecommendRules({ indexName, model, searchRecommendRulesParams, }, requestOptions) {
999
+ if (!indexName) {
1000
+ throw new Error('Parameter `indexName` is required when calling `searchRecommendRules`.');
1001
+ }
1002
+ if (!model) {
1003
+ throw new Error('Parameter `model` is required when calling `searchRecommendRules`.');
1004
+ }
1005
+ const requestPath = '/1/indexes/{indexName}/{model}/recommend/rules/search'
1006
+ .replace('{indexName}', encodeURIComponent(indexName))
1007
+ .replace('{model}', encodeURIComponent(model));
1008
+ const headers = {};
1009
+ const queryParameters = {};
1010
+ const request = {
1011
+ method: 'POST',
1012
+ path: requestPath,
1013
+ queryParameters,
1014
+ headers,
1015
+ data: searchRecommendRulesParams ? searchRecommendRulesParams : {},
1016
+ useReadTransporter: true,
1017
+ cacheable: true,
1018
+ };
1019
+ return transporter.request(request, requestOptions);
1020
+ },
886
1021
  };
887
1022
  }
888
1023