algoliasearch-helper 3.8.1 → 3.9.0

package/CHANGELOG

@@ -1,3 +1,15 @@
+3.9.0 - 2022-06-20
+ * feat(searchForFacetValues): fall back to client.search if it's present (#906) https://github.com/algolia/algoliasearch-helper-js/commit/d9ebb01382ec83e0c579c393c3e9df83a9261699
+ * fix(requests): send a sorted object of parameters (#911) https://github.com/algolia/algoliasearch-helper-js/commit/832507fae48c54ab41d3241254753100bb86910b
+
+3.8.3 - 2022-06-15
+ * chore: update yarn lockfile (#909) https://github.com/algolia/algoliasearch-helper-js/commit/e561c35ce30dc36c162886b828835bf18887dab1
+ * doc(readme): fix api parameter links (#904) https://github.com/algolia/algoliasearch-helper-js/commit/64356a40bd88972bcd256acb5c6f483982d4557d, closes https://github.com/algolia/algoliasearch-helper-js/issues/904
+ * fix(facetValues): retrieve all hierarchical facet parent values (#908) https://github.com/algolia/algoliasearch-helper-js/commit/420111b29f82fe3af8e5861a977f024a61f4025f
+
+3.8.2 - 2022-04-08
+ * fix(types): correct type for addTag (#903) https://github.com/algolia/algoliasearch-helper-js/commit/ca82ef302ceff8e0e31767c90e2f272914c703af
+
 3.8.1 - 2022-04-05
  * fix(disjunctiveFacets): avoid escaping non-string values (#902) https://github.com/algolia/algoliasearch-helper-js/commit/4ac67bda2a8e5a2b8c53c960637b72a77951af76
 

package/README.md

@@ -801,7 +801,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Enable the advanced syntax.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-advancedSyntax">advancedSyntax on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/advancedSyntax/">advancedSyntax on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -813,7 +813,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Should the engine allow typos on numerics.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-allowTyposOnNumericTokens">allowTyposOnNumericTokens on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/allowTyposOnNumericTokens/">allowTyposOnNumericTokens on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -825,7 +825,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Enable the analytics</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-analytics">analytics on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/analytics/">analytics on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -837,7 +837,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Tag of the query in the analytics.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-analyticsTags">analyticsTags on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/">analyticsTags on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -849,7 +849,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Center of the geo search.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-aroundLatLng">aroundLatLng on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/aroundLatLng/">aroundLatLng on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -861,7 +861,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Center of the search, retrieve from the user IP.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-aroundLatLngViaIP">aroundLatLngViaIP on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/aroundLatLngViaIP/">aroundLatLngViaIP on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -873,7 +873,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Precision of the geo search.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-aroundPrecision">aroundPrecision on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/aroundPrecision/">aroundPrecision on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -885,7 +885,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Radius of the geo search.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-aroundRadius">aroundRadius on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/aroundRadius/">aroundRadius on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -897,7 +897,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Minimum radius of the geo search.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-minimumAroundRadius">minimumAroundRadius on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/minimumAroundRadius/">minimumAroundRadius on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -909,7 +909,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">List of attributes to highlight</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-attributesToHighlight">attributesToHighlight on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/attributesToHighlight/">attributesToHighlight on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -921,7 +921,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">List of attributes to retrieve</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-attributesToRetrieve">attributesToRetrieve on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/attributesToRetrieve/">attributesToRetrieve on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -933,7 +933,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">List of attributes to snippet</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-attributesToSnippet">attributesToSnippet on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/attributesToSnippet/">attributesToSnippet on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -956,7 +956,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Remove duplicates based on the index setting attributeForDistinct</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-distinct">distinct on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/distinct/">distinct on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -991,7 +991,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Enable the ranking informations in the response</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-getRankingInfo">getRankingInfo on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/getRankingInfo/">getRankingInfo on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1003,7 +1003,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Number of hits to be returned by the search API</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-hitsPerPage">hitsPerPage on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/hitsPerPage/">hitsPerPage on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1015,7 +1015,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Should the plurals be ignored</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-ignorePlurals">ignorePlurals on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/ignorePlurals/">ignorePlurals on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1027,7 +1027,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Geo search inside a box.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-insideBoundingBox">insideBoundingBox on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/insideBoundingBox/">insideBoundingBox on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1039,7 +1039,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Geo search inside a polygon.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-insidePolygon">insidePolygon on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/insidePolygon/">insidePolygon on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1051,7 +1051,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Number of values for each facetted attribute</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-maxValuesPerFacet">maxValuesPerFacet on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/maxValuesPerFacet/">maxValuesPerFacet on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1063,7 +1063,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Number of characters to wait before doing one character replacement.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-minWordSizefor1Typo">minWordSizefor1Typo on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/minWordSizefor1Typo/">minWordSizefor1Typo on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1075,7 +1075,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Number of characters to wait before doing a second character replacement.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-minWordSizefor2Typos">minWordSizefor2Typos on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/minWordSizefor2Typos/">minWordSizefor2Typos on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1087,7 +1087,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Add some optional words to those defined in the dashboard</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-optionalWords">optionalWords on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/optionalWords/">optionalWords on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1099,7 +1099,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">The current page number</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-page">page on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="algolia.com/doc/api-reference/api-parameters/page/">page on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1111,7 +1111,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Query string of the instant search. The empty string is a valid query.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-query">query on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/query/">query on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1123,7 +1123,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">How the query should be treated by the search engine. Possible values: prefixAll, prefixLast, prefixNone</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-queryType">queryType on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/queryType/">queryType on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1135,7 +1135,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Possible values are "lastWords" "firstWords" "allOptional" "none" (default)</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-removeWordsIfNoResults">removeWordsIfNoResults on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/removeWordsIfNoResults/">removeWordsIfNoResults on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1147,7 +1147,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Should the engine replace the synonyms in the highlighted results.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-replaceSynonymsInHighlight">replaceSynonymsInHighlight on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/replaceSynonymsInHighlight/">replaceSynonymsInHighlight on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1159,7 +1159,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Restrict which attribute is searched.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-restrictSearchableAttributes">restrictSearchableAttributes on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/restrictSearchableAttributes/">restrictSearchableAttributes on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1171,7 +1171,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Enable the synonyms</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-synonyms">synonyms on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/synonyms/">synonyms on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1183,7 +1183,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">Contains the tag filters in the raw format of the Algolia API. Setting this parameter is not compatible with the of the add/remove/toggle methods of the tag api.</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-tagFilters">tagFilters on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/tagFilters/">tagFilters on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
     <tr>
@@ -1195,7 +1195,7 @@ helper.setQueryParameter('hitsPerPage', 20).search();
       </td>
       <td valign="top" class="td6">
         <p class="p4"><span class="s1">How the typo tolerance behave in the search engine. Possible values: true, false, min, strict</span></p>
-        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/ruby#param-typoTolerance">typoTolerance on Algolia.com<span class="s3"></span></a></span></p>
+        <p class="p5"><span class="s1"><a href="https://www.algolia.com/doc/api-reference/api-parameters/typoTolerance/">typoTolerance on Algolia.com<span class="s3"></span></a></span></p>
       </td>
     </tr>
   </tbody>

package/dist/algoliasearch.helper.js

@@ -2806,7 +2806,7 @@ function SearchResults(state, results, options) {
     nextDisjunctiveResult++;
   });
 
-  // if we have some root level values for hierarchical facets, merge them
+  // if we have some parent level values for hierarchical facets, merge them
   state.getRefinedHierarchicalFacets().forEach(function(refinedFacet) {
     var hierarchicalFacet = state.getHierarchicalFacetByName(refinedFacet);
     var separator = state._getHierarchicalFacetSeparator(hierarchicalFacet);
@@ -2818,47 +2818,49 @@ function SearchResults(state, results, options) {
       return;
     }
 
-    var result = results[nextDisjunctiveResult];
-    var facets = result && result.facets
-      ? result.facets
-      : {};
-    Object.keys(facets).forEach(function(dfacet) {
-      var facetResults = facets[dfacet];
-      var position = findIndex(state.hierarchicalFacets, function(f) {
-        return f.name === hierarchicalFacet.name;
-      });
-      var attributeIndex = findIndex(self.hierarchicalFacets[position], function(f) {
-        return f.attribute === dfacet;
-      });
+    results.slice(nextDisjunctiveResult).forEach(function(result) {
+      var facets = result && result.facets
+        ? result.facets
+        : {};
 
-      // previous refinements and no results so not able to find it
-      if (attributeIndex === -1) {
-        return;
-      }
+      Object.keys(facets).forEach(function(dfacet) {
+        var facetResults = facets[dfacet];
+        var position = findIndex(state.hierarchicalFacets, function(f) {
+          return f.name === hierarchicalFacet.name;
+        });
+        var attributeIndex = findIndex(self.hierarchicalFacets[position], function(f) {
+          return f.attribute === dfacet;
+        });
 
-      // when we always get root levels, if the hits refinement is `beers > IPA` (count: 5),
-      // then the disjunctive values will be `beers` (count: 100),
-      // but we do not want to display
-      //   | beers (100)
-      //     > IPA (5)
-      // We want
-      //   | beers (5)
-      //     > IPA (5)
-      var defaultData = {};
-
-      if (currentRefinement.length > 0) {
-        var root = currentRefinement[0].split(separator)[0];
-        defaultData[root] = self.hierarchicalFacets[position][attributeIndex].data[root];
-      }
+        // previous refinements and no results so not able to find it
+        if (attributeIndex === -1) {
+          return;
+        }
 
-      self.hierarchicalFacets[position][attributeIndex].data = defaultsPure(
-        defaultData,
-        facetResults,
-        self.hierarchicalFacets[position][attributeIndex].data
-      );
-    });
+        // when we always get root levels, if the hits refinement is `beers > IPA` (count: 5),
+        // then the disjunctive values will be `beers` (count: 100),
+        // but we do not want to display
+        //   | beers (100)
+        //     > IPA (5)
+        // We want
+        //   | beers (5)
+        //     > IPA (5)
+        var defaultData = {};
+
+        if (currentRefinement.length > 0) {
+          var root = currentRefinement[0].split(separator)[0];
+          defaultData[root] = self.hierarchicalFacets[position][attributeIndex].data[root];
+        }
 
-    nextDisjunctiveResult++;
+        self.hierarchicalFacets[position][attributeIndex].data = defaultsPure(
+          defaultData,
+          facetResults,
+          self.hierarchicalFacets[position][attributeIndex].data
+        );
+      });
+
+      nextDisjunctiveResult++;
+    });
   });
 
   // add the excludes
@@ -3645,20 +3647,51 @@ AlgoliaSearchHelper.prototype.findAnswers = function(options) {
  */
 AlgoliaSearchHelper.prototype.searchForFacetValues = function(facet, query, maxFacetHits, userState) {
   var clientHasSFFV = typeof this.client.searchForFacetValues === 'function';
+  var clientHasInitIndex = typeof this.client.initIndex === 'function';
   if (
     !clientHasSFFV &&
-    typeof this.client.initIndex !== 'function'
+    !clientHasInitIndex &&
+    typeof this.client.search !== 'function'
   ) {
     throw new Error(
       'search for facet values (searchable) was called, but this client does not have a function client.searchForFacetValues or client.initIndex(index).searchForFacetValues'
     );
   }
+
   var state = this.state.setQueryParameters(userState || {});
   var isDisjunctive = state.isDisjunctiveFacet(facet);
   var algoliaQuery = requestBuilder.getSearchForFacetQuery(facet, query, maxFacetHits, state);
 
   this._currentNbQueries++;
   var self = this;
+  var searchForFacetValuesPromise;
+  // newer algoliasearch ^3.27.1 - ~4.0.0
+  if (clientHasSFFV) {
+    searchForFacetValuesPromise = this.client.searchForFacetValues([
+      {indexName: state.index, params: algoliaQuery}
+    ]);
+    // algoliasearch < 3.27.1
+  } else if (clientHasInitIndex) {
+    searchForFacetValuesPromise = this.client
+      .initIndex(state.index)
+      .searchForFacetValues(algoliaQuery);
+    // algoliasearch ~5.0.0
+  } else {
+    // @MAJOR only use client.search
+    delete algoliaQuery.facetName;
+    searchForFacetValuesPromise = this.client
+      .search([
+        {
+          type: 'facet',
+          facet: facet,
+          indexName: state.index,
+          params: algoliaQuery
+        }
+      ])
+      .then(function processResponse(response) {
+        return response.results[0];
+      });
+  }
 
   this.emit('searchForFacetValues', {
     state: state,
@@ -3666,10 +3699,6 @@ AlgoliaSearchHelper.prototype.searchForFacetValues = function(facet, query, maxF
     query: query
   });
 
-  var searchForFacetValuesPromise = clientHasSFFV
-    ? this.client.searchForFacetValues([{indexName: state.index, params: algoliaQuery}])
-    : this.client.initIndex(state.index).searchForFacetValues(algoliaQuery);
-
   return searchForFacetValuesPromise.then(function addIsRefined(content) {
     self._currentNbQueries--;
     if (self._currentNbQueries === 0) self.emit('searchQueueEmpty');
@@ -5167,6 +5196,17 @@ module.exports = valToNumber;
 
 var merge = require('./functions/merge');
 
+function sortObject(obj) {
+  return Object.keys(obj)
+    .sort(function(a, b) {
+      return a.localeCompare(b);
+    })
+    .reduce(function(acc, curr) {
+      acc[curr] = obj[curr];
+      return acc;
+    }, {});
+}
+
 var requestBuilder = {
   /**
    * Get all the queries to send to the client, those queries can used directly
@@ -5191,18 +5231,38 @@ var requestBuilder = {
       });
     });
 
-    // maybe more to get the root level of hierarchical facets when activated
+    // More to get the parent levels of the hierarchical facets when refined
     state.getRefinedHierarchicalFacets().forEach(function(refinedFacet) {
       var hierarchicalFacet = state.getHierarchicalFacetByName(refinedFacet);
-
       var currentRefinement = state.getHierarchicalRefinement(refinedFacet);
-      // if we are deeper than level 0 (starting from `beer > IPA`)
-      // we want to get the root values
       var separator = state._getHierarchicalFacetSeparator(hierarchicalFacet);
+
+      // If we are deeper than level 0 (starting from `beer > IPA`)
+      // we want to get all parent values
       if (currentRefinement.length > 0 && currentRefinement[0].split(separator).length > 1) {
-        queries.push({
-          indexName: index,
-          params: requestBuilder._getDisjunctiveFacetSearchParams(state, refinedFacet, true)
+        // We generate a map of the filters we will use for our facet values queries
+        var filtersMap = currentRefinement[0].split(separator).slice(0, -1).reduce(
+          function createFiltersMap(map, segment, level) {
+            return map.concat({
+              attribute: hierarchicalFacet.attributes[level],
+              value: level === 0
+                ? segment
+                : [map[map.length - 1].value, segment].join(separator)
+            });
+          }
+        , []);
+
+        filtersMap.forEach(function(filter, level) {
+          var params = requestBuilder._getDisjunctiveFacetSearchParams(
+            state,
+            filter.attribute,
+            level === 0
+          );
+
+          var parent = filtersMap[level - 1];
+          params.facetFilters = level > 0 ? [parent.attribute + ':' + parent.value] : undefined;
+
+          queries.push({indexName: index, params: params});
         });
       }
     });
@@ -5237,7 +5297,7 @@ var requestBuilder = {
       additionalParams.numericFilters = numericFilters;
     }
 
-    return merge({}, state.getQueryParams(), additionalParams);
+    return sortObject(merge({}, state.getQueryParams(), additionalParams));
   },
 
   /**
@@ -5282,7 +5342,7 @@ var requestBuilder = {
       additionalParams.facetFilters = facetFilters;
     }
 
-    return merge({}, state.getQueryParams(), additionalParams);
+    return sortObject(merge({}, state.getQueryParams(), additionalParams));
   },
 
   /**
@@ -5475,11 +5535,11 @@ var requestBuilder = {
     if (typeof maxFacetHits === 'number') {
       searchForFacetSearchParameters.maxFacetHits = maxFacetHits;
     }
-    return merge(
+    return sortObject(merge(
       {},
       requestBuilder._getHitsSearchParams(stateForSearchForFacetValues),
       searchForFacetSearchParameters
-    );
+    ));
   }
 };
 
@@ -5498,7 +5558,7 @@ module.exports = function isValidUserToken(userToken) {
 },{}],24:[function(require,module,exports){
 'use strict';
 
-module.exports = '3.8.1';
+module.exports = '3.9.0';
 
 },{}]},{},[1])(1)
 });