feat(poll): add query polls endpoint

- Add QueryPollsResponse class with pagination support
- Add QueryPollsRequestData with QueryPollsRequest builder class
- Add query() static factory method
- Add POST /polls/query service method
- Add unit tests for basic query and query with filter/sort

Author: GwFreak01

src/main/java/io/getstream/chat/java/models/Poll.java

@@ -556,6 +556,71 @@ protected Call<StreamResponseObject> generateCall(Client client) throws StreamEx
     }
   }
 
+  /** Response for querying polls. */
+  @Data
+  @NoArgsConstructor
+  @EqualsAndHashCode(callSuper = true)
+  public static class QueryPollsResponse extends StreamResponseObject {
+    @Nullable
+    @JsonProperty("polls")
+    private List<Poll> polls;
+
+    @Nullable
+    @JsonProperty("next")
+    private String next;
+
+    @Nullable
+    @JsonProperty("prev")
+    private String prev;
+  }
+
+  /** Request data for querying polls. */
+  @Builder(
+      builderClassName = "QueryPollsRequest",
+      builderMethodName = "",
+      buildMethodName = "internalBuild")
+  @Getter
+  @EqualsAndHashCode
+  public static class QueryPollsRequestData {
+    @Nullable
+    @JsonProperty("filter")
+    private Map<String, Object> filter;
+
+    @Singular
+    @Nullable
+    @JsonProperty("sort")
+    private List<Sort> sorts;
+
+    @Nullable
+    @JsonProperty("limit")
+    private Integer limit;
+
+    @Nullable
+    @JsonProperty("next")
+    private String next;
+
+    @Nullable
+    @JsonProperty("prev")
+    private String prev;
+
+    @Nullable
+    @JsonProperty("user_id")
+    private String userId;
+
+    @Nullable
+    @JsonProperty("user")
+    private UserRequestObject user;
+
+    public static class QueryPollsRequest extends StreamRequest<QueryPollsResponse> {
+      public QueryPollsRequest() {}
+
+      @Override
+      protected Call<QueryPollsResponse> generateCall(Client client) throws StreamException {
+        return client.create(PollService.class).query(this.internalBuild());
+      }
+    }
+  }
+
   /** Request data for creating a poll. */
   @Builder(
       builderClassName = "CreatePollRequest",
@@ -709,4 +774,14 @@ public static DeletePollOptionRequest deleteOption(
       @NotNull String pollId, @NotNull String optionId) {
     return new DeletePollOptionRequest(pollId, optionId);
   }
+
+  /**
+   * Queries polls.
+   *
+   * @return the created request
+   */
+  @NotNull
+  public static QueryPollsRequestData.QueryPollsRequest query() {
+    return new QueryPollsRequestData.QueryPollsRequest();
+  }
 }

src/main/java/io/getstream/chat/java/services/PollService.java

@@ -6,6 +6,8 @@
 import io.getstream.chat.java.models.Poll.CreatePollResponse;
 import io.getstream.chat.java.models.Poll.GetPollResponse;
 import io.getstream.chat.java.models.Poll.PartialUpdatePollRequestData;
+import io.getstream.chat.java.models.Poll.QueryPollsRequestData;
+import io.getstream.chat.java.models.Poll.QueryPollsResponse;
 import io.getstream.chat.java.models.Poll.UpdatePollOptionRequestData;
 import io.getstream.chat.java.models.Poll.UpdatePollOptionResponse;
 import io.getstream.chat.java.models.Poll.UpdatePollRequestData;
@@ -112,4 +114,13 @@ Call<StreamResponseObject> deleteOption(
       @NotNull @Path("poll_id") String pollId,
       @NotNull @Path("option_id") String optionId,
       @Nullable @Query("user_id") String userId);
+
+  /**
+   * Queries polls.
+   *
+   * @param request The query polls request data
+   * @return A response with the matching polls
+   */
+  @POST("polls/query")
+  Call<QueryPollsResponse> query(@NotNull @Body QueryPollsRequestData request);
 }

src/test/java/io/getstream/chat/java/PollTest.java

@@ -5,10 +5,13 @@
 import io.getstream.chat.java.models.Poll.CreatePollResponse;
 import io.getstream.chat.java.models.Poll.GetPollResponse;
 import io.getstream.chat.java.models.Poll.PollOptionRequestObject;
+import io.getstream.chat.java.models.Poll.QueryPollsResponse;
 import io.getstream.chat.java.models.Poll.UpdatePollOptionResponse;
 import io.getstream.chat.java.models.Poll.UpdatePollResponse;
 import io.getstream.chat.java.models.Poll.VotingVisibility;
+import io.getstream.chat.java.models.Sort;
 import io.getstream.chat.java.models.framework.StreamResponseObject;
+import java.util.Map;
 import java.util.UUID;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.DisplayName;
@@ -378,4 +381,53 @@ void whenDeletingPollOption_thenNoException() {
 
     Assertions.assertNotNull(deleteResponse);
   }
+
+  @DisplayName("Can query polls")
+  @Test
+  void whenQueryingPolls_thenNoException() {
+    // Create a poll first
+    Assertions.assertDoesNotThrow(
+        () ->
+            Poll.create()
+                .name("Query Poll " + UUID.randomUUID())
+                .userId(testUserRequestObject.getId())
+                .option(PollOptionRequestObject.builder().text("Option 1").build())
+                .request());
+
+    // Query polls
+    QueryPollsResponse queryResponse =
+        Assertions.assertDoesNotThrow(
+            () -> Poll.query().userId(testUserRequestObject.getId()).request());
+
+    Assertions.assertNotNull(queryResponse);
+    Assertions.assertNotNull(queryResponse.getPolls());
+  }
+
+  @DisplayName("Can query polls with filter and sort")
+  @Test
+  void whenQueryingPollsWithFilterAndSort_thenNoException() {
+    // Create a poll first
+    String pollName = "Filter Poll " + UUID.randomUUID();
+    Assertions.assertDoesNotThrow(
+        () ->
+            Poll.create()
+                .name(pollName)
+                .userId(testUserRequestObject.getId())
+                .option(PollOptionRequestObject.builder().text("Option 1").build())
+                .request());
+
+    // Query polls with filter and sort
+    QueryPollsResponse queryResponse =
+        Assertions.assertDoesNotThrow(
+            () ->
+                Poll.query()
+                    .filter(Map.of("name", pollName))
+                    .sort(Sort.builder().field("created_at").direction(Sort.Direction.DESC).build())
+                    .limit(10)
+                    .userId(testUserRequestObject.getId())
+                    .request());
+
+    Assertions.assertNotNull(queryResponse);
+    Assertions.assertNotNull(queryResponse.getPolls());
+  }
 }