algoliasearch 5.0.0-alpha.1 → 5.0.0-alpha.4

package/lite/model/indexSettingsAsSearchParams.ts

@@ -2,6 +2,7 @@
 
 import type { AdvancedSyntaxFeatures } from './advancedSyntaxFeatures';
 import type { AlternativesAsExact } from './alternativesAsExact';
+import type { Distinct } from './distinct';
 import type { ExactOnSingleWordQuery } from './exactOnSingleWordQuery';
 import type { IgnorePlurals } from './ignorePlurals';
 import type { QueryType } from './queryType';
@@ -15,147 +16,185 @@ export type IndexSettingsAsSearchParams = {
    * The complete list of attributes that will be used for faceting.
    */
   attributesForFaceting?: string[];
+
   /**
    * List of attributes that can\'t be retrieved at query time.
    */
   unretrievableAttributes?: string[];
+
   /**
    * This parameter controls which attributes to retrieve and which not to retrieve.
    */
   attributesToRetrieve?: string[];
+
   /**
    * Restricts a given query to look in only a subset of your searchable attributes.
    */
   restrictSearchableAttributes?: string[];
+
   /**
    * Controls how Algolia should sort your results.
    */
   ranking?: string[];
+
   /**
    * Specifies the custom ranking criterion.
    */
   customRanking?: string[];
+
   /**
    * Controls the relevancy threshold below which less relevant results aren\'t included in the results.
    */
   relevancyStrictness?: number;
+
   /**
    * List of attributes to highlight.
    */
   attributesToHighlight?: string[];
+
   /**
    * List of attributes to snippet, with an optional maximum number of words to snippet.
    */
   attributesToSnippet?: string[];
+
   /**
    * The HTML string to insert before the highlighted parts in all highlight and snippet results.
    */
   highlightPreTag?: string;
+
   /**
    * The HTML string to insert after the highlighted parts in all highlight and snippet results.
    */
   highlightPostTag?: string;
+
   /**
    * String used as an ellipsis indicator when a snippet is truncated.
    */
   snippetEllipsisText?: string;
+
   /**
    * Restrict highlighting and snippeting to items that matched the query.
    */
   restrictHighlightAndSnippetArrays?: boolean;
+
   /**
    * Set the number of hits per page.
    */
   hitsPerPage?: number;
+
   /**
    * Minimum number of characters a word in the query string must contain to accept matches with 1 typo.
    */
   minWordSizefor1Typo?: number;
+
   /**
    * Minimum number of characters a word in the query string must contain to accept matches with 2 typos.
    */
   minWordSizefor2Typos?: number;
+
   typoTolerance?: TypoTolerance;
+
   /**
    * Whether to allow typos on numbers (\"numeric tokens\") in the query string.
    */
   allowTyposOnNumericTokens?: boolean;
+
   /**
    * List of attributes on which you want to disable typo tolerance.
    */
   disableTypoToleranceOnAttributes?: string[];
+
   ignorePlurals?: IgnorePlurals;
+
   removeStopWords?: RemoveStopWords;
+
   /**
    * List of characters that the engine shouldn\'t automatically normalize.
    */
   keepDiacriticsOnCharacters?: string;
+
   /**
    * Sets the languages to be used by language-specific settings and functionalities such as ignorePlurals, removeStopWords, and CJK word-detection.
    */
   queryLanguages?: string[];
+
   /**
    * Splits compound words into their composing atoms in the query.
    */
   decompoundQuery?: boolean;
+
   /**
    * Whether Rules should be globally enabled.
    */
   enableRules?: boolean;
+
   /**
    * Enable the Personalization feature.
    */
   enablePersonalization?: boolean;
+
   queryType?: QueryType;
+
   removeWordsIfNoResults?: RemoveWordsIfNoResults;
+
   /**
    * Enables the advanced query syntax.
    */
   advancedSyntax?: boolean;
+
   /**
    * A list of words that should be considered as optional when found in the query.
    */
   optionalWords?: string[];
+
   /**
    * List of attributes on which you want to disable the exact ranking criterion.
    */
   disableExactOnAttributes?: string[];
+
   exactOnSingleWordQuery?: ExactOnSingleWordQuery;
+
   /**
    * List of alternatives that should be considered an exact match by the exact ranking criterion.
    */
   alternativesAsExact?: AlternativesAsExact[];
+
   /**
    * Allows you to specify which advanced syntax features are active when ‘advancedSyntax\' is enabled.
    */
   advancedSyntaxFeatures?: AdvancedSyntaxFeatures[];
-  /**
-   * Enables de-duplication or grouping of results.
-   */
-  distinct?: number;
+
+  distinct?: Distinct;
+
   /**
    * Whether to take into account an index\'s synonyms for a particular search.
    */
   synonyms?: boolean;
+
   /**
    * Whether to highlight and snippet the original word that matches the synonym or the synonym itself.
    */
   replaceSynonymsInHighlight?: boolean;
+
   /**
    * Precision of the proximity ranking criterion.
    */
   minProximity?: number;
+
   /**
    * Choose which fields to return in the API response. This parameters applies to search and browse queries.
    */
   responseFields?: string[];
+
   /**
    * Maximum number of facet hits to return during a search for facet values. For performance reasons, the maximum allowed number of returned values is 100.
    */
   maxFacetHits?: number;
+
   /**
    * When attribute is ranked above proximity in your ranking formula, proximity is used to select which searchable attribute is matched in the attribute ranking stage.
    */
   attributeCriteriaComputedByMinProximity?: boolean;
+
   renderingContent?: RenderingContent;
 };

package/lite/model/languages.ts

@@ -7,6 +7,8 @@ import type { DictionaryLanguage } from './dictionaryLanguage';
  */
 export type Languages = {
   plurals: DictionaryLanguage | null;
+
   stopwords: DictionaryLanguage | null;
+
   compounds: DictionaryLanguage | null;
 };

package/lite/model/listIndicesResponse.ts

@@ -6,7 +6,8 @@ export type ListIndicesResponse = {
   /**
    * List of the fetched indices.
    */
-  items?: FetchedIndex[];
+  items: FetchedIndex[];
+
   /**
    * Number of pages.
    */

package/lite/model/matchedGeoLocation.ts

@@ -5,10 +5,12 @@ export type MatchedGeoLocation = {
    * Latitude of the matched location.
    */
   lat?: number;
+
   /**
    * Longitude of the matched location.
    */
   lng?: number;
+
   /**
    * Distance between the matched location and the search location (in meters).
    */

package/lite/model/params.ts

@@ -9,7 +9,10 @@ import type { RenderingContent } from './renderingContent';
  */
 export type Params = {
   query?: ConsequenceQuery;
+
   automaticFacetFilters?: AutomaticFacetFilters;
+
   automaticOptionalFacetFilters?: AutomaticFacetFilters;
+
   renderingContent?: RenderingContent;
 };

package/lite/model/personalization.ts

@@ -5,10 +5,12 @@ export type Personalization = {
    * The score of the filters.
    */
   filtersScore?: number;
+
   /**
    * The score of the ranking.
    */
   rankingScore?: number;
+
   /**
    * The score of the event.
    */

package/lite/model/promoteObjectID.ts

@@ -8,6 +8,7 @@ export type PromoteObjectID = {
    * Unique identifier of the object to promote.
    */
   objectID: string;
+
   /**
    * The position to promote the objects to (zero-based). If you pass objectIDs, the objects are placed at this position as a group. For example, if you pass four objectIDs to position 0, the objects take the first four positions.
    */

package/lite/model/promoteObjectIDs.ts

@@ -8,6 +8,7 @@ export type PromoteObjectIDs = {
    * Array of unique identifiers of the objects to promote.
    */
   objectIDs: string[];
+
   /**
    * The position to promote the objects to (zero-based). If you pass objectIDs, the objects are placed at this position as a group. For example, if you pass four objectIDs to position 0, the objects take the first four positions.
    */

package/lite/model/rankingInfo.ts

@@ -8,44 +8,56 @@ export type RankingInfo = {
    * This field is reserved for advanced usage.
    */
   filters: number;
+
   /**
    * Position of the most important matched attribute in the attributes to index list.
    */
   firstMatchedWord: number;
+
   /**
    * Distance between the geo location in the search query and the best matching geo location in the record, divided by the geo precision (in meters).
    */
   geoDistance: number;
+
   /**
    * Precision used when computing the geo distance, in meters.
    */
   geoPrecision?: number;
+
   matchedGeoLocation?: MatchedGeoLocation;
+
   personalization?: Personalization;
+
   /**
    * Number of exactly matched words.
    */
   nbExactWords: number;
+
   /**
    * Number of typos encountered when matching the record.
    */
   nbTypos: number;
+
   /**
    * Present and set to true if a Rule promoted the hit.
    */
   promoted: boolean;
+
   /**
    * When the query contains more than one word, the sum of the distances between matched words (in meters).
    */
   proximityDistance?: number;
+
   /**
    * Custom ranking for the object, expressed as a single integer value.
    */
   userScore: number;
+
   /**
    * Number of matched words, including prefixes and typos.
    */
   words: number;
+
   /**
    * Wether the record are promoted by the re-ranking strategy.
    */

package/lite/model/rule.ts

@@ -12,19 +12,24 @@ export type Rule = {
    * Unique identifier of the object.
    */
   objectID: string;
+
   /**
    * A list of conditions that should apply to activate a Rule. You can use up to 25 conditions per Rule.
    */
   conditions?: Condition[];
+
   consequence?: Consequence;
+
   /**
    * This field is intended for Rule management purposes, in particular to ease searching for Rules and presenting them to human readers. It\'s not interpreted by the API.
    */
   description?: string;
+
   /**
    * Whether the Rule is enabled. Disabled Rules remain in the index, but aren\'t applied at query time.
    */
   enabled?: boolean;
+
   /**
    * By default, Rules are permanently valid. When validity periods are specified, the Rule applies only during those periods; it\'s ignored the rest of the time. The list must not be empty.
    */

package/lite/model/searchForFacetsOptions.ts

@@ -7,17 +7,21 @@ export type SearchForFacetsOptions = {
    * The `facet` name.
    */
   facet: string;
+
   /**
    * The Algolia index name.
    */
   indexName: string;
+
   /**
    * Text to search inside the facet\'s values.
    */
   facetQuery?: string;
+
   /**
    * Maximum number of facet hits to return during a search for facet values. For performance reasons, the maximum allowed number of returned values is 100.
    */
   maxFacetHits?: number;
+
   type: SearchTypeFacet;
 };

package/lite/model/searchForHitsOptions.ts

@@ -7,5 +7,6 @@ export type SearchForHitsOptions = {
    * The Algolia index name.
    */
   indexName: string;
+
   type?: SearchTypeDefault;
 } & { facet?: never; maxFacetHits?: never; facetQuery?: never };

package/lite/model/searchHits.ts

@@ -2,6 +2,6 @@
 
 import type { Hit } from './hit';
 
-export type SearchHits<T> = {
-  hits?: Array<Hit<T>>;
+export type SearchHits<T = Record<string, any>> = {
+  hits: Array<Hit<T>>;
 };

package/lite/model/searchMethodParams.ts

@@ -5,5 +5,6 @@ import type { SearchStrategy } from './searchStrategy';
 
 export type SearchMethodParams = {
   requests: SearchQuery[];
+
   strategy?: SearchStrategy;
 };

package/lite/model/searchResponse.ts

@@ -3,4 +3,5 @@
 import type { BaseSearchResponse } from './baseSearchResponse';
 import type { SearchHits } from './searchHits';
 
-export type SearchResponse<T> = BaseSearchResponse & SearchHits<T>;
+export type SearchResponse<T = Record<string, any>> = BaseSearchResponse &
+  SearchHits<T>;

package/lite/model/searchResponses.ts

@@ -2,6 +2,6 @@
 
 import type { SearchResponse } from './searchResponse';
 
-export type SearchResponses<T> = {
+export type SearchResponses<T = Record<string, any>> = {
   results: Array<SearchResponse<T>>;
 };

package/lite/model/searchSynonymsResponse.ts

@@ -7,6 +7,7 @@ export type SearchSynonymsResponse = Record<string, any> & {
    * Array of synonym objects.
    */
   hits: SynonymHit[];
+
   /**
    * Number of hits that the search query matched.
    */

package/lite/model/snippetResultOption.ts

@@ -10,5 +10,6 @@ export type SnippetResultOption = {
    * Markup text with occurrences highlighted.
    */
   value: string;
+
   matchLevel: MatchLevel;
 };

package/lite/model/source.ts

@@ -8,6 +8,7 @@ export type Source = {
    * The IP range of the source.
    */
   source: string;
+
   /**
    * The description of the source.
    */

package/lite/model/standardEntries.ts

@@ -8,10 +8,12 @@ export type StandardEntries = {
    * Language ISO code.
    */
   plurals?: Record<string, boolean> | null;
+
   /**
    * Language ISO code.
    */
   stopwords?: Record<string, boolean> | null;
+
   /**
    * Language ISO code.
    */

package/lite/model/synonymHit.ts

@@ -11,30 +11,38 @@ export type SynonymHit = {
    * Unique identifier of the synonym object to be created or updated.
    */
   objectID: string;
+
   type: SynonymType;
+
   /**
    * Words or phrases to be considered equivalent.
    */
   synonyms?: string[];
+
   /**
    * Word or phrase to appear in query strings (for onewaysynonym).
    */
   input?: string;
+
   /**
    * Word or phrase to appear in query strings (for altcorrection1 and altcorrection2).
    */
   word?: string;
+
   /**
    * Words to be matched in records.
    */
   corrections?: string[];
+
   /**
    * Token to be put inside records.
    */
   placeholder?: string;
+
   /**
    * List of query words that will match the token.
    */
   replacements?: string[];
+
   _highlightResult?: SynonymHitHighlightResult;
 };

package/lite/model/synonymHitHighlightResult.ts

@@ -10,5 +10,6 @@ export type SynonymHitHighlightResult = {
    * Show highlighted section and words matched on a query.
    */
   type?: Record<string, HighlightResult>;
+
   synonyms?: Array<Record<string, HighlightResult>>;
 };

package/lite/model/timeRange.ts

@@ -5,6 +5,7 @@ export type TimeRange = {
    * Lower bound of the time range (Unix timestamp).
    */
   from: number;
+
   /**
    * Upper bound of the time range (Unix timestamp).
    */

package/lite/model/updatedRuleResponse.ts

@@ -5,10 +5,12 @@ export type UpdatedRuleResponse = {
    * Unique identifier of the object.
    */
   objectID: string;
+
   /**
    * Date of last update (ISO-8601 format).
    */
   updatedAt: string;
+
   /**
    * TaskID of the task to wait for.
    */

package/lite/model/userId.ts

@@ -8,14 +8,17 @@ export type UserId = {
    * UserID of the user.
    */
   userID: string;
+
   /**
    * Cluster on which the user is assigned.
    */
   clusterName: string;
+
   /**
    * Number of records belonging to the user.
    */
   nbRecords: number;
+
   /**
    * Data size used by the user.
    */

package/lite/model/value.ts

@@ -7,5 +7,6 @@ export type Value = {
    * Pinned order of facet lists.
    */
   order?: string[];
+
   sortRemainingBy?: SortRemainingBy;
 };

package/lite/src/liteClient.ts

@@ -22,7 +22,7 @@ import type {
 import type { SearchMethodParams } from '../model/searchMethodParams';
 import type { SearchResponses } from '../model/searchResponses';
 
-export const apiClientVersion = '5.0.0-alpha.1';
+export const apiClientVersion = '5.0.0-alpha.4';
 
 function getDefaultHosts(appId: string): Host[] {
   return (
@@ -89,12 +89,29 @@ export function createLiteClient({
 
   return {
     transporter,
+
+    /**
+     * The `appId` currently in use.
+     */
+    appId: appIdOption,
+
+    /**
+     * Clears the cache of the transporter for the `requestsCache` and `responsesCache` properties.
+     */
+    clearCache(): Promise<void> {
+      return Promise.all([
+        transporter.requestsCache.clear(),
+        transporter.responsesCache.clear(),
+      ]).then(() => undefined);
+    },
+
     /**
      * Get the value of the `algoliaAgent`, used by our libraries internally and telemetry system.
      */
     get _ua(): string {
       return transporter.algoliaAgent.value;
     },
+
     /**
      * Adds a `segment` to the `x-algolia-agent` sent with every requests.
      *
@@ -104,6 +121,7 @@ export function createLiteClient({
     addAlgoliaAgent(segment: string, version?: string): void {
       transporter.algoliaAgent.add({ segment, version });
     },
+
     /**
      * This method allow you to send requests to the Algolia REST API.
      *
@@ -204,4 +222,7 @@ export function createLiteClient({
   };
 }
 
+/**
+ * The client type.
+ */
 export type LiteClient = ReturnType<typeof createLiteClient>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "algoliasearch",
-  "version": "5.0.0-alpha.1",
+  "version": "5.0.0-alpha.4",
   "description": "A fully-featured and blazing-fast JavaScript API client to interact with Algolia API.",
   "repository": "algolia/algoliasearch-client-javascript",
   "license": "MIT",
@@ -58,17 +58,17 @@
     "test": "jest"
   },
   "dependencies": {
-    "@algolia/client-abtesting": "5.0.0-alpha.1",
-    "@algolia/client-analytics": "5.0.0-alpha.1",
-    "@algolia/client-common": "5.0.0-alpha.1",
-    "@algolia/client-personalization": "5.0.0-alpha.1",
-    "@algolia/client-search": "5.0.0-alpha.1",
-    "@algolia/requester-browser-xhr": "5.0.0-alpha.1",
-    "@algolia/requester-node-http": "5.0.0-alpha.1"
+    "@algolia/client-abtesting": "5.0.0-alpha.4",
+    "@algolia/client-analytics": "5.0.0-alpha.4",
+    "@algolia/client-common": "5.0.0-alpha.4",
+    "@algolia/client-personalization": "5.0.0-alpha.4",
+    "@algolia/client-search": "5.0.0-alpha.4",
+    "@algolia/requester-browser-xhr": "5.0.0-alpha.4",
+    "@algolia/requester-node-http": "5.0.0-alpha.4"
   },
   "devDependencies": {
     "@types/jest": "28.1.6",
-    "@types/node": "16.11.45",
+    "@types/node": "16.11.47",
     "jest": "28.1.3",
     "ts-jest": "28.0.7",
     "typescript": "4.7.4"

package/dist/algoliasearch/lite/model/attributeOrBuiltInOperation.d.ts

@@ -1,3 +0,0 @@
-import type { BuiltInOperation } from './builtInOperation';
-export declare type AttributeOrBuiltInOperation = BuiltInOperation | string;
-//# sourceMappingURL=attributeOrBuiltInOperation.d.ts.map

package/dist/algoliasearch/lite/model/attributeOrBuiltInOperation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attributeOrBuiltInOperation.d.ts","sourceRoot":"","sources":["../../../../../../packages/algoliasearch/lite/model/attributeOrBuiltInOperation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,oBAAY,2BAA2B,GAAG,gBAAgB,GAAG,MAAM,CAAC"}

package/dist/algoliasearch/lite/model/createdAtObject.d.ts

@@ -1,7 +0,0 @@
-export declare type CreatedAtObject = {
-    /**
-     * Date of creation (ISO-8601 format).
-     */
-    createdAt: string;
-};
-//# sourceMappingURL=createdAtObject.d.ts.map

package/dist/algoliasearch/lite/model/createdAtObject.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createdAtObject.d.ts","sourceRoot":"","sources":["../../../../../../packages/algoliasearch/lite/model/createdAtObject.ts"],"names":[],"mappings":"AAEA,oBAAY,eAAe,GAAG;IAC5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}