@docsearch/js 4.3.2 → 4.4.0
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.
- package/dist/esm/index.d.ts +151 -129
- package/dist/esm/index.js +3 -3
- package/dist/esm/index.js.map +1 -1
- package/dist/umd/index.js +3 -3
- package/dist/umd/index.js.map +1 -1
- package/package.json +5 -3
package/dist/esm/index.d.ts
CHANGED
|
@@ -326,7 +326,7 @@ type ApiKey = {
|
|
|
326
326
|
*/
|
|
327
327
|
maxHitsPerQuery?: number | undefined;
|
|
328
328
|
/**
|
|
329
|
-
* Maximum number of API requests allowed per IP address or [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken
|
|
329
|
+
* Maximum number of API requests allowed per IP address or [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken) per hour. If this limit is reached, the API returns an error with status code `429`. By default, there\'s no limit.
|
|
330
330
|
*/
|
|
331
331
|
maxQueriesPerIPPerHour?: number | undefined;
|
|
332
332
|
/**
|
|
@@ -369,7 +369,7 @@ type BatchParams = {
|
|
|
369
369
|
|
|
370
370
|
type BatchResponse = {
|
|
371
371
|
/**
|
|
372
|
-
* 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](
|
|
372
|
+
* 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](https://www.algolia.com/doc/rest-api/search/get-task) and this task ID.
|
|
373
373
|
*/
|
|
374
374
|
taskID: number;
|
|
375
375
|
/**
|
|
@@ -383,7 +383,7 @@ type BatchResponse = {
|
|
|
383
383
|
*/
|
|
384
384
|
type Exhaustive$1 = {
|
|
385
385
|
/**
|
|
386
|
-
* Whether the facet count is exhaustive (`true`) or approximate (`false`). See the [related discussion](https://support.algolia.com/hc/
|
|
386
|
+
* Whether the facet count is exhaustive (`true`) or approximate (`false`). See the [related discussion](https://support.algolia.com/hc/articles/4406975248145-Why-are-my-facet-and-hit-counts-not-accurate).
|
|
387
387
|
*/
|
|
388
388
|
facetsCount?: boolean | undefined;
|
|
389
389
|
/**
|
|
@@ -451,7 +451,7 @@ type RedirectRuleIndexMetadata$1 = {
|
|
|
451
451
|
};
|
|
452
452
|
|
|
453
453
|
/**
|
|
454
|
-
* [Redirect results to a URL](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/redirects
|
|
454
|
+
* [Redirect results to a URL](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/redirects), this this parameter is for internal use only.
|
|
455
455
|
*/
|
|
456
456
|
type Redirect$1 = {
|
|
457
457
|
index?: Array<RedirectRuleIndexMetadata$1> | undefined;
|
|
@@ -648,7 +648,7 @@ type BaseSearchResponse$1 = Record<string, any> & {
|
|
|
648
648
|
*/
|
|
649
649
|
userData?: any | null | undefined;
|
|
650
650
|
/**
|
|
651
|
-
* Unique identifier for the query. This is used for [click analytics](https://www.algolia.com/doc/guides/analytics/click-analytics
|
|
651
|
+
* Unique identifier for the query. This is used for [click analytics](https://www.algolia.com/doc/guides/analytics/click-analytics).
|
|
652
652
|
*/
|
|
653
653
|
queryID?: string | undefined;
|
|
654
654
|
/**
|
|
@@ -878,7 +878,7 @@ type DeleteSourceResponse = {
|
|
|
878
878
|
*/
|
|
879
879
|
type DeletedAtResponse = {
|
|
880
880
|
/**
|
|
881
|
-
* 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](
|
|
881
|
+
* 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](https://www.algolia.com/doc/rest-api/search/get-task) and this task ID.
|
|
882
882
|
*/
|
|
883
883
|
taskID: number;
|
|
884
884
|
/**
|
|
@@ -888,7 +888,7 @@ type DeletedAtResponse = {
|
|
|
888
888
|
};
|
|
889
889
|
|
|
890
890
|
/**
|
|
891
|
-
* Key-value pairs of [supported language ISO codes](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages
|
|
891
|
+
* Key-value pairs of [supported language ISO codes](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages) and boolean values.
|
|
892
892
|
*/
|
|
893
893
|
type StandardEntries = {
|
|
894
894
|
/**
|
|
@@ -1242,7 +1242,7 @@ type RemoveUserIdResponse = {
|
|
|
1242
1242
|
*/
|
|
1243
1243
|
type UpdatedAtResponse = {
|
|
1244
1244
|
/**
|
|
1245
|
-
* 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](
|
|
1245
|
+
* 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](https://www.algolia.com/doc/rest-api/search/get-task) and this task ID.
|
|
1246
1246
|
*/
|
|
1247
1247
|
taskID: number;
|
|
1248
1248
|
/**
|
|
@@ -1344,7 +1344,7 @@ type InsideBoundingBox$1 = string | Array<Array<number>>;
|
|
|
1344
1344
|
type NumericFilters$1 = Array<NumericFilters$1> | string;
|
|
1345
1345
|
|
|
1346
1346
|
/**
|
|
1347
|
-
* Filters to promote or demote records in the search results. Optional filters work like facet filters, but they don\'t exclude records from the search results. Records that match the optional filter rank before records that don\'t match. If you\'re using a negative filter `facet:-value`, matching records rank after records that don\'t match. - Optional filters don\'t work on virtual replicas. - Optional filters are applied _after_ sort-by attributes. - Optional filters are applied _before_ custom ranking attributes (in the default [ranking](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria
|
|
1347
|
+
* Filters to promote or demote records in the search results. Optional filters work like facet filters, but they don\'t exclude records from the search results. Records that match the optional filter rank before records that don\'t match. If you\'re using a negative filter `facet:-value`, matching records rank after records that don\'t match. - Optional filters don\'t work on virtual replicas. - Optional filters are applied _after_ sort-by attributes. - Optional filters are applied _before_ custom ranking attributes (in the default [ranking](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria)). - Optional filters don\'t work with numeric attributes.
|
|
1348
1348
|
*/
|
|
1349
1349
|
type OptionalFilters$1 = Array<OptionalFilters$1> | string;
|
|
1350
1350
|
|
|
@@ -1364,7 +1364,7 @@ type BaseSearchParamsWithoutQuery$1 = {
|
|
|
1364
1364
|
*/
|
|
1365
1365
|
similarQuery?: string | undefined;
|
|
1366
1366
|
/**
|
|
1367
|
-
* Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can\'t use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can\'t combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering
|
|
1367
|
+
* Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can\'t use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can\'t combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering).
|
|
1368
1368
|
*/
|
|
1369
1369
|
filters?: string | undefined;
|
|
1370
1370
|
facetFilters?: FacetFilters$1 | undefined;
|
|
@@ -1431,7 +1431,7 @@ type BaseSearchParamsWithoutQuery$1 = {
|
|
|
1431
1431
|
*/
|
|
1432
1432
|
personalizationImpact?: number | undefined;
|
|
1433
1433
|
/**
|
|
1434
|
-
* Unique pseudonymous or anonymous user identifier. This helps with analytics and click and conversion events. For more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken
|
|
1434
|
+
* Unique pseudonymous or anonymous user identifier. This helps with analytics and click and conversion events. For more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).
|
|
1435
1435
|
*/
|
|
1436
1436
|
userToken?: string | undefined;
|
|
1437
1437
|
/**
|
|
@@ -1443,7 +1443,7 @@ type BaseSearchParamsWithoutQuery$1 = {
|
|
|
1443
1443
|
*/
|
|
1444
1444
|
synonyms?: boolean | undefined;
|
|
1445
1445
|
/**
|
|
1446
|
-
* Whether to include a `queryID` attribute in the response The query ID is a unique identifier for a search query and is required for tracking [click and conversion events](https://www.algolia.com/guides/sending-events/getting-started
|
|
1446
|
+
* Whether to include a `queryID` attribute in the response The query ID is a unique identifier for a search query and is required for tracking [click and conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started).
|
|
1447
1447
|
*/
|
|
1448
1448
|
clickAnalytics?: boolean | undefined;
|
|
1449
1449
|
/**
|
|
@@ -1451,7 +1451,7 @@ type BaseSearchParamsWithoutQuery$1 = {
|
|
|
1451
1451
|
*/
|
|
1452
1452
|
analytics?: boolean | undefined;
|
|
1453
1453
|
/**
|
|
1454
|
-
* Tags to apply to the query for [segmenting analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments
|
|
1454
|
+
* Tags to apply to the query for [segmenting analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments).
|
|
1455
1455
|
*/
|
|
1456
1456
|
analyticsTags?: Array<string> | undefined;
|
|
1457
1457
|
/**
|
|
@@ -1496,12 +1496,12 @@ type Mode$1 = 'neuralSearch' | 'keywordSearch';
|
|
|
1496
1496
|
type OptionalWords$1 = string | Array<string>;
|
|
1497
1497
|
|
|
1498
1498
|
/**
|
|
1499
|
-
* Determines if and how query words are interpreted as prefixes. By default, only the last query word is treated as a prefix (`prefixLast`). To turn off prefix search, use `prefixNone`. Avoid `prefixAll`, which treats all query words as prefixes. This might lead to counterintuitive results and makes your search slower. For more information, see [Prefix searching](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/prefix-searching
|
|
1499
|
+
* Determines if and how query words are interpreted as prefixes. By default, only the last query word is treated as a prefix (`prefixLast`). To turn off prefix search, use `prefixNone`. Avoid `prefixAll`, which treats all query words as prefixes. This might lead to counterintuitive results and makes your search slower. For more information, see [Prefix searching](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/prefix-searching).
|
|
1500
1500
|
*/
|
|
1501
1501
|
type QueryType$1 = 'prefixLast' | 'prefixAll' | 'prefixNone';
|
|
1502
1502
|
|
|
1503
1503
|
/**
|
|
1504
|
-
* Restrict [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking
|
|
1504
|
+
* Restrict [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking) to records that match these filters.
|
|
1505
1505
|
*/
|
|
1506
1506
|
type ReRankingApplyFilter$1 = Array<ReRankingApplyFilter$1> | string;
|
|
1507
1507
|
|
|
@@ -1511,7 +1511,7 @@ type ReRankingApplyFilter$1 = Array<ReRankingApplyFilter$1> | string;
|
|
|
1511
1511
|
type RemoveStopWords$1 = Array<SupportedLanguage$1> | boolean;
|
|
1512
1512
|
|
|
1513
1513
|
/**
|
|
1514
|
-
* Strategy for removing words from the query when it doesn\'t return any results. This helps to avoid returning empty search results. - `none`. No words are removed when a query doesn\'t return results. - `lastWords`. Treat the last (then second to last, then third to last) word as optional, until there are results or at most 5 words have been removed. - `firstWords`. Treat the first (then second, then third) word as optional, until there are results or at most 5 words have been removed. - `allOptional`. Treat all words as optional. For more information, see [Remove words to improve results](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/in-depth/why-use-remove-words-if-no-results
|
|
1514
|
+
* Strategy for removing words from the query when it doesn\'t return any results. This helps to avoid returning empty search results. - `none`. No words are removed when a query doesn\'t return results. - `lastWords`. Treat the last (then second to last, then third to last) word as optional, until there are results or at most 5 words have been removed. - `firstWords`. Treat the first (then second, then third) word as optional, until there are results or at most 5 words have been removed. - `allOptional`. Treat all words as optional. For more information, see [Remove words to improve results](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/in-depth/why-use-remove-words-if-no-results).
|
|
1515
1515
|
*/
|
|
1516
1516
|
type RemoveWordsIfNoResults$1 = 'none' | 'lastWords' | 'firstWords' | 'allOptional';
|
|
1517
1517
|
|
|
@@ -1531,7 +1531,7 @@ type SemanticSearch$1 = {
|
|
|
1531
1531
|
type TypoToleranceEnum$1 = 'min' | 'strict' | 'true' | 'false';
|
|
1532
1532
|
|
|
1533
1533
|
/**
|
|
1534
|
-
* Whether [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance
|
|
1534
|
+
* Whether [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance) is enabled and how it is applied. If typo tolerance is true, `min`, or `strict`, [word splitting and concatenation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/splitting-and-concatenation) are also active.
|
|
1535
1535
|
*/
|
|
1536
1536
|
type TypoTolerance$1 = boolean | TypoToleranceEnum$1;
|
|
1537
1537
|
|
|
@@ -1541,7 +1541,7 @@ type IndexSettingsAsSearchParams$1 = {
|
|
|
1541
1541
|
*/
|
|
1542
1542
|
attributesToRetrieve?: Array<string> | undefined;
|
|
1543
1543
|
/**
|
|
1544
|
-
* Determines the order in which Algolia returns your results. By default, each entry corresponds to a [ranking criteria](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria
|
|
1544
|
+
* Determines the order in which Algolia returns your results. By default, each entry corresponds to a [ranking criteria](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria). The tie-breaking algorithm sequentially applies each criterion in the order they\'re specified. If you configure a replica index for [sorting by an attribute](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/how-to/sort-by-attribute), you put the sorting attribute at the top of the list. **Modifiers** - `asc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in ascending order. - `desc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in descending order. Before you modify the default setting, you should test your changes in the dashboard, and by [A/B testing](https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing).
|
|
1545
1545
|
*/
|
|
1546
1546
|
ranking?: Array<string> | undefined;
|
|
1547
1547
|
/**
|
|
@@ -1549,7 +1549,7 @@ type IndexSettingsAsSearchParams$1 = {
|
|
|
1549
1549
|
*/
|
|
1550
1550
|
relevancyStrictness?: number | undefined;
|
|
1551
1551
|
/**
|
|
1552
|
-
* Attributes to highlight By default, all searchable attributes are highlighted. Use `*` to highlight all attributes or use an empty array `[]` to turn off highlighting. Attribute names are case-sensitive With highlighting, strings that match the search query are surrounded by HTML tags defined by `highlightPreTag` and `highlightPostTag`. You can use this to visually highlight matching parts of a search query in your UI For more information, see [Highlighting and snippeting](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/highlighting-snippeting/js
|
|
1552
|
+
* Attributes to highlight By default, all searchable attributes are highlighted. Use `*` to highlight all attributes or use an empty array `[]` to turn off highlighting. Attribute names are case-sensitive With highlighting, strings that match the search query are surrounded by HTML tags defined by `highlightPreTag` and `highlightPostTag`. You can use this to visually highlight matching parts of a search query in your UI For more information, see [Highlighting and snippeting](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/highlighting-snippeting/js).
|
|
1553
1553
|
*/
|
|
1554
1554
|
attributesToHighlight?: Array<string> | undefined;
|
|
1555
1555
|
/**
|
|
@@ -1590,13 +1590,13 @@ type IndexSettingsAsSearchParams$1 = {
|
|
|
1590
1590
|
*/
|
|
1591
1591
|
allowTyposOnNumericTokens?: boolean | undefined;
|
|
1592
1592
|
/**
|
|
1593
|
-
* Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance
|
|
1593
|
+
* Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance). Attribute names are case-sensitive Returning only exact matches can help when - [Searching in hyphenated attributes](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/how-to/how-to-search-in-hyphenated-attributes). - Reducing the number of matches when you have too many. This can happen with attributes that are long blocks of text, such as product descriptions Consider alternatives such as `disableTypoToleranceOnWords` or adding synonyms if your attributes have intentional unusual spellings that might look like typos.
|
|
1594
1594
|
*/
|
|
1595
1595
|
disableTypoToleranceOnAttributes?: Array<string> | undefined;
|
|
1596
1596
|
ignorePlurals?: IgnorePlurals$1 | undefined;
|
|
1597
1597
|
removeStopWords?: RemoveStopWords$1 | undefined;
|
|
1598
1598
|
/**
|
|
1599
|
-
* Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [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) languages. To support this, you must place the CJK language **first** **You should always specify a query language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages
|
|
1599
|
+
* Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [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) languages. To support this, you must place the CJK language **first** **You should always specify a query language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
|
|
1600
1600
|
*/
|
|
1601
1601
|
queryLanguages?: Array<SupportedLanguage$1> | undefined;
|
|
1602
1602
|
/**
|
|
@@ -1651,7 +1651,7 @@ type IndexSettingsAsSearchParams$1 = {
|
|
|
1651
1651
|
*/
|
|
1652
1652
|
maxValuesPerFacet?: number | undefined;
|
|
1653
1653
|
/**
|
|
1654
|
-
* Order in which to retrieve facet values - `count`. Facet values are retrieved by decreasing count. The count is the number of matching records containing this facet value - `alpha`. Retrieve facet values alphabetically This setting doesn\'t influence how facet values are displayed in your UI (see `renderingContent`). For more information, see [facet value display](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/facet-display/js
|
|
1654
|
+
* Order in which to retrieve facet values - `count`. Facet values are retrieved by decreasing count. The count is the number of matching records containing this facet value - `alpha`. Retrieve facet values alphabetically This setting doesn\'t influence how facet values are displayed in your UI (see `renderingContent`). For more information, see [facet value display](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/facet-display/js).
|
|
1655
1655
|
*/
|
|
1656
1656
|
sortFacetValuesBy?: string | undefined;
|
|
1657
1657
|
/**
|
|
@@ -1660,7 +1660,7 @@ type IndexSettingsAsSearchParams$1 = {
|
|
|
1660
1660
|
attributeCriteriaComputedByMinProximity?: boolean | undefined;
|
|
1661
1661
|
renderingContent?: RenderingContent$1 | undefined;
|
|
1662
1662
|
/**
|
|
1663
|
-
* Whether this search will use [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking
|
|
1663
|
+
* Whether this search will use [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking) This setting only has an effect if you activated Dynamic Re-Ranking for this index in the Algolia dashboard.
|
|
1664
1664
|
*/
|
|
1665
1665
|
enableReRanking?: boolean | undefined;
|
|
1666
1666
|
reRankingApplyFilter?: ReRankingApplyFilter$1 | null | undefined;
|
|
@@ -1679,7 +1679,7 @@ type AutomaticFacetFilter = {
|
|
|
1679
1679
|
*/
|
|
1680
1680
|
score?: number | undefined;
|
|
1681
1681
|
/**
|
|
1682
|
-
* Whether the filter is disjunctive or conjunctive. If true the filter has multiple matches, multiple
|
|
1682
|
+
* Whether the filter is disjunctive or conjunctive. If true the filter has multiple matches, multiple occurrences are combined with the logical `OR` operation. If false, multiple occurrences are combined with the logical `AND` operation.
|
|
1683
1683
|
*/
|
|
1684
1684
|
disjunctive?: boolean | undefined;
|
|
1685
1685
|
};
|
|
@@ -1831,7 +1831,7 @@ type SaveObjectResponse = {
|
|
|
1831
1831
|
*/
|
|
1832
1832
|
createdAt: string;
|
|
1833
1833
|
/**
|
|
1834
|
-
* 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](
|
|
1834
|
+
* 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](https://www.algolia.com/doc/rest-api/search/get-task) and this task ID.
|
|
1835
1835
|
*/
|
|
1836
1836
|
taskID: number;
|
|
1837
1837
|
/**
|
|
@@ -1842,7 +1842,7 @@ type SaveObjectResponse = {
|
|
|
1842
1842
|
|
|
1843
1843
|
type SaveSynonymResponse = {
|
|
1844
1844
|
/**
|
|
1845
|
-
* 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](
|
|
1845
|
+
* 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](https://www.algolia.com/doc/rest-api/search/get-task) and this task ID.
|
|
1846
1846
|
*/
|
|
1847
1847
|
taskID: number;
|
|
1848
1848
|
/**
|
|
@@ -1896,7 +1896,7 @@ type SearchDictionaryEntriesResponse = {
|
|
|
1896
1896
|
*/
|
|
1897
1897
|
hits: Array<DictionaryEntry>;
|
|
1898
1898
|
/**
|
|
1899
|
-
* Requested page of the API response. Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js
|
|
1899
|
+
* Requested page of the API response. Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js)). - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
|
|
1900
1900
|
*/
|
|
1901
1901
|
page: number;
|
|
1902
1902
|
/**
|
|
@@ -1919,7 +1919,7 @@ type FacetHits$1 = {
|
|
|
1919
1919
|
*/
|
|
1920
1920
|
highlighted: string;
|
|
1921
1921
|
/**
|
|
1922
|
-
* Number of records with this facet value. [The count may be approximated](https://support.algolia.com/hc/
|
|
1922
|
+
* Number of records with this facet value. [The count may be approximated](https://support.algolia.com/hc/articles/4406975248145-Why-are-my-facet-and-hit-counts-not-accurate).
|
|
1923
1923
|
*/
|
|
1924
1924
|
count: number;
|
|
1925
1925
|
};
|
|
@@ -1930,7 +1930,7 @@ type SearchForFacetValuesResponse$2 = {
|
|
|
1930
1930
|
*/
|
|
1931
1931
|
facetHits: Array<FacetHits$1>;
|
|
1932
1932
|
/**
|
|
1933
|
-
* Whether the facet count is exhaustive (true) or approximate (false). For more information, see [Why are my facet and hit counts not accurate](https://support.algolia.com/hc/
|
|
1933
|
+
* Whether the facet count is exhaustive (true) or approximate (false). For more information, see [Why are my facet and hit counts not accurate](https://support.algolia.com/hc/articles/4406975248145-Why-are-my-facet-and-hit-counts-not-accurate).
|
|
1934
1934
|
*/
|
|
1935
1935
|
exhaustiveFacetsCount: boolean;
|
|
1936
1936
|
/**
|
|
@@ -2088,11 +2088,11 @@ type SynonymHit = {
|
|
|
2088
2088
|
*/
|
|
2089
2089
|
synonyms?: Array<string> | undefined;
|
|
2090
2090
|
/**
|
|
2091
|
-
* Word or phrase to appear in query strings (for [`onewaysynonym`s](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/in-depth/one-way-synonyms
|
|
2091
|
+
* Word or phrase to appear in query strings (for [`onewaysynonym`s](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/in-depth/one-way-synonyms)).
|
|
2092
2092
|
*/
|
|
2093
2093
|
input?: string | undefined;
|
|
2094
2094
|
/**
|
|
2095
|
-
* Word or phrase to appear in query strings (for [`altcorrection1` and `altcorrection2`](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/in-depth/synonyms-alternative-corrections
|
|
2095
|
+
* Word or phrase to appear in query strings (for [`altcorrection1` and `altcorrection2`](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/in-depth/synonyms-alternative-corrections)).
|
|
2096
2096
|
*/
|
|
2097
2097
|
word?: string | undefined;
|
|
2098
2098
|
/**
|
|
@@ -2100,11 +2100,11 @@ type SynonymHit = {
|
|
|
2100
2100
|
*/
|
|
2101
2101
|
corrections?: Array<string> | undefined;
|
|
2102
2102
|
/**
|
|
2103
|
-
* [Placeholder token](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/in-depth/synonyms-placeholders
|
|
2103
|
+
* [Placeholder token](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/in-depth/synonyms-placeholders) to be put inside records.
|
|
2104
2104
|
*/
|
|
2105
2105
|
placeholder?: string | undefined;
|
|
2106
2106
|
/**
|
|
2107
|
-
* Query words that will match the [placeholder token](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/in-depth/synonyms-placeholders
|
|
2107
|
+
* Query words that will match the [placeholder token](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/adding-synonyms/in-depth/synonyms-placeholders).
|
|
2108
2108
|
*/
|
|
2109
2109
|
replacements?: Array<string> | undefined;
|
|
2110
2110
|
};
|
|
@@ -2124,9 +2124,6 @@ type SearchSynonymsResponse = Record<string, any> & {
|
|
|
2124
2124
|
* OK
|
|
2125
2125
|
*/
|
|
2126
2126
|
type SearchUserIdsParams = {
|
|
2127
|
-
/**
|
|
2128
|
-
* Query to search. The search is a prefix search with [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/) enabled. An empty query will retrieve all users.
|
|
2129
|
-
*/
|
|
2130
2127
|
query: string;
|
|
2131
2128
|
/**
|
|
2132
2129
|
* Cluster name.
|
|
@@ -2188,7 +2185,7 @@ type SearchUserIdsResponse = {
|
|
|
2188
2185
|
*/
|
|
2189
2186
|
page: number;
|
|
2190
2187
|
/**
|
|
2191
|
-
* Maximum number of hits per page. Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js
|
|
2188
|
+
* Maximum number of hits per page. Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js)). - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
|
|
2192
2189
|
*/
|
|
2193
2190
|
hitsPerPage: number;
|
|
2194
2191
|
/**
|
|
@@ -2199,11 +2196,11 @@ type SearchUserIdsResponse = {
|
|
|
2199
2196
|
|
|
2200
2197
|
type BaseIndexSettings$1 = {
|
|
2201
2198
|
/**
|
|
2202
|
-
* Attributes used for [faceting](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting
|
|
2199
|
+
* Attributes used for [faceting](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting). Facets are attributes that let you categorize search results. They can be used for filtering search results. By default, no attribute is used for faceting. Attribute names are case-sensitive. **Modifiers** - `filterOnly(\"ATTRIBUTE\")`. Allows the attribute to be used as a filter but doesn\'t evaluate the facet values. - `searchable(\"ATTRIBUTE\")`. Allows searching for facet values. - `afterDistinct(\"ATTRIBUTE\")`. Evaluates the facet count _after_ deduplication with `distinct`. This ensures accurate facet counts. You can apply this modifier to searchable facets: `afterDistinct(searchable(ATTRIBUTE))`.
|
|
2203
2200
|
*/
|
|
2204
2201
|
attributesForFaceting?: Array<string> | undefined;
|
|
2205
2202
|
/**
|
|
2206
|
-
* Creates [replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas
|
|
2203
|
+
* Creates [replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas). Replicas are copies of a primary index with the same records but different settings, synonyms, or rules. If you want to offer a different ranking or sorting of your search results, you\'ll use replica indices. All index operations on a primary index are automatically forwarded to its replicas. To add a replica index, you must provide the complete set of replicas to this parameter. If you omit a replica from this list, the replica turns into a regular, standalone index that will no longer be synced with the primary index. **Modifier** - `virtual(\"REPLICA\")`. Create a virtual replica, Virtual replicas don\'t increase the number of records and are optimized for [Relevant sorting](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/relevant-sort).
|
|
2207
2204
|
*/
|
|
2208
2205
|
replicas?: Array<string> | undefined;
|
|
2209
2206
|
/**
|
|
@@ -2211,11 +2208,11 @@ type BaseIndexSettings$1 = {
|
|
|
2211
2208
|
*/
|
|
2212
2209
|
paginationLimitedTo?: number | undefined;
|
|
2213
2210
|
/**
|
|
2214
|
-
* Attributes that can\'t be retrieved at query time. This can be useful if you want to use an attribute for ranking or to [restrict access](https://www.algolia.com/doc/guides/security/api-keys/how-to/user-restricted-access-to-data
|
|
2211
|
+
* Attributes that can\'t be retrieved at query time. This can be useful if you want to use an attribute for ranking or to [restrict access](https://www.algolia.com/doc/guides/security/api-keys/how-to/user-restricted-access-to-data), but don\'t want to include it in the search results. Attribute names are case-sensitive.
|
|
2215
2212
|
*/
|
|
2216
2213
|
unretrievableAttributes?: Array<string> | undefined;
|
|
2217
2214
|
/**
|
|
2218
|
-
* Creates a list of [words which require exact matches](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance/#turn-off-typo-tolerance-for-certain-words). This also turns off [word splitting and concatenation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/splitting-and-concatenation
|
|
2215
|
+
* Creates a list of [words which require exact matches](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance/#turn-off-typo-tolerance-for-certain-words). This also turns off [word splitting and concatenation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/splitting-and-concatenation) for the specified words.
|
|
2219
2216
|
*/
|
|
2220
2217
|
disableTypoToleranceOnWords?: Array<string> | undefined;
|
|
2221
2218
|
/**
|
|
@@ -2227,11 +2224,11 @@ type BaseIndexSettings$1 = {
|
|
|
2227
2224
|
*/
|
|
2228
2225
|
camelCaseAttributes?: Array<string> | undefined;
|
|
2229
2226
|
/**
|
|
2230
|
-
* Searchable attributes to which Algolia should apply [word segmentation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation
|
|
2227
|
+
* Searchable attributes to which Algolia should apply [word segmentation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation) (decompounding). Attribute names are case-sensitive. Compound words are formed by combining two or more individual words, and are particularly prevalent in Germanic languages—for example, \"firefighter\". With decompounding, the individual components are indexed separately. You can specify different lists for different languages. Decompounding is supported for these languages: Dutch (`nl`), German (`de`), Finnish (`fi`), Danish (`da`), Swedish (`sv`), and Norwegian (`no`). Decompounding doesn\'t work for words with [non-spacing mark Unicode characters](https://www.charactercodes.net/category/non-spacing_mark). For example, `Gartenstühle` won\'t be decompounded if the `ü` consists of `u` (U+0075) and `◌̈` (U+0308).
|
|
2231
2228
|
*/
|
|
2232
2229
|
decompoundedAttributes?: Record<string, unknown> | undefined;
|
|
2233
2230
|
/**
|
|
2234
|
-
* Languages for language-specific processing steps, such as word detection and dictionary settings. **You should always specify an indexing language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages
|
|
2231
|
+
* Languages for language-specific processing steps, such as word detection and dictionary settings. **You should always specify an indexing language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
|
|
2235
2232
|
*/
|
|
2236
2233
|
indexLanguages?: Array<SupportedLanguage$1> | undefined;
|
|
2237
2234
|
/**
|
|
@@ -2251,7 +2248,7 @@ type BaseIndexSettings$1 = {
|
|
|
2251
2248
|
*/
|
|
2252
2249
|
separatorsToIndex?: string | undefined;
|
|
2253
2250
|
/**
|
|
2254
|
-
* Attributes used for searching. Attribute names are case-sensitive. By default, all attributes are searchable and the [Attribute](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/#attribute) ranking criterion is turned off. With a non-empty list, Algolia only returns results with matches in the selected attributes. In addition, the Attribute ranking criterion is turned on: matches in attributes that are higher in the list of `searchableAttributes` rank first. To make matches in two attributes rank equally, include them in a comma-separated string, such as `\"title,alternate_title\"`. Attributes with the same priority are always unordered. For more information, see [Searchable attributes](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/setting-searchable-attributes
|
|
2251
|
+
* Attributes used for searching. Attribute names are case-sensitive. By default, all attributes are searchable and the [Attribute](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/#attribute) ranking criterion is turned off. With a non-empty list, Algolia only returns results with matches in the selected attributes. In addition, the Attribute ranking criterion is turned on: matches in attributes that are higher in the list of `searchableAttributes` rank first. To make matches in two attributes rank equally, include them in a comma-separated string, such as `\"title,alternate_title\"`. Attributes with the same priority are always unordered. For more information, see [Searchable attributes](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/setting-searchable-attributes). **Modifier** - `unordered(\"ATTRIBUTE\")`. Ignore the position of a match within the attribute. Without a modifier, matches at the beginning of an attribute rank higher than matches at the end.
|
|
2255
2252
|
*/
|
|
2256
2253
|
searchableAttributes?: Array<string> | undefined;
|
|
2257
2254
|
/**
|
|
@@ -2259,7 +2256,7 @@ type BaseIndexSettings$1 = {
|
|
|
2259
2256
|
*/
|
|
2260
2257
|
userData?: any | null | undefined;
|
|
2261
2258
|
/**
|
|
2262
|
-
* Characters and their normalized replacements. This overrides Algolia\'s default [normalization](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization
|
|
2259
|
+
* Characters and their normalized replacements. This overrides Algolia\'s default [normalization](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization).
|
|
2263
2260
|
*/
|
|
2264
2261
|
customNormalization?: {
|
|
2265
2262
|
[key: string]: {
|
|
@@ -2279,7 +2276,7 @@ type BaseIndexSettings$1 = {
|
|
|
2279
2276
|
*/
|
|
2280
2277
|
keepDiacriticsOnCharacters?: string | undefined;
|
|
2281
2278
|
/**
|
|
2282
|
-
* Attributes to use as [custom ranking](https://www.algolia.com/doc/guides/managing-results/must-do/custom-ranking
|
|
2279
|
+
* Attributes to use as [custom ranking](https://www.algolia.com/doc/guides/managing-results/must-do/custom-ranking). Attribute names are case-sensitive. The custom ranking attributes decide which items are shown first if the other ranking criteria are equal. Records with missing values for your selected custom ranking attributes are always sorted last. Boolean attributes are sorted based on their alphabetical order. **Modifiers** - `asc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in ascending order. - `desc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in descending order. If you use two or more custom ranking attributes, [reduce the precision](https://www.algolia.com/doc/guides/managing-results/must-do/custom-ranking/how-to/controlling-custom-ranking-metrics-precision) of your first attributes, or the other attributes will never be applied.
|
|
2283
2280
|
*/
|
|
2284
2281
|
customRanking?: Array<string> | undefined;
|
|
2285
2282
|
};
|
|
@@ -2328,7 +2325,7 @@ type UpdateApiKeyResponse = {
|
|
|
2328
2325
|
*/
|
|
2329
2326
|
type UpdatedAtWithObjectIdResponse = {
|
|
2330
2327
|
/**
|
|
2331
|
-
* 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](
|
|
2328
|
+
* 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](https://www.algolia.com/doc/rest-api/search/get-task) and this task ID.
|
|
2332
2329
|
*/
|
|
2333
2330
|
taskID?: number | undefined;
|
|
2334
2331
|
/**
|
|
@@ -2413,7 +2410,7 @@ type BrowseParams = SearchParamsString$1 | BrowseParamsObject;
|
|
|
2413
2410
|
type DeleteByParams = {
|
|
2414
2411
|
facetFilters?: FacetFilters$1 | undefined;
|
|
2415
2412
|
/**
|
|
2416
|
-
* Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can\'t use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can\'t combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering
|
|
2413
|
+
* Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can\'t use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can\'t combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering).
|
|
2417
2414
|
*/
|
|
2418
2415
|
filters?: string | undefined;
|
|
2419
2416
|
numericFilters?: NumericFilters$1 | undefined;
|
|
@@ -2501,11 +2498,11 @@ type SearchRulesParams = {
|
|
|
2501
2498
|
*/
|
|
2502
2499
|
context?: string | undefined;
|
|
2503
2500
|
/**
|
|
2504
|
-
* Requested page of the API response. Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js
|
|
2501
|
+
* Requested page of the API response. Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js)). - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
|
|
2505
2502
|
*/
|
|
2506
2503
|
page?: number | undefined;
|
|
2507
2504
|
/**
|
|
2508
|
-
* Maximum number of hits per page. Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js
|
|
2505
|
+
* Maximum number of hits per page. Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js)). - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
|
|
2509
2506
|
*/
|
|
2510
2507
|
hitsPerPage?: number | undefined;
|
|
2511
2508
|
/**
|
|
@@ -3492,7 +3489,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3492
3489
|
* @param partialUpdateObjects - The `partialUpdateObjects` object.
|
|
3493
3490
|
* @param partialUpdateObjects.indexName - The `indexName` to update `objects` in.
|
|
3494
3491
|
* @param partialUpdateObjects.objects - The array of `objects` to update in the given Algolia `indexName`.
|
|
3495
|
-
* @param partialUpdateObjects.createIfNotExists - To be provided if non-existing objects are passed, otherwise, the call will fail
|
|
3492
|
+
* @param partialUpdateObjects.createIfNotExists - To be provided if non-existing objects are passed, otherwise, the call will fail.
|
|
3496
3493
|
* @param partialUpdateObjects.batchSize - The size of the chunk of `objects`. The number of `batch` calls will be equal to `length(objects) / batchSize`. Defaults to 1000.
|
|
3497
3494
|
* @param partialUpdateObjects.waitForTasks - Whether or not we should wait until every `batch` tasks has been processed, this operation may slow the total execution time of this method but is more reliable.
|
|
3498
3495
|
* @param requestOptions - The requestOptions to send along with the query, they will be forwarded to the `getTask` method and merged with the transporter requestOptions.
|
|
@@ -3544,7 +3541,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3544
3541
|
*/
|
|
3545
3542
|
addApiKey(apiKey: ApiKey, requestOptions?: RequestOptions): Promise<AddApiKeyResponse>;
|
|
3546
3543
|
/**
|
|
3547
|
-
* If a record with the specified object ID exists, the existing record is replaced. Otherwise, a new record is added to the index. If you want to use auto-generated object IDs, use the [`saveObject` operation](
|
|
3544
|
+
* If a record with the specified object ID exists, the existing record is replaced. Otherwise, a new record is added to the index. If you want to use auto-generated object IDs, use the [`saveObject` operation](https://www.algolia.com/doc/rest-api/search/save-object). To update _some_ attributes of an existing record, use the [`partial` operation](https://www.algolia.com/doc/rest-api/search/partial-update-object) instead. To add, update, or replace multiple records, use the [`batch` operation](https://www.algolia.com/doc/rest-api/search/batch).
|
|
3548
3545
|
*
|
|
3549
3546
|
* Required API Key ACLs:
|
|
3550
3547
|
* - addObject
|
|
@@ -3578,7 +3575,10 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3578
3575
|
*/
|
|
3579
3576
|
assignUserId({ xAlgoliaUserID, assignUserIdParams }: AssignUserIdProps, requestOptions?: RequestOptions): Promise<CreatedAtResponse>;
|
|
3580
3577
|
/**
|
|
3581
|
-
* Adds, updates, or deletes records in one index with a single API request. Batching index updates reduces latency and increases data integrity. - Actions are applied in the order they\'re specified. - Actions are equivalent to the individual API requests of the same name. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/
|
|
3578
|
+
* Adds, updates, or deletes records in one index with a single API request. Batching index updates reduces latency and increases data integrity. - Actions are applied in the order they\'re specified. - Actions are equivalent to the individual API requests of the same name. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
3579
|
+
*
|
|
3580
|
+
* Required API Key ACLs:
|
|
3581
|
+
* - addObject
|
|
3582
3582
|
* @param batch - The batch object.
|
|
3583
3583
|
* @param batch.indexName - Name of the index on which to perform the operation.
|
|
3584
3584
|
* @param batch.batchWriteParams - The batchWriteParams object.
|
|
@@ -3621,7 +3621,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3621
3621
|
*/
|
|
3622
3622
|
browse<T>({ indexName, browseParams }: BrowseProps, requestOptions?: RequestOptions): Promise<BrowseResponse<T>>;
|
|
3623
3623
|
/**
|
|
3624
|
-
* Deletes only the records from an index while keeping settings, synonyms, and rules. This operation is resource-intensive and subject to [indexing rate limits](https://support.algolia.com/hc/
|
|
3624
|
+
* Deletes only the records from an index while keeping settings, synonyms, and rules. This operation is resource-intensive and subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
3625
3625
|
*
|
|
3626
3626
|
* Required API Key ACLs:
|
|
3627
3627
|
* - deleteIndex
|
|
@@ -3697,7 +3697,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3697
3697
|
*/
|
|
3698
3698
|
deleteApiKey({ key }: DeleteApiKeyProps, requestOptions?: RequestOptions): Promise<DeleteApiKeyResponse>;
|
|
3699
3699
|
/**
|
|
3700
|
-
* This operation doesn\'t accept empty filters. This operation is resource-intensive. You should only use it if you can\'t get the object IDs of the records you want to delete. It\'s more efficient to get a list of object IDs with the [`browse` operation](
|
|
3700
|
+
* This operation doesn\'t accept empty filters. This operation is resource-intensive. You should only use it if you can\'t get the object IDs of the records you want to delete. It\'s more efficient to get a list of object IDs with the [`browse` operation](https://www.algolia.com/doc/rest-api/search/browse), and then delete the records using the [`batch` operation](https://www.algolia.com/doc/rest-api/search/batch). This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
3701
3701
|
*
|
|
3702
3702
|
* Required API Key ACLs:
|
|
3703
3703
|
* - deleteIndex
|
|
@@ -3708,7 +3708,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3708
3708
|
*/
|
|
3709
3709
|
deleteBy({ indexName, deleteByParams }: DeleteByProps, requestOptions?: RequestOptions): Promise<UpdatedAtResponse>;
|
|
3710
3710
|
/**
|
|
3711
|
-
* Deletes an index and all its settings. - Deleting an index doesn\'t delete its analytics data. - If you try to delete a non-existing index, the operation is ignored without warning. - If the index you want to delete has replica indices, the replicas become independent indices. - If the index you want to delete is a replica index, you must first unlink it from its primary index before you can delete it. For more information, see [Delete replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/how-to/deleting-replicas
|
|
3711
|
+
* Deletes an index and all its settings. - Deleting an index doesn\'t delete its analytics data. - If you try to delete a non-existing index, the operation is ignored without warning. - If the index you want to delete has replica indices, the replicas become independent indices. - If the index you want to delete is a replica index, you must first unlink it from its primary index before you can delete it. For more information, see [Delete replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/how-to/deleting-replicas).
|
|
3712
3712
|
*
|
|
3713
3713
|
* Required API Key ACLs:
|
|
3714
3714
|
* - deleteIndex
|
|
@@ -3718,7 +3718,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3718
3718
|
*/
|
|
3719
3719
|
deleteIndex({ indexName }: DeleteIndexProps, requestOptions?: RequestOptions): Promise<DeletedAtResponse>;
|
|
3720
3720
|
/**
|
|
3721
|
-
* Deletes a record by its object ID. To delete more than one record, use the [`batch` operation](
|
|
3721
|
+
* Deletes a record by its object ID. To delete more than one record, use the [`batch` operation](https://www.algolia.com/doc/rest-api/search/batch). To delete records matching a query, use the [`deleteBy` operation](https://www.algolia.com/doc/rest-api/search/delete-by).
|
|
3722
3722
|
*
|
|
3723
3723
|
* Required API Key ACLs:
|
|
3724
3724
|
* - deleteObject
|
|
@@ -3729,7 +3729,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3729
3729
|
*/
|
|
3730
3730
|
deleteObject({ indexName, objectID }: DeleteObjectProps, requestOptions?: RequestOptions): Promise<DeletedAtResponse>;
|
|
3731
3731
|
/**
|
|
3732
|
-
* Deletes a rule by its ID. To find the object ID for rules, use the [`search` operation](
|
|
3732
|
+
* Deletes a rule by its ID. To find the object ID for rules, use the [`search` operation](https://www.algolia.com/doc/rest-api/search/search-rules).
|
|
3733
3733
|
*
|
|
3734
3734
|
* Required API Key ACLs:
|
|
3735
3735
|
* - editSettings
|
|
@@ -3751,7 +3751,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3751
3751
|
*/
|
|
3752
3752
|
deleteSource({ source }: DeleteSourceProps, requestOptions?: RequestOptions): Promise<DeleteSourceResponse>;
|
|
3753
3753
|
/**
|
|
3754
|
-
* Deletes a synonym by its ID. To find the object IDs of your synonyms, use the [`search` operation](
|
|
3754
|
+
* Deletes a synonym by its ID. To find the object IDs of your synonyms, use the [`search` operation](https://www.algolia.com/doc/rest-api/search/search-synonyms).
|
|
3755
3755
|
*
|
|
3756
3756
|
* Required API Key ACLs:
|
|
3757
3757
|
* - editSettings
|
|
@@ -3764,6 +3764,9 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3764
3764
|
deleteSynonym({ indexName, objectID, forwardToReplicas }: DeleteSynonymProps, requestOptions?: RequestOptions): Promise<DeletedAtResponse>;
|
|
3765
3765
|
/**
|
|
3766
3766
|
* Gets the permissions and restrictions of an API key. When authenticating with the admin API key, you can request information for any of your application\'s keys. When authenticating with other API keys, you can only retrieve information for that key, with the description replaced by `<redacted>`.
|
|
3767
|
+
*
|
|
3768
|
+
* Required API Key ACLs:
|
|
3769
|
+
* - search
|
|
3767
3770
|
* @param getApiKey - The getApiKey object.
|
|
3768
3771
|
* @param getApiKey.key - API key.
|
|
3769
3772
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
@@ -3798,7 +3801,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3798
3801
|
*/
|
|
3799
3802
|
getDictionarySettings(requestOptions?: RequestOptions | undefined): Promise<GetDictionarySettingsResponse>;
|
|
3800
3803
|
/**
|
|
3801
|
-
* The request must be authenticated by an API key with the [`logs` ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). - Logs are held for the last seven days. - Up to 1,000 API requests per server are logged. - This request counts towards your [operations quota](https://support.algolia.com/hc/
|
|
3804
|
+
* The request must be authenticated by an API key with the [`logs` ACL](https://www.algolia.com/doc/guides/security/api-keys/#access-control-list-acl). - Logs are held for the last seven days. - Up to 1,000 API requests per server are logged. - This request counts towards your [operations quota](https://support.algolia.com/hc/articles/17245378392977-How-does-Algolia-count-records-and-operations) but doesn\'t appear in the logs itself.
|
|
3802
3805
|
*
|
|
3803
3806
|
* Required API Key ACLs:
|
|
3804
3807
|
* - logs
|
|
@@ -3811,7 +3814,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3811
3814
|
*/
|
|
3812
3815
|
getLogs({ offset, length, indexName, type }?: GetLogsProps, requestOptions?: RequestOptions | undefined): Promise<GetLogsResponse>;
|
|
3813
3816
|
/**
|
|
3814
|
-
* Retrieves one record by its object ID. To retrieve more than one record, use the [`objects` operation](
|
|
3817
|
+
* Retrieves one record by its object ID. To retrieve more than one record, use the [`objects` operation](https://www.algolia.com/doc/rest-api/search/get-objects).
|
|
3815
3818
|
*
|
|
3816
3819
|
* Required API Key ACLs:
|
|
3817
3820
|
* - search
|
|
@@ -3832,7 +3835,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3832
3835
|
*/
|
|
3833
3836
|
getObjects<T>(getObjectsParams: GetObjectsParams, requestOptions?: RequestOptions): Promise<GetObjectsResponse<T>>;
|
|
3834
3837
|
/**
|
|
3835
|
-
* Retrieves a rule by its ID. To find the object ID of rules, use the [`search` operation](
|
|
3838
|
+
* Retrieves a rule by its ID. To find the object ID of rules, use the [`search` operation](https://www.algolia.com/doc/rest-api/search/search-rules).
|
|
3836
3839
|
*
|
|
3837
3840
|
* Required API Key ACLs:
|
|
3838
3841
|
* - settings
|
|
@@ -3862,7 +3865,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3862
3865
|
*/
|
|
3863
3866
|
getSources(requestOptions?: RequestOptions | undefined): Promise<Array<Source>>;
|
|
3864
3867
|
/**
|
|
3865
|
-
* Retrieves a synonym by its ID. To find the object IDs for your synonyms, use the [`search` operation](
|
|
3868
|
+
* Retrieves a synonym by its ID. To find the object IDs for your synonyms, use the [`search` operation](https://www.algolia.com/doc/rest-api/search/search-synonyms).
|
|
3866
3869
|
*
|
|
3867
3870
|
* Required API Key ACLs:
|
|
3868
3871
|
* - settings
|
|
@@ -3960,13 +3963,16 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3960
3963
|
*/
|
|
3961
3964
|
listUserIds({ page, hitsPerPage }?: ListUserIdsProps, requestOptions?: RequestOptions | undefined): Promise<ListUserIdsResponse>;
|
|
3962
3965
|
/**
|
|
3963
|
-
* Adds, updates, or deletes records in multiple indices with a single API request. - Actions are applied in the order they are specified. - Actions are equivalent to the individual API requests of the same name. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/
|
|
3966
|
+
* Adds, updates, or deletes records in multiple indices with a single API request. - Actions are applied in the order they are specified. - Actions are equivalent to the individual API requests of the same name. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
3967
|
+
*
|
|
3968
|
+
* Required API Key ACLs:
|
|
3969
|
+
* - addObject
|
|
3964
3970
|
* @param batchParams - The batchParams object.
|
|
3965
3971
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
3966
3972
|
*/
|
|
3967
3973
|
multipleBatch(batchParams: BatchParams, requestOptions?: RequestOptions): Promise<MultipleBatchResponse>;
|
|
3968
3974
|
/**
|
|
3969
|
-
* Copies or moves (renames) an index within the same Algolia application. - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn\'t exist yet, it\'ll be created. - This operation is resource-intensive. **Copy** - Copying a source index that doesn\'t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can\'t copy the `enableReRanking`, `mode`, and `replicas` settings. - You can\'t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices
|
|
3975
|
+
* Copies or moves (renames) an index within the same Algolia application. - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn\'t exist yet, it\'ll be created. - This operation is resource-intensive. **Copy** - Copying a source index that doesn\'t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can\'t copy the `enableReRanking`, `mode`, and `replicas` settings. - You can\'t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices) **Move** - Moving a source index that doesn\'t exist is ignored without returning an error. - When moving an index, the analytics data keeps its original name, and a new set of analytics data is started for the new name. To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices). This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
3970
3976
|
*
|
|
3971
3977
|
* Required API Key ACLs:
|
|
3972
3978
|
* - addObject
|
|
@@ -3977,7 +3983,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
3977
3983
|
*/
|
|
3978
3984
|
operationIndex({ indexName, operationIndexParams }: OperationIndexProps, requestOptions?: RequestOptions): Promise<UpdatedAtResponse>;
|
|
3979
3985
|
/**
|
|
3980
|
-
* Adds new attributes to a record, or updates existing ones. - If a record with the specified object ID doesn\'t exist, a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn\'t exist yet, this method creates a new index. - You can use any first-level attribute but not nested attributes. If you specify a nested attribute, this operation replaces its first-level ancestor. To update an attribute without pushing the entire record, you can use these built-in operations. These operations can be helpful if you don\'t have access to your initial data. - Increment: increment a numeric attribute - Decrement: decrement a numeric attribute - Add: append a number or string element to an array attribute - Remove: remove all matching number or string elements from an array attribute made of numbers or strings - AddUnique: add a number or string element to an array attribute made of numbers or strings only if it\'s not already present - IncrementFrom: increment a numeric integer attribute only if the provided value matches the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementFrom value of 2 for the version attribute, but the current value of the attribute is 1, the engine ignores the update. If the object doesn\'t exist, the engine only creates it if you pass an IncrementFrom value of 0. - IncrementSet: increment a numeric integer attribute only if the provided value is greater than the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementSet value of 2 for the version attribute, and the current value of the attribute is 1, the engine updates the object. If the object doesn\'t exist yet, the engine only creates it if you pass an IncrementSet value greater than 0. You can specify an operation by providing an object with the attribute to update as the key and its value being an object with the following properties: - _operation: the operation to apply on the attribute - value: the right-hand side argument to the operation, for example, increment or decrement step, value to add or remove. When updating multiple attributes or using multiple operations targeting the same record, you should use a single partial update for faster processing. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/
|
|
3986
|
+
* Adds new attributes to a record, or updates existing ones. - If a record with the specified object ID doesn\'t exist, a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn\'t exist yet, this method creates a new index. - You can use any first-level attribute but not nested attributes. If you specify a nested attribute, this operation replaces its first-level ancestor. To update an attribute without pushing the entire record, you can use these built-in operations. These operations can be helpful if you don\'t have access to your initial data. - Increment: increment a numeric attribute - Decrement: decrement a numeric attribute - Add: append a number or string element to an array attribute - Remove: remove all matching number or string elements from an array attribute made of numbers or strings - AddUnique: add a number or string element to an array attribute made of numbers or strings only if it\'s not already present - IncrementFrom: increment a numeric integer attribute only if the provided value matches the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementFrom value of 2 for the version attribute, but the current value of the attribute is 1, the engine ignores the update. If the object doesn\'t exist, the engine only creates it if you pass an IncrementFrom value of 0. - IncrementSet: increment a numeric integer attribute only if the provided value is greater than the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementSet value of 2 for the version attribute, and the current value of the attribute is 1, the engine updates the object. If the object doesn\'t exist yet, the engine only creates it if you pass an IncrementSet value greater than 0. You can specify an operation by providing an object with the attribute to update as the key and its value being an object with the following properties: - _operation: the operation to apply on the attribute - value: the right-hand side argument to the operation, for example, increment or decrement step, value to add or remove. When updating multiple attributes or using multiple operations targeting the same record, you should use a single partial update for faster processing. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
3981
3987
|
*
|
|
3982
3988
|
* Required API Key ACLs:
|
|
3983
3989
|
* - addObject
|
|
@@ -4022,7 +4028,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
4022
4028
|
*/
|
|
4023
4029
|
restoreApiKey({ key }: RestoreApiKeyProps, requestOptions?: RequestOptions): Promise<AddApiKeyResponse>;
|
|
4024
4030
|
/**
|
|
4025
|
-
* Adds a record to an index or replaces it. - If the record doesn\'t have an object ID, a new record with an auto-generated object ID is added to your index. - If a record with the specified object ID exists, the existing record is replaced. - If a record with the specified object ID doesn\'t exist, a new record is added to your index. - If you add a record to an index that doesn\'t exist yet, a new index is created. To update _some_ attributes of a record, use the [`partial` operation](
|
|
4031
|
+
* Adds a record to an index or replaces it. - If the record doesn\'t have an object ID, a new record with an auto-generated object ID is added to your index. - If a record with the specified object ID exists, the existing record is replaced. - If a record with the specified object ID doesn\'t exist, a new record is added to your index. - If you add a record to an index that doesn\'t exist yet, a new index is created. To update _some_ attributes of a record, use the [`partial` operation](https://www.algolia.com/doc/rest-api/search/partial-update-object). To add, update, or replace multiple records, use the [`batch` operation](https://www.algolia.com/doc/rest-api/search/batch). This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
4026
4032
|
*
|
|
4027
4033
|
* Required API Key ACLs:
|
|
4028
4034
|
* - addObject
|
|
@@ -4033,7 +4039,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
4033
4039
|
*/
|
|
4034
4040
|
saveObject<T extends object>({ indexName, body }: SaveObjectProps<T>, requestOptions?: RequestOptions): Promise<SaveObjectResponse>;
|
|
4035
4041
|
/**
|
|
4036
|
-
* If a rule with the specified object ID doesn\'t exist, it\'s created. Otherwise, the existing rule is replaced. To create or update more than one rule, use the [`batch` operation](
|
|
4042
|
+
* If a rule with the specified object ID doesn\'t exist, it\'s created. Otherwise, the existing rule is replaced. To create or update more than one rule, use the [`batch` operation](https://www.algolia.com/doc/rest-api/search/save-rules).
|
|
4037
4043
|
*
|
|
4038
4044
|
* Required API Key ACLs:
|
|
4039
4045
|
* - editSettings
|
|
@@ -4046,7 +4052,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
4046
4052
|
*/
|
|
4047
4053
|
saveRule({ indexName, objectID, rule, forwardToReplicas }: SaveRuleProps, requestOptions?: RequestOptions): Promise<UpdatedAtResponse>;
|
|
4048
4054
|
/**
|
|
4049
|
-
* Create or update multiple rules. If a rule with the specified object ID doesn\'t exist, Algolia creates a new one. Otherwise, existing rules are replaced. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/
|
|
4055
|
+
* Create or update multiple rules. If a rule with the specified object ID doesn\'t exist, Algolia creates a new one. Otherwise, existing rules are replaced. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
4050
4056
|
*
|
|
4051
4057
|
* Required API Key ACLs:
|
|
4052
4058
|
* - editSettings
|
|
@@ -4059,7 +4065,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
4059
4065
|
*/
|
|
4060
4066
|
saveRules({ indexName, rules, forwardToReplicas, clearExistingRules }: SaveRulesProps, requestOptions?: RequestOptions): Promise<UpdatedAtResponse>;
|
|
4061
4067
|
/**
|
|
4062
|
-
* If a synonym with the specified object ID doesn\'t exist, Algolia adds a new one. Otherwise, the existing synonym is replaced. To add multiple synonyms in a single API request, use the [`batch` operation](
|
|
4068
|
+
* If a synonym with the specified object ID doesn\'t exist, Algolia adds a new one. Otherwise, the existing synonym is replaced. To add multiple synonyms in a single API request, use the [`batch` operation](https://www.algolia.com/doc/rest-api/search/save-synonyms).
|
|
4063
4069
|
*
|
|
4064
4070
|
* Required API Key ACLs:
|
|
4065
4071
|
* - editSettings
|
|
@@ -4072,7 +4078,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
4072
4078
|
*/
|
|
4073
4079
|
saveSynonym({ indexName, objectID, synonymHit, forwardToReplicas }: SaveSynonymProps, requestOptions?: RequestOptions): Promise<SaveSynonymResponse>;
|
|
4074
4080
|
/**
|
|
4075
|
-
* If a synonym with the `objectID` doesn\'t exist, Algolia adds a new one. Otherwise, existing synonyms are replaced. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/
|
|
4081
|
+
* If a synonym with the `objectID` doesn\'t exist, Algolia adds a new one. Otherwise, existing synonyms are replaced. This operation is subject to [indexing rate limits](https://support.algolia.com/hc/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
|
|
4076
4082
|
*
|
|
4077
4083
|
* Required API Key ACLs:
|
|
4078
4084
|
* - editSettings
|
|
@@ -4128,7 +4134,7 @@ declare function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption,
|
|
|
4128
4134
|
*/
|
|
4129
4135
|
searchRules({ indexName, searchRulesParams }: SearchRulesProps, requestOptions?: RequestOptions): Promise<SearchRulesResponse>;
|
|
4130
4136
|
/**
|
|
4131
|
-
* Searches a single index and returns matching search results
|
|
4137
|
+
* Searches a single index and returns matching search results as hits. This method lets you retrieve up to 1,000 hits. If you need more, use the [`browse` operation](https://www.algolia.com/doc/rest-api/search/browse) or increase the `paginatedLimitedTo` index setting.
|
|
4132
4138
|
*
|
|
4133
4139
|
* Required API Key ACLs:
|
|
4134
4140
|
* - search
|
|
@@ -4242,7 +4248,7 @@ type InsideBoundingBox = string | Array<Array<number>>;
|
|
|
4242
4248
|
type NumericFilters = Array<NumericFilters> | string;
|
|
4243
4249
|
|
|
4244
4250
|
/**
|
|
4245
|
-
* Filters to promote or demote records in the search results. Optional filters work like facet filters, but they don\'t exclude records from the search results. Records that match the optional filter rank before records that don\'t match. If you\'re using a negative filter `facet:-value`, matching records rank after records that don\'t match. - Optional filters don\'t work on virtual replicas. - Optional filters are applied _after_ sort-by attributes. - Optional filters are applied _before_ custom ranking attributes (in the default [ranking](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria
|
|
4251
|
+
* Filters to promote or demote records in the search results. Optional filters work like facet filters, but they don\'t exclude records from the search results. Records that match the optional filter rank before records that don\'t match. If you\'re using a negative filter `facet:-value`, matching records rank after records that don\'t match. - Optional filters don\'t work on virtual replicas. - Optional filters are applied _after_ sort-by attributes. - Optional filters are applied _before_ custom ranking attributes (in the default [ranking](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria)). - Optional filters don\'t work with numeric attributes.
|
|
4246
4252
|
*/
|
|
4247
4253
|
type OptionalFilters = Array<OptionalFilters> | string;
|
|
4248
4254
|
|
|
@@ -4262,7 +4268,7 @@ type BaseRecommendSearchParams = {
|
|
|
4262
4268
|
*/
|
|
4263
4269
|
similarQuery?: string | undefined;
|
|
4264
4270
|
/**
|
|
4265
|
-
* Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can\'t use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can\'t combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering
|
|
4271
|
+
* Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can\'t use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can\'t combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering).
|
|
4266
4272
|
*/
|
|
4267
4273
|
filters?: string | undefined;
|
|
4268
4274
|
facetFilters?: FacetFilters | undefined;
|
|
@@ -4317,7 +4323,7 @@ type BaseRecommendSearchParams = {
|
|
|
4317
4323
|
*/
|
|
4318
4324
|
personalizationImpact?: number | undefined;
|
|
4319
4325
|
/**
|
|
4320
|
-
* Unique pseudonymous or anonymous user identifier. This helps with analytics and click and conversion events. For more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken
|
|
4326
|
+
* Unique pseudonymous or anonymous user identifier. This helps with analytics and click and conversion events. For more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).
|
|
4321
4327
|
*/
|
|
4322
4328
|
userToken?: string | undefined;
|
|
4323
4329
|
/**
|
|
@@ -4329,7 +4335,7 @@ type BaseRecommendSearchParams = {
|
|
|
4329
4335
|
*/
|
|
4330
4336
|
synonyms?: boolean | undefined;
|
|
4331
4337
|
/**
|
|
4332
|
-
* Whether to include a `queryID` attribute in the response The query ID is a unique identifier for a search query and is required for tracking [click and conversion events](https://www.algolia.com/guides/sending-events/getting-started
|
|
4338
|
+
* Whether to include a `queryID` attribute in the response The query ID is a unique identifier for a search query and is required for tracking [click and conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started).
|
|
4333
4339
|
*/
|
|
4334
4340
|
clickAnalytics?: boolean | undefined;
|
|
4335
4341
|
/**
|
|
@@ -4337,7 +4343,7 @@ type BaseRecommendSearchParams = {
|
|
|
4337
4343
|
*/
|
|
4338
4344
|
analytics?: boolean | undefined;
|
|
4339
4345
|
/**
|
|
4340
|
-
* Tags to apply to the query for [segmenting analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments
|
|
4346
|
+
* Tags to apply to the query for [segmenting analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments).
|
|
4341
4347
|
*/
|
|
4342
4348
|
analyticsTags?: Array<string> | undefined;
|
|
4343
4349
|
/**
|
|
@@ -4352,11 +4358,11 @@ type BaseRecommendSearchParams = {
|
|
|
4352
4358
|
|
|
4353
4359
|
type BaseIndexSettings = {
|
|
4354
4360
|
/**
|
|
4355
|
-
* Attributes used for [faceting](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting
|
|
4361
|
+
* Attributes used for [faceting](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting). Facets are attributes that let you categorize search results. They can be used for filtering search results. By default, no attribute is used for faceting. Attribute names are case-sensitive. **Modifiers** - `filterOnly(\"ATTRIBUTE\")`. Allows the attribute to be used as a filter but doesn\'t evaluate the facet values. - `searchable(\"ATTRIBUTE\")`. Allows searching for facet values. - `afterDistinct(\"ATTRIBUTE\")`. Evaluates the facet count _after_ deduplication with `distinct`. This ensures accurate facet counts. You can apply this modifier to searchable facets: `afterDistinct(searchable(ATTRIBUTE))`.
|
|
4356
4362
|
*/
|
|
4357
4363
|
attributesForFaceting?: Array<string> | undefined;
|
|
4358
4364
|
/**
|
|
4359
|
-
* Creates [replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas
|
|
4365
|
+
* Creates [replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas). Replicas are copies of a primary index with the same records but different settings, synonyms, or rules. If you want to offer a different ranking or sorting of your search results, you\'ll use replica indices. All index operations on a primary index are automatically forwarded to its replicas. To add a replica index, you must provide the complete set of replicas to this parameter. If you omit a replica from this list, the replica turns into a regular, standalone index that will no longer be synced with the primary index. **Modifier** - `virtual(\"REPLICA\")`. Create a virtual replica, Virtual replicas don\'t increase the number of records and are optimized for [Relevant sorting](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/relevant-sort).
|
|
4360
4366
|
*/
|
|
4361
4367
|
replicas?: Array<string> | undefined;
|
|
4362
4368
|
/**
|
|
@@ -4364,11 +4370,11 @@ type BaseIndexSettings = {
|
|
|
4364
4370
|
*/
|
|
4365
4371
|
paginationLimitedTo?: number | undefined;
|
|
4366
4372
|
/**
|
|
4367
|
-
* Attributes that can\'t be retrieved at query time. This can be useful if you want to use an attribute for ranking or to [restrict access](https://www.algolia.com/doc/guides/security/api-keys/how-to/user-restricted-access-to-data
|
|
4373
|
+
* Attributes that can\'t be retrieved at query time. This can be useful if you want to use an attribute for ranking or to [restrict access](https://www.algolia.com/doc/guides/security/api-keys/how-to/user-restricted-access-to-data), but don\'t want to include it in the search results. Attribute names are case-sensitive.
|
|
4368
4374
|
*/
|
|
4369
4375
|
unretrievableAttributes?: Array<string> | undefined;
|
|
4370
4376
|
/**
|
|
4371
|
-
* Creates a list of [words which require exact matches](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance/#turn-off-typo-tolerance-for-certain-words). This also turns off [word splitting and concatenation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/splitting-and-concatenation
|
|
4377
|
+
* Creates a list of [words which require exact matches](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance/#turn-off-typo-tolerance-for-certain-words). This also turns off [word splitting and concatenation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/splitting-and-concatenation) for the specified words.
|
|
4372
4378
|
*/
|
|
4373
4379
|
disableTypoToleranceOnWords?: Array<string> | undefined;
|
|
4374
4380
|
/**
|
|
@@ -4380,11 +4386,11 @@ type BaseIndexSettings = {
|
|
|
4380
4386
|
*/
|
|
4381
4387
|
camelCaseAttributes?: Array<string> | undefined;
|
|
4382
4388
|
/**
|
|
4383
|
-
* Searchable attributes to which Algolia should apply [word segmentation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation
|
|
4389
|
+
* Searchable attributes to which Algolia should apply [word segmentation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-segmentation) (decompounding). Attribute names are case-sensitive. Compound words are formed by combining two or more individual words, and are particularly prevalent in Germanic languages—for example, \"firefighter\". With decompounding, the individual components are indexed separately. You can specify different lists for different languages. Decompounding is supported for these languages: Dutch (`nl`), German (`de`), Finnish (`fi`), Danish (`da`), Swedish (`sv`), and Norwegian (`no`). Decompounding doesn\'t work for words with [non-spacing mark Unicode characters](https://www.charactercodes.net/category/non-spacing_mark). For example, `Gartenstühle` won\'t be decompounded if the `ü` consists of `u` (U+0075) and `◌̈` (U+0308).
|
|
4384
4390
|
*/
|
|
4385
4391
|
decompoundedAttributes?: Record<string, unknown> | undefined;
|
|
4386
4392
|
/**
|
|
4387
|
-
* Languages for language-specific processing steps, such as word detection and dictionary settings. **You should always specify an indexing language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages
|
|
4393
|
+
* Languages for language-specific processing steps, such as word detection and dictionary settings. **You should always specify an indexing language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
|
|
4388
4394
|
*/
|
|
4389
4395
|
indexLanguages?: Array<SupportedLanguage> | undefined;
|
|
4390
4396
|
/**
|
|
@@ -4404,7 +4410,7 @@ type BaseIndexSettings = {
|
|
|
4404
4410
|
*/
|
|
4405
4411
|
separatorsToIndex?: string | undefined;
|
|
4406
4412
|
/**
|
|
4407
|
-
* Attributes used for searching. Attribute names are case-sensitive. By default, all attributes are searchable and the [Attribute](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/#attribute) ranking criterion is turned off. With a non-empty list, Algolia only returns results with matches in the selected attributes. In addition, the Attribute ranking criterion is turned on: matches in attributes that are higher in the list of `searchableAttributes` rank first. To make matches in two attributes rank equally, include them in a comma-separated string, such as `\"title,alternate_title\"`. Attributes with the same priority are always unordered. For more information, see [Searchable attributes](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/setting-searchable-attributes
|
|
4413
|
+
* Attributes used for searching. Attribute names are case-sensitive. By default, all attributes are searchable and the [Attribute](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria/#attribute) ranking criterion is turned off. With a non-empty list, Algolia only returns results with matches in the selected attributes. In addition, the Attribute ranking criterion is turned on: matches in attributes that are higher in the list of `searchableAttributes` rank first. To make matches in two attributes rank equally, include them in a comma-separated string, such as `\"title,alternate_title\"`. Attributes with the same priority are always unordered. For more information, see [Searchable attributes](https://www.algolia.com/doc/guides/sending-and-managing-data/prepare-your-data/how-to/setting-searchable-attributes). **Modifier** - `unordered(\"ATTRIBUTE\")`. Ignore the position of a match within the attribute. Without a modifier, matches at the beginning of an attribute rank higher than matches at the end.
|
|
4408
4414
|
*/
|
|
4409
4415
|
searchableAttributes?: Array<string> | undefined;
|
|
4410
4416
|
/**
|
|
@@ -4412,7 +4418,7 @@ type BaseIndexSettings = {
|
|
|
4412
4418
|
*/
|
|
4413
4419
|
userData?: any | null | undefined;
|
|
4414
4420
|
/**
|
|
4415
|
-
* Characters and their normalized replacements. This overrides Algolia\'s default [normalization](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization
|
|
4421
|
+
* Characters and their normalized replacements. This overrides Algolia\'s default [normalization](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization).
|
|
4416
4422
|
*/
|
|
4417
4423
|
customNormalization?: {
|
|
4418
4424
|
[key: string]: {
|
|
@@ -4432,7 +4438,7 @@ type BaseIndexSettings = {
|
|
|
4432
4438
|
*/
|
|
4433
4439
|
keepDiacriticsOnCharacters?: string | undefined;
|
|
4434
4440
|
/**
|
|
4435
|
-
* Attributes to use as [custom ranking](https://www.algolia.com/doc/guides/managing-results/must-do/custom-ranking
|
|
4441
|
+
* Attributes to use as [custom ranking](https://www.algolia.com/doc/guides/managing-results/must-do/custom-ranking). Attribute names are case-sensitive. The custom ranking attributes decide which items are shown first if the other ranking criteria are equal. Records with missing values for your selected custom ranking attributes are always sorted last. Boolean attributes are sorted based on their alphabetical order. **Modifiers** - `asc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in ascending order. - `desc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in descending order. If you use two or more custom ranking attributes, [reduce the precision](https://www.algolia.com/doc/guides/managing-results/must-do/custom-ranking/how-to/controlling-custom-ranking-metrics-precision) of your first attributes, or the other attributes will never be applied.
|
|
4436
4442
|
*/
|
|
4437
4443
|
customRanking?: Array<string> | undefined;
|
|
4438
4444
|
};
|
|
@@ -4464,12 +4470,12 @@ type IgnorePlurals = Array<SupportedLanguage> | BooleanString | boolean;
|
|
|
4464
4470
|
type OptionalWords = string | Array<string>;
|
|
4465
4471
|
|
|
4466
4472
|
/**
|
|
4467
|
-
* Determines if and how query words are interpreted as prefixes. By default, only the last query word is treated as a prefix (`prefixLast`). To turn off prefix search, use `prefixNone`. Avoid `prefixAll`, which treats all query words as prefixes. This might lead to counterintuitive results and makes your search slower. For more information, see [Prefix searching](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/prefix-searching
|
|
4473
|
+
* Determines if and how query words are interpreted as prefixes. By default, only the last query word is treated as a prefix (`prefixLast`). To turn off prefix search, use `prefixNone`. Avoid `prefixAll`, which treats all query words as prefixes. This might lead to counterintuitive results and makes your search slower. For more information, see [Prefix searching](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/override-search-engine-defaults/in-depth/prefix-searching).
|
|
4468
4474
|
*/
|
|
4469
4475
|
type QueryType = 'prefixLast' | 'prefixAll' | 'prefixNone';
|
|
4470
4476
|
|
|
4471
4477
|
/**
|
|
4472
|
-
* Restrict [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking
|
|
4478
|
+
* Restrict [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking) to records that match these filters.
|
|
4473
4479
|
*/
|
|
4474
4480
|
type ReRankingApplyFilter = Array<ReRankingApplyFilter> | string;
|
|
4475
4481
|
|
|
@@ -4479,7 +4485,7 @@ type ReRankingApplyFilter = Array<ReRankingApplyFilter> | string;
|
|
|
4479
4485
|
type RemoveStopWords = Array<SupportedLanguage> | boolean;
|
|
4480
4486
|
|
|
4481
4487
|
/**
|
|
4482
|
-
* Strategy for removing words from the query when it doesn\'t return any results. This helps to avoid returning empty search results. - `none`. No words are removed when a query doesn\'t return results. - `lastWords`. Treat the last (then second to last, then third to last) word as optional, until there are results or at most 5 words have been removed. - `firstWords`. Treat the first (then second, then third) word as optional, until there are results or at most 5 words have been removed. - `allOptional`. Treat all words as optional. For more information, see [Remove words to improve results](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/in-depth/why-use-remove-words-if-no-results
|
|
4488
|
+
* Strategy for removing words from the query when it doesn\'t return any results. This helps to avoid returning empty search results. - `none`. No words are removed when a query doesn\'t return results. - `lastWords`. Treat the last (then second to last, then third to last) word as optional, until there are results or at most 5 words have been removed. - `firstWords`. Treat the first (then second, then third) word as optional, until there are results or at most 5 words have been removed. - `allOptional`. Treat all words as optional. For more information, see [Remove words to improve results](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/empty-or-insufficient-results/in-depth/why-use-remove-words-if-no-results).
|
|
4483
4489
|
*/
|
|
4484
4490
|
type RemoveWordsIfNoResults = 'none' | 'lastWords' | 'firstWords' | 'allOptional';
|
|
4485
4491
|
|
|
@@ -4585,7 +4591,7 @@ type RenderingContent = {
|
|
|
4585
4591
|
type TypoToleranceEnum = 'min' | 'strict' | 'true' | 'false';
|
|
4586
4592
|
|
|
4587
4593
|
/**
|
|
4588
|
-
* Whether [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance
|
|
4594
|
+
* Whether [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance) is enabled and how it is applied. If typo tolerance is true, `min`, or `strict`, [word splitting and concatenation](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/splitting-and-concatenation) are also active.
|
|
4589
4595
|
*/
|
|
4590
4596
|
type TypoTolerance = boolean | TypoToleranceEnum;
|
|
4591
4597
|
|
|
@@ -4595,7 +4601,7 @@ type BaseRecommendIndexSettings = {
|
|
|
4595
4601
|
*/
|
|
4596
4602
|
attributesToRetrieve?: Array<string> | undefined;
|
|
4597
4603
|
/**
|
|
4598
|
-
* Determines the order in which Algolia returns your results. By default, each entry corresponds to a [ranking criteria](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria
|
|
4604
|
+
* Determines the order in which Algolia returns your results. By default, each entry corresponds to a [ranking criteria](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria). The tie-breaking algorithm sequentially applies each criterion in the order they\'re specified. If you configure a replica index for [sorting by an attribute](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/how-to/sort-by-attribute), you put the sorting attribute at the top of the list. **Modifiers** - `asc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in ascending order. - `desc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in descending order. Before you modify the default setting, you should test your changes in the dashboard, and by [A/B testing](https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing).
|
|
4599
4605
|
*/
|
|
4600
4606
|
ranking?: Array<string> | undefined;
|
|
4601
4607
|
/**
|
|
@@ -4603,7 +4609,7 @@ type BaseRecommendIndexSettings = {
|
|
|
4603
4609
|
*/
|
|
4604
4610
|
relevancyStrictness?: number | undefined;
|
|
4605
4611
|
/**
|
|
4606
|
-
* Attributes to highlight By default, all searchable attributes are highlighted. Use `*` to highlight all attributes or use an empty array `[]` to turn off highlighting. Attribute names are case-sensitive With highlighting, strings that match the search query are surrounded by HTML tags defined by `highlightPreTag` and `highlightPostTag`. You can use this to visually highlight matching parts of a search query in your UI For more information, see [Highlighting and snippeting](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/highlighting-snippeting/js
|
|
4612
|
+
* Attributes to highlight By default, all searchable attributes are highlighted. Use `*` to highlight all attributes or use an empty array `[]` to turn off highlighting. Attribute names are case-sensitive With highlighting, strings that match the search query are surrounded by HTML tags defined by `highlightPreTag` and `highlightPostTag`. You can use this to visually highlight matching parts of a search query in your UI For more information, see [Highlighting and snippeting](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/highlighting-snippeting/js).
|
|
4607
4613
|
*/
|
|
4608
4614
|
attributesToHighlight?: Array<string> | undefined;
|
|
4609
4615
|
/**
|
|
@@ -4640,13 +4646,13 @@ type BaseRecommendIndexSettings = {
|
|
|
4640
4646
|
*/
|
|
4641
4647
|
allowTyposOnNumericTokens?: boolean | undefined;
|
|
4642
4648
|
/**
|
|
4643
|
-
* Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance
|
|
4649
|
+
* Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance). Attribute names are case-sensitive Returning only exact matches can help when - [Searching in hyphenated attributes](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/how-to/how-to-search-in-hyphenated-attributes). - Reducing the number of matches when you have too many. This can happen with attributes that are long blocks of text, such as product descriptions Consider alternatives such as `disableTypoToleranceOnWords` or adding synonyms if your attributes have intentional unusual spellings that might look like typos.
|
|
4644
4650
|
*/
|
|
4645
4651
|
disableTypoToleranceOnAttributes?: Array<string> | undefined;
|
|
4646
4652
|
ignorePlurals?: IgnorePlurals | undefined;
|
|
4647
4653
|
removeStopWords?: RemoveStopWords | undefined;
|
|
4648
4654
|
/**
|
|
4649
|
-
* Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [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) languages. To support this, you must place the CJK language **first** **You should always specify a query language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages
|
|
4655
|
+
* Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [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) languages. To support this, you must place the CJK language **first** **You should always specify a query language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
|
|
4650
4656
|
*/
|
|
4651
4657
|
queryLanguages?: Array<SupportedLanguage> | undefined;
|
|
4652
4658
|
/**
|
|
@@ -4699,7 +4705,7 @@ type BaseRecommendIndexSettings = {
|
|
|
4699
4705
|
*/
|
|
4700
4706
|
maxValuesPerFacet?: number | undefined;
|
|
4701
4707
|
/**
|
|
4702
|
-
* Order in which to retrieve facet values - `count`. Facet values are retrieved by decreasing count. The count is the number of matching records containing this facet value - `alpha`. Retrieve facet values alphabetically This setting doesn\'t influence how facet values are displayed in your UI (see `renderingContent`). For more information, see [facet value display](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/facet-display/js
|
|
4708
|
+
* Order in which to retrieve facet values - `count`. Facet values are retrieved by decreasing count. The count is the number of matching records containing this facet value - `alpha`. Retrieve facet values alphabetically This setting doesn\'t influence how facet values are displayed in your UI (see `renderingContent`). For more information, see [facet value display](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/facet-display/js).
|
|
4703
4709
|
*/
|
|
4704
4710
|
sortFacetValuesBy?: string | undefined;
|
|
4705
4711
|
/**
|
|
@@ -4708,7 +4714,7 @@ type BaseRecommendIndexSettings = {
|
|
|
4708
4714
|
attributeCriteriaComputedByMinProximity?: boolean | undefined;
|
|
4709
4715
|
renderingContent?: RenderingContent | undefined;
|
|
4710
4716
|
/**
|
|
4711
|
-
* Whether this search will use [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking
|
|
4717
|
+
* Whether this search will use [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking) This setting only has an effect if you activated Dynamic Re-Ranking for this index in the Algolia dashboard.
|
|
4712
4718
|
*/
|
|
4713
4719
|
enableReRanking?: boolean | undefined;
|
|
4714
4720
|
reRankingApplyFilter?: ReRankingApplyFilter | null | undefined;
|
|
@@ -4747,6 +4753,8 @@ type BaseRecommendRequest = {
|
|
|
4747
4753
|
queryParameters?: RecommendSearchParams | undefined;
|
|
4748
4754
|
};
|
|
4749
4755
|
|
|
4756
|
+
type FallbackParams = RecommendSearchParams & Record<string, unknown>;
|
|
4757
|
+
|
|
4750
4758
|
/**
|
|
4751
4759
|
* Frequently bought together model. This model recommends items that have been purchased within 1 day with the item with the ID `objectID`.
|
|
4752
4760
|
*/
|
|
@@ -4758,12 +4766,11 @@ type FrequentlyBoughtTogether = {
|
|
|
4758
4766
|
* Unique record identifier.
|
|
4759
4767
|
*/
|
|
4760
4768
|
objectID: string;
|
|
4769
|
+
fallbackParameters?: FallbackParams | undefined;
|
|
4761
4770
|
};
|
|
4762
4771
|
|
|
4763
4772
|
type BoughtTogetherQuery = BaseRecommendRequest & FrequentlyBoughtTogether;
|
|
4764
4773
|
|
|
4765
|
-
type FallbackParams = RecommendSearchParams & Record<string, unknown>;
|
|
4766
|
-
|
|
4767
4774
|
/**
|
|
4768
4775
|
* Looking similar model. This model recommends items that look similar to the item with the ID `objectID` based on image attributes in your index.
|
|
4769
4776
|
*/
|
|
@@ -4849,7 +4856,7 @@ type GetRecommendationsParams = {
|
|
|
4849
4856
|
*/
|
|
4850
4857
|
type Exhaustive = {
|
|
4851
4858
|
/**
|
|
4852
|
-
* Whether the facet count is exhaustive (`true`) or approximate (`false`). See the [related discussion](https://support.algolia.com/hc/
|
|
4859
|
+
* Whether the facet count is exhaustive (`true`) or approximate (`false`). See the [related discussion](https://support.algolia.com/hc/articles/4406975248145-Why-are-my-facet-and-hit-counts-not-accurate).
|
|
4853
4860
|
*/
|
|
4854
4861
|
facetsCount?: boolean | undefined;
|
|
4855
4862
|
/**
|
|
@@ -4917,7 +4924,7 @@ type RedirectRuleIndexMetadata = {
|
|
|
4917
4924
|
};
|
|
4918
4925
|
|
|
4919
4926
|
/**
|
|
4920
|
-
* [Redirect results to a URL](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/redirects
|
|
4927
|
+
* [Redirect results to a URL](https://www.algolia.com/doc/guides/managing-results/rules/merchandising-and-promoting/how-to/redirects), this this parameter is for internal use only.
|
|
4921
4928
|
*/
|
|
4922
4929
|
type Redirect = {
|
|
4923
4930
|
index?: Array<RedirectRuleIndexMetadata> | undefined;
|
|
@@ -5018,7 +5025,7 @@ type BaseSearchResponse = Record<string, any> & {
|
|
|
5018
5025
|
*/
|
|
5019
5026
|
userData?: any | null | undefined;
|
|
5020
5027
|
/**
|
|
5021
|
-
* Unique identifier for the query. This is used for [click analytics](https://www.algolia.com/doc/guides/analytics/click-analytics
|
|
5028
|
+
* Unique identifier for the query. This is used for [click analytics](https://www.algolia.com/doc/guides/analytics/click-analytics).
|
|
5022
5029
|
*/
|
|
5023
5030
|
queryID?: string | undefined;
|
|
5024
5031
|
/**
|
|
@@ -5260,7 +5267,7 @@ type BaseSearchParamsWithoutQuery = {
|
|
|
5260
5267
|
*/
|
|
5261
5268
|
similarQuery?: string | undefined;
|
|
5262
5269
|
/**
|
|
5263
|
-
* Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can\'t use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can\'t combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering
|
|
5270
|
+
* Filter expression to only include items that match the filter criteria in the response. You can use these filter expressions: - **Numeric filters.** `<facet> <op> <number>`, where `<op>` is one of `<`, `<=`, `=`, `!=`, `>`, `>=`. - **Ranges.** `<facet>:<lower> TO <upper>` where `<lower>` and `<upper>` are the lower and upper limits of the range (inclusive). - **Facet filters.** `<facet>:<value>` where `<facet>` is a facet attribute (case-sensitive) and `<value>` a facet value. - **Tag filters.** `_tags:<value>` or just `<value>` (case-sensitive). - **Boolean filters.** `<facet>: true | false`. You can combine filters with `AND`, `OR`, and `NOT` operators with the following restrictions: - You can only combine filters of the same type with `OR`. **Not supported:** `facet:value OR num > 3`. - You can\'t use `NOT` with combinations of filters. **Not supported:** `NOT(facet:value OR facet:value)` - You can\'t combine conjunctions (`AND`) with `OR`. **Not supported:** `facet:value OR (facet:value AND facet:value)` Use quotes around your filters, if the facet attribute name or facet value has spaces, keywords (`OR`, `AND`, `NOT`), or quotes. If a facet attribute is an array, the filter matches if it matches at least one element of the array. For more information, see [Filters](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering).
|
|
5264
5271
|
*/
|
|
5265
5272
|
filters?: string | undefined;
|
|
5266
5273
|
facetFilters?: FacetFilters | undefined;
|
|
@@ -5327,7 +5334,7 @@ type BaseSearchParamsWithoutQuery = {
|
|
|
5327
5334
|
*/
|
|
5328
5335
|
personalizationImpact?: number | undefined;
|
|
5329
5336
|
/**
|
|
5330
|
-
* Unique pseudonymous or anonymous user identifier. This helps with analytics and click and conversion events. For more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken
|
|
5337
|
+
* Unique pseudonymous or anonymous user identifier. This helps with analytics and click and conversion events. For more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).
|
|
5331
5338
|
*/
|
|
5332
5339
|
userToken?: string | undefined;
|
|
5333
5340
|
/**
|
|
@@ -5339,7 +5346,7 @@ type BaseSearchParamsWithoutQuery = {
|
|
|
5339
5346
|
*/
|
|
5340
5347
|
synonyms?: boolean | undefined;
|
|
5341
5348
|
/**
|
|
5342
|
-
* Whether to include a `queryID` attribute in the response The query ID is a unique identifier for a search query and is required for tracking [click and conversion events](https://www.algolia.com/guides/sending-events/getting-started
|
|
5349
|
+
* Whether to include a `queryID` attribute in the response The query ID is a unique identifier for a search query and is required for tracking [click and conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started).
|
|
5343
5350
|
*/
|
|
5344
5351
|
clickAnalytics?: boolean | undefined;
|
|
5345
5352
|
/**
|
|
@@ -5347,7 +5354,7 @@ type BaseSearchParamsWithoutQuery = {
|
|
|
5347
5354
|
*/
|
|
5348
5355
|
analytics?: boolean | undefined;
|
|
5349
5356
|
/**
|
|
5350
|
-
* Tags to apply to the query for [segmenting analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments
|
|
5357
|
+
* Tags to apply to the query for [segmenting analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments).
|
|
5351
5358
|
*/
|
|
5352
5359
|
analyticsTags?: Array<string> | undefined;
|
|
5353
5360
|
/**
|
|
@@ -5383,7 +5390,7 @@ type IndexSettingsAsSearchParams = {
|
|
|
5383
5390
|
*/
|
|
5384
5391
|
attributesToRetrieve?: Array<string> | undefined;
|
|
5385
5392
|
/**
|
|
5386
|
-
* Determines the order in which Algolia returns your results. By default, each entry corresponds to a [ranking criteria](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria
|
|
5393
|
+
* Determines the order in which Algolia returns your results. By default, each entry corresponds to a [ranking criteria](https://www.algolia.com/doc/guides/managing-results/relevance-overview/in-depth/ranking-criteria). The tie-breaking algorithm sequentially applies each criterion in the order they\'re specified. If you configure a replica index for [sorting by an attribute](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/how-to/sort-by-attribute), you put the sorting attribute at the top of the list. **Modifiers** - `asc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in ascending order. - `desc(\"ATTRIBUTE\")`. Sort the index by the values of an attribute, in descending order. Before you modify the default setting, you should test your changes in the dashboard, and by [A/B testing](https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing).
|
|
5387
5394
|
*/
|
|
5388
5395
|
ranking?: Array<string> | undefined;
|
|
5389
5396
|
/**
|
|
@@ -5391,7 +5398,7 @@ type IndexSettingsAsSearchParams = {
|
|
|
5391
5398
|
*/
|
|
5392
5399
|
relevancyStrictness?: number | undefined;
|
|
5393
5400
|
/**
|
|
5394
|
-
* Attributes to highlight By default, all searchable attributes are highlighted. Use `*` to highlight all attributes or use an empty array `[]` to turn off highlighting. Attribute names are case-sensitive With highlighting, strings that match the search query are surrounded by HTML tags defined by `highlightPreTag` and `highlightPostTag`. You can use this to visually highlight matching parts of a search query in your UI For more information, see [Highlighting and snippeting](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/highlighting-snippeting/js
|
|
5401
|
+
* Attributes to highlight By default, all searchable attributes are highlighted. Use `*` to highlight all attributes or use an empty array `[]` to turn off highlighting. Attribute names are case-sensitive With highlighting, strings that match the search query are surrounded by HTML tags defined by `highlightPreTag` and `highlightPostTag`. You can use this to visually highlight matching parts of a search query in your UI For more information, see [Highlighting and snippeting](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/highlighting-snippeting/js).
|
|
5395
5402
|
*/
|
|
5396
5403
|
attributesToHighlight?: Array<string> | undefined;
|
|
5397
5404
|
/**
|
|
@@ -5432,13 +5439,13 @@ type IndexSettingsAsSearchParams = {
|
|
|
5432
5439
|
*/
|
|
5433
5440
|
allowTyposOnNumericTokens?: boolean | undefined;
|
|
5434
5441
|
/**
|
|
5435
|
-
* Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance
|
|
5442
|
+
* Attributes for which you want to turn off [typo tolerance](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance). Attribute names are case-sensitive Returning only exact matches can help when - [Searching in hyphenated attributes](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/typo-tolerance/how-to/how-to-search-in-hyphenated-attributes). - Reducing the number of matches when you have too many. This can happen with attributes that are long blocks of text, such as product descriptions Consider alternatives such as `disableTypoToleranceOnWords` or adding synonyms if your attributes have intentional unusual spellings that might look like typos.
|
|
5436
5443
|
*/
|
|
5437
5444
|
disableTypoToleranceOnAttributes?: Array<string> | undefined;
|
|
5438
5445
|
ignorePlurals?: IgnorePlurals | undefined;
|
|
5439
5446
|
removeStopWords?: RemoveStopWords | undefined;
|
|
5440
5447
|
/**
|
|
5441
|
-
* Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [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) languages. To support this, you must place the CJK language **first** **You should always specify a query language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages
|
|
5448
|
+
* Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [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) languages. To support this, you must place the CJK language **first** **You should always specify a query language.** If you don\'t specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
|
|
5442
5449
|
*/
|
|
5443
5450
|
queryLanguages?: Array<SupportedLanguage> | undefined;
|
|
5444
5451
|
/**
|
|
@@ -5493,7 +5500,7 @@ type IndexSettingsAsSearchParams = {
|
|
|
5493
5500
|
*/
|
|
5494
5501
|
maxValuesPerFacet?: number | undefined;
|
|
5495
5502
|
/**
|
|
5496
|
-
* Order in which to retrieve facet values - `count`. Facet values are retrieved by decreasing count. The count is the number of matching records containing this facet value - `alpha`. Retrieve facet values alphabetically This setting doesn\'t influence how facet values are displayed in your UI (see `renderingContent`). For more information, see [facet value display](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/facet-display/js
|
|
5503
|
+
* Order in which to retrieve facet values - `count`. Facet values are retrieved by decreasing count. The count is the number of matching records containing this facet value - `alpha`. Retrieve facet values alphabetically This setting doesn\'t influence how facet values are displayed in your UI (see `renderingContent`). For more information, see [facet value display](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/facet-display/js).
|
|
5497
5504
|
*/
|
|
5498
5505
|
sortFacetValuesBy?: string | undefined;
|
|
5499
5506
|
/**
|
|
@@ -5502,7 +5509,7 @@ type IndexSettingsAsSearchParams = {
|
|
|
5502
5509
|
attributeCriteriaComputedByMinProximity?: boolean | undefined;
|
|
5503
5510
|
renderingContent?: RenderingContent | undefined;
|
|
5504
5511
|
/**
|
|
5505
|
-
* Whether this search will use [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking
|
|
5512
|
+
* Whether this search will use [Dynamic Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking) This setting only has an effect if you activated Dynamic Re-Ranking for this index in the Algolia dashboard.
|
|
5506
5513
|
*/
|
|
5507
5514
|
enableReRanking?: boolean | undefined;
|
|
5508
5515
|
reRankingApplyFilter?: ReRankingApplyFilter | null | undefined;
|
|
@@ -5568,7 +5575,7 @@ type FacetHits = {
|
|
|
5568
5575
|
*/
|
|
5569
5576
|
highlighted: string;
|
|
5570
5577
|
/**
|
|
5571
|
-
* Number of records with this facet value. [The count may be approximated](https://support.algolia.com/hc/
|
|
5578
|
+
* Number of records with this facet value. [The count may be approximated](https://support.algolia.com/hc/articles/4406975248145-Why-are-my-facet-and-hit-counts-not-accurate).
|
|
5572
5579
|
*/
|
|
5573
5580
|
count: number;
|
|
5574
5581
|
};
|
|
@@ -5579,7 +5586,7 @@ type SearchForFacetValuesResponse$1 = {
|
|
|
5579
5586
|
*/
|
|
5580
5587
|
facetHits: Array<FacetHits>;
|
|
5581
5588
|
/**
|
|
5582
|
-
* Whether the facet count is exhaustive (true) or approximate (false). For more information, see [Why are my facet and hit counts not accurate](https://support.algolia.com/hc/
|
|
5589
|
+
* Whether the facet count is exhaustive (true) or approximate (false). For more information, see [Why are my facet and hit counts not accurate](https://support.algolia.com/hc/articles/4406975248145-Why-are-my-facet-and-hit-counts-not-accurate).
|
|
5583
5590
|
*/
|
|
5584
5591
|
exhaustiveFacetsCount: boolean;
|
|
5585
5592
|
/**
|
|
@@ -6679,6 +6686,21 @@ declare type InsightsOption = {
|
|
|
6679
6686
|
interface AutocompleteOptions<TItem extends BaseItem> extends AutocompleteOptions$1<TItem>, InsightsOption {
|
|
6680
6687
|
}
|
|
6681
6688
|
|
|
6689
|
+
interface DocSearchModalShortcuts {
|
|
6690
|
+
/**
|
|
6691
|
+
* Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.
|
|
6692
|
+
*
|
|
6693
|
+
* @default true
|
|
6694
|
+
*/
|
|
6695
|
+
'Ctrl/Cmd+K'?: boolean;
|
|
6696
|
+
/**
|
|
6697
|
+
* Enable/disable the / shortcut to open the DocSearch modal.
|
|
6698
|
+
*
|
|
6699
|
+
* @default true
|
|
6700
|
+
*/
|
|
6701
|
+
'/'?: boolean;
|
|
6702
|
+
}
|
|
6703
|
+
|
|
6682
6704
|
// ==================================================================================================
|
|
6683
6705
|
// JSON Schema Draft 07
|
|
6684
6706
|
// ==================================================================================================
|
|
@@ -8362,21 +8384,6 @@ type InternalDocSearchHit = DocSearchHit & {
|
|
|
8362
8384
|
__docsearch_parent: InternalDocSearchHit | null;
|
|
8363
8385
|
};
|
|
8364
8386
|
|
|
8365
|
-
interface KeyboardShortcuts {
|
|
8366
|
-
/**
|
|
8367
|
-
* Enable/disable the Ctrl/Cmd+K shortcut to toggle the search modal.
|
|
8368
|
-
*
|
|
8369
|
-
* @default true
|
|
8370
|
-
*/
|
|
8371
|
-
'Ctrl/Cmd+K'?: boolean;
|
|
8372
|
-
/**
|
|
8373
|
-
* Enable/disable the / shortcut to open the search modal.
|
|
8374
|
-
*
|
|
8375
|
-
* @default true
|
|
8376
|
-
*/
|
|
8377
|
-
'/'?: boolean;
|
|
8378
|
-
}
|
|
8379
|
-
|
|
8380
8387
|
type StoredDocSearchHit = Omit<DocSearchHit, '_highlightResult' | '_snippetResult'>;
|
|
8381
8388
|
|
|
8382
8389
|
type DocSearchTranslations = Partial<{
|
|
@@ -8550,8 +8557,10 @@ interface DocSearchProps$1 {
|
|
|
8550
8557
|
recentSearchesWithFavoritesLimit?: number;
|
|
8551
8558
|
/**
|
|
8552
8559
|
* Configuration for keyboard shortcuts. Allows enabling/disabling specific shortcuts.
|
|
8560
|
+
*
|
|
8561
|
+
* @default `{ 'Ctrl/Cmd+K': true, '/': true }`
|
|
8553
8562
|
*/
|
|
8554
|
-
keyboardShortcuts?:
|
|
8563
|
+
keyboardShortcuts?: DocSearchModalShortcuts;
|
|
8555
8564
|
}
|
|
8556
8565
|
|
|
8557
8566
|
type ButtonTranslations = Partial<{
|
|
@@ -8610,6 +8619,18 @@ type AskAiScreenTranslations = Partial<{
|
|
|
8610
8619
|
* Message that's shown when user has stopped the streaming of a message.
|
|
8611
8620
|
*/
|
|
8612
8621
|
stoppedStreamingText: string;
|
|
8622
|
+
/**
|
|
8623
|
+
* Error title shown if there is an error while chatting.
|
|
8624
|
+
*/
|
|
8625
|
+
errorTitleText: string;
|
|
8626
|
+
/**
|
|
8627
|
+
* Message shown when thread depth limit is exceeded (AI-217 error).
|
|
8628
|
+
*/
|
|
8629
|
+
threadDepthExceededMessage: string;
|
|
8630
|
+
/**
|
|
8631
|
+
* Button text for starting a new conversation after thread depth error.
|
|
8632
|
+
*/
|
|
8633
|
+
startNewConversationButtonText: string;
|
|
8613
8634
|
}>;
|
|
8614
8635
|
|
|
8615
8636
|
type ErrorScreenTranslations = Partial<{
|
|
@@ -8666,6 +8687,7 @@ type SearchBoxTranslations = Partial<{
|
|
|
8666
8687
|
conversationHistoryTitle: string;
|
|
8667
8688
|
startNewConversationText: string;
|
|
8668
8689
|
viewConversationHistoryText: string;
|
|
8690
|
+
threadDepthErrorPlaceholder: string;
|
|
8669
8691
|
}>;
|
|
8670
8692
|
|
|
8671
8693
|
type ModalTranslations = Partial<{
|