feat(core): introduce Requester API (#540)

Co-authored-by: Sarah Dayan <[email protected]>
algolia · Apr 22, 2021 · be1cee7 · be1cee7
1 parent f5254e9
commit be1cee7
Show file tree

Hide file tree

Showing 106 changed files with 2,373 additions and 1,603 deletions.
diff --git a/.eslintignore b/.eslintignore
@@ -4,3 +4,4 @@ build
 coverage
 dist
 node_modules
+.parcel-cache
diff --git a/README.md b/README.md
@@ -106,7 +106,7 @@ You can find more on the [documentation](https://autocomplete.algolia.com).
 | [`autocomplete-plugin-recent-searches`](packages/autocomplete-plugin-recent-searches) | A plugin to add recent searches to Algolia Autocomplete | [Documentation](https://autocomplete.algolia.com/docs/createLocalStorageRecentSearchesPlugin) |
 | [`autocomplete-plugin-query-suggestions`](packages/autocomplete-plugin-query-suggestions) | A plugin to add query suggestions to Algolia Autocomplete | [Documentation](https://autocomplete.algolia.com/docs/createQuerySuggestionsPlugin) |
 | [`autocomplete-plugin-algolia-insights`](packages/autocomplete-plugin-algolia-insights) | A plugin to add Algolia Insights to Algolia Autocomplete | [Documentation](https://autocomplete.algolia.com/docs/createAlgoliaInsightsPlugin) |
-| [`autocomplete-preset-algolia`](packages/autocomplete-preset-algolia) | Presets to use Algolia features with Autocomplete | [Documentation](https://autocomplete.algolia.com/docs/getAlgoliaHits) |
+| [`autocomplete-preset-algolia`](packages/autocomplete-preset-algolia) | Presets to use Algolia features with Autocomplete | [Documentation](https://autocomplete.algolia.com/docs/getAlgoliaResults) |
 | [`autocomplete-theme-classic`](packages/autocomplete-theme-classic) | Classic theme for Autocomplete | [Documentation](https://autocomplete.algolia.com/docs/autocomplete-theme-classic) |
 
 ## Showcase

diff --git a/bundlesize.config.json b/bundlesize.config.json
@@ -2,15 +2,15 @@
   "files": [
     {
       "path": "packages/autocomplete-core/dist/umd/index.production.js",
-      "maxSize": "4.75 kB"
+      "maxSize": "5 kB"
     },
     {
       "path": "packages/autocomplete-js/dist/umd/index.production.js",
-      "maxSize": "14.75 kB"
+      "maxSize": "15.25 kB"
     },
     {
       "path": "packages/autocomplete-preset-algolia/dist/umd/index.production.js",
-      "maxSize": "2 kB"
+      "maxSize": "2.25 kB"
     },
     {
       "path": "packages/autocomplete-plugin-algolia-insights/dist/umd/index.production.js",

diff --git a/cypress/test-apps/js/app.tsx b/cypress/test-apps/js/app.tsx
@@ -2,7 +2,7 @@
 import {
   autocomplete,
   AutocompleteComponents,
-  getAlgoliaHits,
+  getAlgoliaResults,
 } from '@algolia/autocomplete-js';
 import {
   AutocompleteInsightsApi,
@@ -78,7 +78,7 @@ autocomplete({
       {
         sourceId: 'products',
         getItems() {
-          return getAlgoliaHits<Product>({
+          return getAlgoliaResults<Product>({
             searchClient,
             queries: [
               {

diff --git a/cypress/test-apps/js/categoriesPlugin.tsx b/cypress/test-apps/js/categoriesPlugin.tsx
@@ -1,8 +1,5 @@
 /** @jsx h */
-import {
-  AutocompletePlugin,
-  getAlgoliaFacetHits,
-} from '@algolia/autocomplete-js';
+import { AutocompletePlugin, getAlgoliaFacets } from '@algolia/autocomplete-js';
 import { SearchClient } from 'algoliasearch/lite';
 import { h, Fragment } from 'preact';
 
@@ -24,13 +21,13 @@ export function createCategoriesPlugin({
         {
           sourceId: 'categoriesPlugin',
           getItems() {
-            return getAlgoliaFacetHits({
+            return getAlgoliaFacets({
               searchClient,
               queries: [
                 {
                   indexName: 'instant_search',
+                  facet: 'categories',
                   params: {
-                    facetName: 'categories',
                     facetQuery: query,
                     maxFacetHits: query ? 3 : 10,
                   },

diff --git a/cypress/test-apps/js/package.json b/cypress/test-apps/js/package.json
@@ -16,8 +16,8 @@
     "@algolia/autocomplete-plugin-recent-searches": "1.0.0-alpha.44",
     "@algolia/autocomplete-preset-algolia": "1.0.0-alpha.44",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.44",
-    "@algolia/client-search": "4.8.6",
-    "algoliasearch": "4.8.6",
+    "@algolia/client-search": "4.9.0",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13",
     "search-insights": "1.7.1"
   },

diff --git a/examples/multiple-datasets-with-headers/categoriesPlugin.tsx b/examples/multiple-datasets-with-headers/categoriesPlugin.tsx
@@ -1,8 +1,5 @@
 /** @jsx h */
-import {
-  AutocompletePlugin,
-  getAlgoliaFacetHits,
-} from '@algolia/autocomplete-js';
+import { AutocompletePlugin, getAlgoliaFacets } from '@algolia/autocomplete-js';
 import { SearchClient } from 'algoliasearch/lite';
 import { h, Fragment } from 'preact';
 
@@ -24,7 +21,7 @@ export function createCategoriesPlugin({
         {
           sourceId: 'categoriesPlugin',
           getItems() {
-            return getAlgoliaFacetHits({
+            return getAlgoliaFacets({
               searchClient,
               queries: [
                 {

diff --git a/examples/multiple-datasets-with-headers/package.json b/examples/multiple-datasets-with-headers/package.json
@@ -13,7 +13,7 @@
     "@algolia/autocomplete-plugin-query-suggestions": "1.0.0-alpha.45",
     "@algolia/autocomplete-plugin-recent-searches": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "algoliasearch": "4.8.6",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13"
   },
   "devDependencies": {

diff --git a/examples/playground/app.tsx b/examples/playground/app.tsx
@@ -2,7 +2,7 @@
 import {
   autocomplete,
   AutocompleteComponents,
-  getAlgoliaHits,
+  getAlgoliaResults,
 } from '@algolia/autocomplete-js';
 import {
   AutocompleteInsightsApi,
@@ -18,7 +18,7 @@ import '@algolia/autocomplete-theme-classic';
 
 import { createCategoriesPlugin } from './categoriesPlugin';
 import { shortcutsPlugin } from './shortcutsPlugin';
-import { ProductHit } from './types';
+import { ProductRecord, ProductHit } from './types';
 
 const appId = 'latency';
 const apiKey = '6be0576ff61c053d5f9a3225e2a90f76';
@@ -72,7 +72,7 @@ autocomplete<ProductHit>({
       {
         sourceId: 'products',
         getItems() {
-          return getAlgoliaHits<ProductHit>({
+          return getAlgoliaResults<ProductRecord>({
             searchClient,
             queries: [
               {
@@ -85,16 +85,19 @@ autocomplete<ProductHit>({
                 },
               },
             ],
-          }).then(([hits]) => {
-            return hits.map((hit) => ({
-              ...hit,
-              comments: hit.popularity % 100,
-              sale: hit.free_shipping,
-              // eslint-disable-next-line @typescript-eslint/camelcase
-              sale_price: hit.free_shipping
-                ? (hit.price - hit.price / 10).toFixed(2)
-                : hit.price.toString(),
-            }));
+            transformResponse({ hits }) {
+              const [bestBuyHits] = hits;
+
+              return bestBuyHits.map((hit) => ({
+                ...hit,
+                comments: hit.popularity % 100,
+                sale: hit.free_shipping,
+                // eslint-disable-next-line @typescript-eslint/camelcase
+                sale_price: hit.free_shipping
+                  ? (hit.price - hit.price / 10).toFixed(2)
+                  : hit.price.toString(),
+              }));
+            },
           });
         },
         templates: {

diff --git a/examples/playground/categoriesPlugin.tsx b/examples/playground/categoriesPlugin.tsx
@@ -1,8 +1,5 @@
 /** @jsx h */
-import {
-  AutocompletePlugin,
-  getAlgoliaFacetHits,
-} from '@algolia/autocomplete-js';
+import { AutocompletePlugin, getAlgoliaFacets } from '@algolia/autocomplete-js';
 import { SearchClient } from 'algoliasearch/lite';
 import { h, Fragment } from 'preact';
 
@@ -24,13 +21,13 @@ export function createCategoriesPlugin({
         {
           sourceId: 'categoriesPlugin',
           getItems() {
-            return getAlgoliaFacetHits({
+            return getAlgoliaFacets({
               searchClient,
               queries: [
                 {
                   indexName: 'instant_search',
+                  facet: 'categories',
                   params: {
-                    facetName: 'categories',
                     facetQuery: query,
                     maxFacetHits: query ? 3 : 5,
                   },

diff --git a/examples/playground/package.json b/examples/playground/package.json
@@ -15,8 +15,8 @@
     "@algolia/autocomplete-plugin-recent-searches": "1.0.0-alpha.45",
     "@algolia/autocomplete-preset-algolia": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "@algolia/client-search": "4.8.6",
-    "algoliasearch": "4.8.6",
+    "@algolia/client-search": "4.9.0",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13",
     "search-insights": "1.7.1"
   },

diff --git a/examples/playground/types/ProductHit.ts b/examples/playground/types/ProductHit.ts
@@ -1,6 +1,6 @@
 import { Hit } from '@algolia/client-search';
 
-type ProductRecord = {
+export type ProductRecord = {
   brand: string;
   categories: string[];
   comments: number;

diff --git a/examples/query-suggestions-with-categories/package.json b/examples/query-suggestions-with-categories/package.json
@@ -12,7 +12,7 @@
     "@algolia/autocomplete-js": "1.0.0-alpha.45",
     "@algolia/autocomplete-plugin-query-suggestions": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "algoliasearch": "4.8.6",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13"
   },
   "devDependencies": {

diff --git a/examples/query-suggestions-with-hits/app.tsx b/examples/query-suggestions-with-hits/app.tsx
@@ -2,7 +2,7 @@
 import {
   autocomplete,
   AutocompleteComponents,
-  getAlgoliaHits,
+  getAlgoliaResults,
 } from '@algolia/autocomplete-js';
 import {
   AutocompleteInsightsApi,
@@ -50,7 +50,7 @@ autocomplete<ProductHit>({
       {
         sourceId: 'products',
         getItems() {
-          return getAlgoliaHits<ProductHit>({
+          return getAlgoliaResults<ProductHit>({
             searchClient,
             queries: [
               {

diff --git a/examples/query-suggestions-with-hits/package.json b/examples/query-suggestions-with-hits/package.json
@@ -15,8 +15,8 @@
     "@algolia/autocomplete-plugin-recent-searches": "1.0.0-alpha.45",
     "@algolia/autocomplete-preset-algolia": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "@algolia/client-search": "4.8.6",
-    "algoliasearch": "4.8.6",
+    "@algolia/client-search": "4.9.0",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13",
     "search-insights": "1.7.1"
   },

diff --git a/examples/query-suggestions-with-inline-categories/package.json b/examples/query-suggestions-with-inline-categories/package.json
@@ -12,7 +12,7 @@
     "@algolia/autocomplete-js": "1.0.0-alpha.45",
     "@algolia/autocomplete-plugin-query-suggestions": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "algoliasearch": "4.8.6",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13"
   },
   "devDependencies": {

diff --git a/examples/query-suggestions-with-recent-searches-and-categories/package.json b/examples/query-suggestions-with-recent-searches-and-categories/package.json
@@ -13,8 +13,8 @@
     "@algolia/autocomplete-plugin-query-suggestions": "1.0.0-alpha.45",
     "@algolia/autocomplete-plugin-recent-searches": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "@algolia/client-search": "4.8.6",
-    "algoliasearch": "4.8.6",
+    "@algolia/client-search": "4.9.0",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13"
   },
   "devDependencies": {

diff --git a/examples/query-suggestions-with-recent-searches/package.json b/examples/query-suggestions-with-recent-searches/package.json
@@ -13,7 +13,7 @@
     "@algolia/autocomplete-plugin-query-suggestions": "1.0.0-alpha.45",
     "@algolia/autocomplete-plugin-recent-searches": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "algoliasearch": "4.8.6",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13"
   },
   "devDependencies": {

diff --git a/examples/query-suggestions/package.json b/examples/query-suggestions/package.json
@@ -12,7 +12,7 @@
     "@algolia/autocomplete-js": "1.0.0-alpha.45",
     "@algolia/autocomplete-plugin-query-suggestions": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "algoliasearch": "4.8.6",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13"
   },
   "devDependencies": {

diff --git a/examples/react-renderer/package.json b/examples/react-renderer/package.json
@@ -7,8 +7,8 @@
     "@algolia/autocomplete-core": "1.0.0-alpha.45",
     "@algolia/autocomplete-preset-algolia": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "@algolia/client-search": "4.8.4",
-    "algoliasearch": "4.8.4",
+    "@algolia/client-search": "4.9.0",
+    "algoliasearch": "4.9.0",
     "react": "17.0.1",
     "react-dom": "17.0.1",
     "react-scripts": "4.0.1"

diff --git a/examples/react-renderer/src/Autocomplete.tsx b/examples/react-renderer/src/Autocomplete.tsx
@@ -3,7 +3,7 @@ import {
   AutocompleteState,
   createAutocomplete,
 } from '@algolia/autocomplete-core';
-import { getAlgoliaHits } from '@algolia/autocomplete-preset-algolia';
+import { getAlgoliaResults } from '@algolia/autocomplete-preset-algolia';
 import { Hit } from '@algolia/client-search';
 import algoliasearch from 'algoliasearch/lite';
 import React from 'react';
@@ -54,7 +54,7 @@ export function Autocomplete(
             {
               sourceId: 'products',
               getItems({ query }) {
-                return getAlgoliaHits({
+                return getAlgoliaResults({
                   searchClient,
                   queries: [
                     {

diff --git a/examples/recently-viewed-items/app.tsx b/examples/recently-viewed-items/app.tsx
@@ -2,7 +2,7 @@
 import {
   autocomplete,
   AutocompleteComponents,
-  getAlgoliaHits,
+  getAlgoliaResults,
 } from '@algolia/autocomplete-js';
 import algoliasearch from 'algoliasearch';
 import { h, Fragment } from 'preact';
@@ -35,7 +35,7 @@ autocomplete<ProductHit>({
       {
         sourceId: 'products',
         getItems() {
-          return getAlgoliaHits<ProductHit>({
+          return getAlgoliaResults<ProductHit>({
             searchClient,
             queries: [
               {

diff --git a/examples/recently-viewed-items/package.json b/examples/recently-viewed-items/package.json
@@ -12,8 +12,8 @@
     "@algolia/autocomplete-js": "1.0.0-alpha.45",
     "@algolia/autocomplete-plugin-recent-searches": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "@algolia/client-search": "4.8.6",
-    "algoliasearch": "4.8.6",
+    "@algolia/client-search": "4.9.0",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13"
   },
   "devDependencies": {

diff --git a/examples/starter-algolia/app.tsx b/examples/starter-algolia/app.tsx
@@ -1,5 +1,5 @@
 /** @jsx h */
-import { autocomplete, getAlgoliaHits } from '@algolia/autocomplete-js';
+import { autocomplete, getAlgoliaResults } from '@algolia/autocomplete-js';
 import { Hit } from '@algolia/client-search';
 import algoliasearch from 'algoliasearch';
 import { h } from 'preact';
@@ -30,7 +30,7 @@ autocomplete<AutocompleteItem>({
       {
         sourceId: 'products',
         getItems() {
-          return getAlgoliaHits<AutocompleteItem>({
+          return getAlgoliaResults<AutocompleteItem>({
             searchClient,
             queries: [
               {

diff --git a/examples/starter-algolia/package.json b/examples/starter-algolia/package.json
@@ -11,11 +11,11 @@
   "dependencies": {
     "@algolia/autocomplete-js": "1.0.0-alpha.45",
     "@algolia/autocomplete-theme-classic": "1.0.0-alpha.45",
-    "algoliasearch": "4.8.6",
+    "algoliasearch": "4.9.0",
     "preact": "10.5.13"
   },
   "devDependencies": {
-    "@algolia/client-search": "4.8.6",
+    "@algolia/client-search": "4.9.0",
     "parcel": "2.0.0-beta.2"
   },
   "keywords": [

diff --git a/examples/voice-search/app.tsx b/examples/voice-search/app.tsx
@@ -1,5 +1,5 @@
 /** @jsx h */
-import { autocomplete, getAlgoliaHits } from '@algolia/autocomplete-js';
+import { autocomplete, getAlgoliaResults } from '@algolia/autocomplete-js';
 import { Hit } from '@algolia/client-search';
 import algoliasearch from 'algoliasearch';
 import { h } from 'preact';
@@ -35,7 +35,7 @@ autocomplete<AutocompleteItem>({
       {
         sourceId: 'products',
         getItems() {
-          return getAlgoliaHits<AutocompleteItem>({
+          return getAlgoliaResults<AutocompleteItem>({
             searchClient,
             queries: [
               {