[CDX-172] Add preFilterExpression to AutocompleteRequest (#160)

* feat: add preFilterExpression support to autocomplete requests

* Lint

* Update constructorio-client/src/test/java/io/constructor/client/ConstructorIOAutocompleteTest.java

---------

Co-authored-by: Islam Moustafa <58053149+mocca102@users.noreply.github.com>

Author: esezen

constructorio-client/src/main/java/io/constructor/client/AutocompleteRequest.java

@@ -14,6 +14,7 @@ public class AutocompleteRequest {
     private Map<String, List<String>> filters;
     private VariationsMap variationsMap;
     private Map<String, Map<String, List<String>>> filtersPerSection;
+    private String preFilterExpression;
 
     /**
      * Creates an autocomplete request
@@ -31,6 +32,7 @@ public AutocompleteRequest(String query) throws IllegalArgumentException {
         this.filters = new HashMap<String, List<String>>();
         this.filtersPerSection = new HashMap<String, Map<String, List<String>>>();
         this.variationsMap = null;
+        this.preFilterExpression = null;
     }
 
     /**
@@ -116,4 +118,20 @@ public void setVariationsMap(VariationsMap variationsMap) {
     public VariationsMap getVariationsMap() {
         return variationsMap;
     }
+
+    /**
+     * @param preFilterExpression the faceting expression to scope autocomplete results
+     *     (JSON-encoded query string). Please refer to
+     *     https://docs.constructor.com/reference/shared-filter-expressions
+     */
+    public void setPreFilterExpression(String preFilterExpression) {
+        this.preFilterExpression = preFilterExpression;
+    }
+
+    /**
+     * @return the prefilter expression
+     */
+    public String getPreFilterExpression() {
+        return preFilterExpression;
+    }
 }

constructorio-client/src/main/java/io/constructor/client/ConstructorIO.java

@@ -905,6 +905,14 @@ public String autocompleteAsJSON(AutocompleteRequest req, UserInfo userInfo)
                                 .build();
             }
 
+            if (req.getPreFilterExpression() != null) {
+                url =
+                        url.newBuilder()
+                                .addQueryParameter(
+                                        "pre_filter_expression", req.getPreFilterExpression())
+                                .build();
+            }
+
             Request request = this.makeUserRequestBuilder(userInfo).url(url).get().build();
 
             Response response = clientWithRetry.newCall(request).execute();
@@ -2725,7 +2733,6 @@ protected Request createQuizRequest(QuizRequestBase req, String type, UserInfo u
 
             List<String> paths = Arrays.asList("v1", "quizzes", req.getQuizId(), type);
             HttpUrl url = this.makeUrl(paths);
-
             if (req.getSection() != null) {
                 url = url.newBuilder().addQueryParameter("section", req.getSection()).build();
             }

constructorio-client/src/test/java/io/constructor/client/ConstructorIOAutocompleteTest.java

@@ -289,4 +289,23 @@ public void AutocompleteShouldReturnAResultProvidedVariationsMapAsObject() throw
                 variationsMap.getGroupBy().get(0).field,
                 variationsMapFromResponse.getGroupBy().get(0).field);
     }
+
+    @Test
+    public void AutocompleteShouldReturnAResultWithPreFilterExpression() throws Exception {
+        ConstructorIO constructor = new ConstructorIO("", apiKey, true, null);
+        UserInfo userInfo = new UserInfo(3, "c62a-2a09-faie");
+        AutocompleteRequest request = new AutocompleteRequest("jacket");
+        String preFilterExpression =
+                "{\"or\":[{\"and\":[{\"name\":\"group_id\",\"value\":\"electronics-group-id\"},{\"name\":\"Price\",\"range\":[\"-inf\",200.0]}]},{\"and\":[{\"name\":\"Type\",\"value\":\"Laptop\"},{\"not\":{\"name\":\"Price\",\"range\":[800.0,\"inf\"]}}]}]}";
+        request.setPreFilterExpression(preFilterExpression);
+
+        AutocompleteResponse response = constructor.autocomplete(request, userInfo);
+        String preFilterExpressionFromRequestJsonString =
+                new Gson().toJson(response.getRequest().get("pre_filter_expression"));
+
+        assertTrue("autocomplete results exist", response.getSections().size() >= 0);
+        assertNotNull(
+                "pre_filter_expression exists", response.getRequest().get("pre_filter_expression"));
+        assertEquals(preFilterExpression, preFilterExpressionFromRequestJsonString);
+    }
 }