SortFacetValuesBy support

Author: danFbach

.code-samples.meilisearch.yaml

@@ -4,8 +4,13 @@
 # You can read more on https://github.com/meilisearch/documentation/tree/master/.vuepress/code-samples
 ---
 getting_started_faceting: |-
-  var faceting = new Faceting {
-    MaxValuesPerFacet = 2
+  var faceting = new Faceting
+  {
+      MaxValuesPerFacet = 2,
+      SortFacetValuesBy = new Dictionary<string, SortFacetValuesByType>
+      {
+          ["*"] = SortFacetValuesByType.Count
+      }
   };
   await client.Index("movies").UpdateFacetingAsync(faceting);
 getting_started_pagination: |-
@@ -716,10 +721,16 @@ reset_pagination_settings_1: |-
 get_faceting_settings_1: |-
   await client.Index("movies").GetFacetingAsync();
 update_faceting_settings_1: |-
-  var faceting = new Faceting {
-    MaxValuesPerFacet = 2
+  var faceting = new Faceting
+  {
+      MaxValuesPerFacet = 2,
+      SortFacetValuesBy = new Dictionary<string, SortFacetValuesByType>
+      {
+          ["*"] = SortFacetValuesByType.Alpha,
+          ["genres"] = SortFacetValuesByType.Count
+      }
   };
-  await client.Index("movies").UpdateFacetingAsync(faceting);
+  await client.Index("books").UpdateFacetingAsync(faceting);
 reset_faceting_settings_1: |-
   await client.Index("movies").ResetFacetingAsync();
 multi_search_1: |-
@@ -782,3 +793,12 @@ distinct_attribute_guide_distinct_parameter_1: |-
     Distinct = "sku"
   };
   await client.Index("products").SearchAsync<Product>("white shirt", params);
+facet_search_2: |-
+  var newFaceting = new Faceting
+  {
+      SortFacetValuesBy = new Dictionary<string, SortFacetValuesByType>
+      {
+          ["genres"] = SortFacetValuesByType.Count
+      }
+  };
+  await client.Index("books").UpdateFacetingAsync(newFaceting);

src/Meilisearch/Converters/SortFacetValuesConverter.cs

@@ -0,0 +1,29 @@
+using System;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Meilisearch.Converters
+{
+    public class SortFacetValuesConverter : JsonConverter<SortFacetValuesByType>
+    {
+        public override SortFacetValuesByType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+        {
+            if (reader.TokenType == JsonTokenType.String)
+            {
+                var enumValue = reader.GetString();
+                if (Enum.TryParse<SortFacetValuesByType>(enumValue, true, out var sortFacetValues))
+                {
+                    return sortFacetValues;
+                }
+            }
+
+            // If we reach here, it means we encountered an unknown value, so we'll use meilisearch default of Alpha
+            return SortFacetValuesByType.Alpha;
+        }
+
+        public override void Write(Utf8JsonWriter writer, SortFacetValuesByType value, JsonSerializerOptions options)
+        {
+            writer.WriteStringValue(value.ToString().ToLower());
+        }
+    }
+}

src/Meilisearch/Faceting.cs

@@ -1,13 +1,39 @@
+using System.Collections.Generic;
 using System.Text.Json.Serialization;
 
+using Meilisearch.Converters;
+
 namespace Meilisearch
 {
     /// <summary>
     /// Faceting configuration.
     /// </summary>
     public class Faceting
     {
+        /// <summary>
+        /// Gets or sets maxValuesPerFacet.
+        /// </summary>
         [JsonPropertyName("maxValuesPerFacet")]
         public int MaxValuesPerFacet { get; set; }
+
+        /// <summary>
+        /// Gets or sets sortFacetValuesBy.
+        /// </summary>
+        [JsonPropertyName("sortFacetValuesBy")]
+        public Dictionary<string, SortFacetValuesByType> SortFacetValuesBy { get; set; }
+    }
+
+    [JsonConverter(typeof(SortFacetValuesConverter))]
+    public enum SortFacetValuesByType
+    {
+        /// <summary>
+        /// Sort by alphanumerical value.
+        /// </summary>
+        Alpha,
+
+        /// <summary>
+        /// Sort by count value.
+        /// </summary>
+        Count
     }
 }

tests/Meilisearch.Tests/SettingsTests.cs

@@ -54,7 +54,11 @@ public SettingsTests(TFixture fixture)
                 },
                 Faceting = new Faceting
                 {
-                    MaxValuesPerFacet = 100
+                    MaxValuesPerFacet = 100,
+                    SortFacetValuesBy = new Dictionary<string, SortFacetValuesByType>()
+                    {
+                        ["*"] = SortFacetValuesByType.Alpha
+                    }
                 },
                 Pagination = new Pagination
                 {
@@ -513,7 +517,11 @@ public async Task UpdateFaceting()
         {
             var newFaceting = new Faceting
             {
-                MaxValuesPerFacet = 20
+                MaxValuesPerFacet = 20,
+                SortFacetValuesBy = new Dictionary<string, SortFacetValuesByType>
+                {
+                    ["*"] = SortFacetValuesByType.Count
+                }
             };
 
             await AssertUpdateSuccess(_index.UpdateFacetingAsync, newFaceting);
@@ -525,7 +533,11 @@ public async Task ResetFaceting()
         {
             var newFaceting = new Faceting
             {
-                MaxValuesPerFacet = 30
+                MaxValuesPerFacet = 30,
+                SortFacetValuesBy = new Dictionary<string, SortFacetValuesByType>
+                {
+                    ["*"] = SortFacetValuesByType.Count
+                }
             };
 
             await AssertUpdateSuccess(_index.UpdateFacetingAsync, newFaceting);