From 01ef118b0ab7eed20df757dc682a4aae708ce732 Mon Sep 17 00:00:00 2001
From: Gabriel Kaszewski <gabrielkaszewski@gmail.com>
Date: Fri, 29 May 2026 01:59:17 +0200
Subject: [PATCH] docs(openapi): add FeedOptionsQuery IntoParams and update
 feed annotations

---
 crates/presentation/src/handlers/feed.rs | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/crates/presentation/src/handlers/feed.rs b/crates/presentation/src/handlers/feed.rs
index 1efadda..a35bcc1 100644
--- a/crates/presentation/src/handlers/feed.rs
+++ b/crates/presentation/src/handlers/feed.rs
@@ -22,12 +22,18 @@ use domain::{
     },
 };
 
-#[derive(serde::Deserialize, Default)]
+#[derive(serde::Deserialize, Default, utoipa::IntoParams)]
+#[into_params(parameter_in = Query)]
 pub struct FeedOptionsQuery {
+    /// Sort order: `newest` (default), `oldest`, `most_liked`, `most_boosted`, `most_discussed`
     pub sort: Option<String>,
+    /// Show only original posts (mutually exclusive with `replies_only`)
     pub originals_only: Option<bool>,
+    /// Show only replies (mutually exclusive with `originals_only`)
     pub replies_only: Option<bool>,
+    /// Show only posts from this instance
     pub local_only: Option<bool>,
+    /// Hide posts marked as sensitive
     pub hide_sensitive: Option<bool>,
 }
 
@@ -96,7 +102,7 @@ pub fn to_thought_response(e: &domain::models::feed::FeedEntry) -> ThoughtRespon
 
 #[utoipa::path(
     get, path = "/feed",
-    params(PaginationQuery),
+    params(PaginationQuery, FeedOptionsQuery),
     responses((status = 200, description = "Home feed")),
     security(("bearer_auth" = []))
 )]
@@ -122,7 +128,7 @@ pub async fn home_feed(
 
 #[utoipa::path(
     get, path = "/feed/public",
-    params(PaginationQuery),
+    params(PaginationQuery, FeedOptionsQuery),
     responses((status = 200, description = "Public feed"))
 )]
 pub async fn public_feed(
@@ -266,6 +272,7 @@ pub async fn get_followers_handler(
     params(
         ("username" = String, Path, description = "Username"),
         PaginationQuery,
+        FeedOptionsQuery,
     ),
     responses((status = 200, description = "User's public thoughts"))
 )]
@@ -322,6 +329,7 @@ pub async fn get_popular_tags(
     params(
         ("name" = String, Path, description = "Tag name"),
         PaginationQuery,
+        FeedOptionsQuery,
     ),
     responses((status = 200, description = "Thoughts with this tag"))
 )]