Add federated multisearch to MeilisearchClient

.env

@@ -1,3 +1,3 @@
-MEILISEARCH_VERSION=v1.9.0
+MEILISEARCH_VERSION=v1.10.0
 PROXIED_MEILISEARCH=http://nginx/api/
 MEILISEARCH_URL=http://meilisearch:7700

src/Meilisearch/Constants.cs

@@ -1,13 +1,26 @@
 using System.Text.Json;
 using System.Text.Json.Serialization;
 
+using Meilisearch.Converters;
+
 namespace Meilisearch
 {
     /// <summary>
     /// This class adds some defaults to work with Meilisearch client.
     /// </summary>
     internal static class Constants
     {
+        /// <summary>
+        /// JsonSerializer options used when serializing objects that needs to remove null values.
+        /// </summary>
+        internal static readonly JsonSerializerOptions FederatedSearchJsonSerializerOptionsRemoveNulls =
+            new JsonSerializerOptions
+            {
+                DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
+                PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
+                Converters = { new MultiSearchFederationOptionsConverter() }
+            };
+
         /// <summary>
         /// JsonSerializer options used when serializing objects that needs to remove null values.
         /// </summary>

src/Meilisearch/Converters/AlwaysIncludeEmptyObjectConverter.cs

@@ -0,0 +1,73 @@
+using System;
+using System.Linq;
+using System.Reflection;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Meilisearch.Converters
+{
+    /// <summary>
+    /// Always include property in json. MultiSearchFederationOptions will be serialized as "{}"
+    ///
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    public class MultiSearchFederationOptionsConverter : JsonConverter<MultiSearchFederationOptions>
+    {
+        public override MultiSearchFederationOptions Read(ref Utf8JsonReader reader, Type typeToConvert,
+            JsonSerializerOptions options)
+        {
+            return JsonSerializer.Deserialize<MultiSearchFederationOptions>(ref reader, options);
+        }
+
+        public override void Write(Utf8JsonWriter writer, MultiSearchFederationOptions value,
+            JsonSerializerOptions options)
+        {
+            if (value == null || !HasAnyValueSet(value))
+            {
+                WriteEmptyObject(writer);
+            }
+            else
+            {
+                var sanitizedOptions =
+                    RemoveSelfFromSerializerOptions(options); //Prevents getting stuck in a loop during serialization
+                JsonSerializer.Serialize(writer, value, sanitizedOptions);
+            }
+        }
+
+        private static JsonSerializerOptions RemoveSelfFromSerializerOptions(JsonSerializerOptions options)
+        {
+            var sanitizedOptions = new JsonSerializerOptions(options);
+            sanitizedOptions.Converters.Remove(sanitizedOptions.Converters.First(c =>
+                c.GetType() == typeof(MultiSearchFederationOptionsConverter)));
+            return sanitizedOptions;
+        }
+
+        private static void WriteEmptyObject(Utf8JsonWriter writer)
+        {
+            writer.WriteStartObject();
+            writer.WriteEndObject();
+        }
+
+        private bool HasAnyValueSet(MultiSearchFederationOptions value)
+        {
+            foreach (var property in
+                     value.GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance))
+            {
+                var propertyValue = property.GetValue(value);
+                var defaultValue = GetDefaultValue(property.PropertyType);
+
+                if (!Equals(propertyValue, defaultValue))
+                {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
+        private object GetDefaultValue(Type type)
+        {
+            return type.IsValueType ? Activator.CreateInstance(type) : null;
+        }
+    }
+}

src/Meilisearch/FederatedMultiSearchQuery.cs

@@ -0,0 +1,35 @@
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+using Meilisearch.Converters;
+
+namespace Meilisearch
+{
+    /// <summary>
+    ///  Search query used in federated multi-index search
+    /// </summary>
+    public class FederatedMultiSearchQuery
+    {
+        /// <summary>
+        /// Default constructor that ensures FederationOptions are always set
+        /// </summary>
+        public FederatedMultiSearchQuery()
+        {
+            FederationOptions = new MultiSearchFederationOptions();
+        }
+
+        /// <summary>
+        /// The queries
+        /// </summary>
+        [JsonPropertyName("queries")]
+        public List<FederatedSearchQuery> Queries { get; set; }
+
+        /// <summary>
+        /// The federated search query options
+        /// </summary>
+        [JsonInclude]
+        [JsonPropertyName("federation")]
+        [JsonConverter(typeof(MultiSearchFederationOptionsConverter))]
+        public MultiSearchFederationOptions FederationOptions { get; set; }
+    }
+}

src/Meilisearch/FederatedSearchQuery.cs

@@ -0,0 +1,16 @@
+using System.Text.Json.Serialization;
+
+namespace Meilisearch
+{
+    /// <summary>
+    /// Search query for federated multi-index search
+    /// </summary>
+    public class FederatedSearchQuery : SearchQueryBase
+    {
+        /// <summary>
+        /// Federated search options
+        /// </summary>
+        [JsonPropertyName("federationOptions")]
+        public MultiSearchFederationOptions FederationOptions { get; set; }
+    }
+}

src/Meilisearch/Meilisearch.csproj

@@ -13,7 +13,6 @@
         <PackageIcon>logo.png</PackageIcon>
         <PackageReadmeFile>README.md</PackageReadmeFile>
         <PackageLicenseExpression>MIT</PackageLicenseExpression>
-
         <GenerateDocumentationFile>True</GenerateDocumentationFile>
         <!-- Warnings for missing XML documentation are only visible during dev time -->
         <!-- You may want to remove the NoWarn node in case documentation will be mandatory in the future -->