Add hybrid parameter

Author: Strift

src/main/java/com/meilisearch/sdk/SearchRequest.java

@@ -1,5 +1,6 @@
 package com.meilisearch.sdk;
 
+import com.meilisearch.sdk.model.Hybrid;
 import com.meilisearch.sdk.model.MatchingStrategy;
 import lombok.AccessLevel;
 import lombok.AllArgsConstructor;
@@ -42,6 +43,7 @@ public class SearchRequest {
     protected Double rankingScoreThreshold;
     protected String[] locales;
     protected String distinct;
+    protected Hybrid hybrid;
 
     /**
      * Constructor for SearchRequest for building search queries with the default values: offset: 0,
@@ -106,6 +108,11 @@ public String toString() {
                         .putOpt("locales", this.locales)
                         .putOpt("distinct", this.distinct);
 
+        // Add hybrid parameter if it exists
+        if (this.hybrid != null) {
+            jsonObject.put("hybrid", this.hybrid.toJSONObject());
+        }
+
         return jsonObject.toString();
     }
 }

src/main/java/com/meilisearch/sdk/model/Hybrid.java

@@ -0,0 +1,48 @@
+package com.meilisearch.sdk.model;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import lombok.experimental.Accessors;
+import org.json.JSONObject;
+
+/** Hybrid search configuration */
+@Builder
+@AllArgsConstructor(access = AccessLevel.PACKAGE)
+@NoArgsConstructor(access = AccessLevel.PACKAGE)
+@Getter
+@Setter
+@Accessors(chain = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class Hybrid {
+    /** Semantic ratio for hybrid search (between 0 and 1) */
+    private Double semanticRatio;
+
+    /** Embedder to use for hybrid search (mandatory if hybrid is set) */
+    private String embedder;
+
+    /**
+     * Method that returns the JSON representation of the Hybrid object
+     *
+     * @return JSONObject representation of the Hybrid object
+     */
+    public JSONObject toJSONObject() {
+        return new JSONObject()
+                .putOpt("semanticRatio", this.semanticRatio)
+                .putOpt("embedder", this.embedder);
+    }
+
+    /**
+     * Method that returns the JSON String of the Hybrid object
+     *
+     * @return JSON String of the Hybrid object
+     */
+    @Override
+    public String toString() {
+        return toJSONObject().toString();
+    }
+}

src/test/java/com/meilisearch/sdk/SearchRequestTest.java

@@ -5,6 +5,7 @@
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.nullValue;
 
+import com.meilisearch.sdk.model.Hybrid;
 import com.meilisearch.sdk.model.MatchingStrategy;
 import org.junit.jupiter.api.Test;
 
@@ -363,4 +364,65 @@ void toStringEveryParametersWithArrayMatchingStrategyNull() {
         assertThat(classToTest.getDistinct(), is(equalTo("distinct")));
         assertThat(classToTest.toString(), is(equalTo(expectedToString)));
     }
+
+    @Test
+    void toStringWithHybrid() {
+        Hybrid hybrid = Hybrid.builder().semanticRatio(0.5).embedder("default").build();
+
+        SearchRequest classToTest = new SearchRequest("This is a Test").setHybrid(hybrid);
+
+        String expected =
+                "{\"q\":\"This is a Test\",\"hybrid\":{\"semanticRatio\":0.5,\"embedder\":\"default\"}}";
+        assertThat(classToTest.toString(), is(equalTo(expected)));
+
+        // Verify getters
+        assertThat(classToTest.getHybrid().getSemanticRatio(), is(equalTo(0.5)));
+        assertThat(classToTest.getHybrid().getEmbedder(), is(equalTo("default")));
+    }
+
+    @Test
+    void toStringWithHybridUsingBuilder() {
+        SearchRequest classToTest =
+                SearchRequest.builder()
+                        .q("This is a Test")
+                        .hybrid(Hybrid.builder().semanticRatio(0.5).embedder("default").build())
+                        .build();
+
+        String expected =
+                "{\"q\":\"This is a Test\",\"hybrid\":{\"semanticRatio\":0.5,\"embedder\":\"default\"}}";
+        assertThat(classToTest.toString(), is(equalTo(expected)));
+
+        // Verify getters
+        assertThat(classToTest.getHybrid().getSemanticRatio(), is(equalTo(0.5)));
+        assertThat(classToTest.getHybrid().getEmbedder(), is(equalTo("default")));
+    }
+
+    @Test
+    void toStringWithHybridAndOtherParameters() {
+        SearchRequest classToTest =
+                SearchRequest.builder()
+                        .q("This is a Test")
+                        .offset(200)
+                        .limit(900)
+                        .hybrid(
+                                Hybrid.builder()
+                                        .semanticRatio(0.7)
+                                        .embedder("custom-embedder")
+                                        .build())
+                        .build();
+
+        String expected =
+                "{\"q\":\"This is a Test\",\"hybrid\":{\"semanticRatio\":0.7,\"embedder\":\"custom-embedder\"},\"offset\":200,\"limit\":900}";
+        assertThat(classToTest.toString(), is(equalTo(expected)));
+    }
+
+    @Test
+    void toStringWithHybridOnlyEmbedder() {
+        SearchRequest classToTest =
+                new SearchRequest("This is a Test")
+                        .setHybrid(Hybrid.builder().embedder("default").build());
+
+        String expected = "{\"q\":\"This is a Test\",\"hybrid\":{\"embedder\":\"default\"}}";
+        assertThat(classToTest.toString(), is(equalTo(expected)));
+    }
 }