Refactor handlers and OpenAPI documentation for improved readability and consistency

- Reorganized imports in health, notifications, social, thoughts, and users handlers for clarity.
- Updated function signatures in handlers to improve readability by aligning parameters.
- Enhanced JSON response formatting in notifications and thoughts handlers.
- Improved error handling in user-related functions.
- Refactored OpenAPI documentation to maintain consistent formatting and structure.
- Cleaned up unnecessary code and comments across various files.
- Ensured consistent use of `Arc` for shared state in AppState and WorkerHandlers.

crates/presentation/src/handlers/feed.rs

@@ -1,11 +1,22 @@
-use axum::{extract::{Path, Query, State}, Json};
+use crate::{
+    errors::ApiError,
+    extractors::{AuthUser, OptionalAuthUser},
+    handlers::auth::to_user_response,
+    state::AppState,
+};
 use api_types::requests::{PaginationQuery, SearchQuery};
 use api_types::responses::ThoughtResponse;
-use application::use_cases::feed::{get_home_feed, get_public_feed, get_followers, get_following, get_user_feed, get_by_tag, get_popular_tags as uc_get_popular_tags};
-use application::use_cases::search::{search_thoughts, search_users};
-use domain::models::feed::PageParams;
-use crate::{errors::ApiError, extractors::{AuthUser, OptionalAuthUser}, handlers::auth::to_user_response, state::AppState};
+use application::use_cases::feed::{
+    get_by_tag, get_followers, get_following, get_home_feed,
+    get_popular_tags as uc_get_popular_tags, get_public_feed, get_user_feed,
+};
 use application::use_cases::profile::get_user_by_username;
+use application::use_cases::search::{search_thoughts, search_users};
+use axum::{
+    extract::{Path, Query, State},
+    Json,
+};
+use domain::models::feed::PageParams;
 
 fn to_thought_response(e: &domain::models::feed::FeedEntry) -> ThoughtResponse {
     ThoughtResponse {
@@ -32,8 +43,15 @@ fn to_thought_response(e: &domain::models::feed::FeedEntry) -> ThoughtResponse {
     responses((status = 200, description = "Home feed")),
     security(("bearer_auth" = []))
 )]
-pub async fn home_feed(State(s): State<AppState>, AuthUser(uid): AuthUser, Query(q): Query<PaginationQuery>) -> Result<Json<serde_json::Value>, ApiError> {
-    let page = PageParams { page: q.page(), per_page: q.per_page() };
+pub async fn home_feed(
+    State(s): State<AppState>,
+    AuthUser(uid): AuthUser,
+    Query(q): Query<PaginationQuery>,
+) -> Result<Json<serde_json::Value>, ApiError> {
+    let page = PageParams {
+        page: q.page(),
+        per_page: q.per_page(),
+    };
     let result = get_home_feed(&*s.feed, &*s.follows, &uid, page).await?;
     Ok(Json(serde_json::json!({
         "items": result.items.iter().map(to_thought_response).collect::<Vec<_>>(),
@@ -48,8 +66,15 @@ pub async fn home_feed(State(s): State<AppState>, AuthUser(uid): AuthUser, Query
     params(PaginationQuery),
     responses((status = 200, description = "Public feed"))
 )]
-pub async fn public_feed(State(s): State<AppState>, OptionalAuthUser(viewer): OptionalAuthUser, Query(q): Query<PaginationQuery>) -> Result<Json<serde_json::Value>, ApiError> {
-    let page = PageParams { page: q.page(), per_page: q.per_page() };
+pub async fn public_feed(
+    State(s): State<AppState>,
+    OptionalAuthUser(viewer): OptionalAuthUser,
+    Query(q): Query<PaginationQuery>,
+) -> Result<Json<serde_json::Value>, ApiError> {
+    let page = PageParams {
+        page: q.page(),
+        per_page: q.per_page(),
+    };
     let result = get_public_feed(&*s.feed, viewer.as_ref(), page).await?;
     Ok(Json(serde_json::json!({
         "items": result.items.iter().map(to_thought_response).collect::<Vec<_>>(),
@@ -69,25 +94,53 @@ pub async fn search_handler(
     OptionalAuthUser(viewer): OptionalAuthUser,
     Query(q): Query<SearchQuery>,
 ) -> Result<Json<serde_json::Value>, ApiError> {
-    let page = PageParams { page: q.page.unwrap_or(1), per_page: q.per_page.unwrap_or(20) };
+    let page = PageParams {
+        page: q.page.unwrap_or(1),
+        per_page: q.per_page.unwrap_or(20),
+    };
     let query = q.q.trim().to_string();
 
     let (thoughts_result, users_result) = tokio::join!(
-        search_thoughts(&*s.search, &query, PageParams { page: page.page, per_page: page.per_page }, viewer.as_ref()),
-        search_users(&*s.search, &query, PageParams { page: page.page, per_page: page.per_page }),
+        search_thoughts(
+            &*s.search,
+            &query,
+            PageParams {
+                page: page.page,
+                per_page: page.per_page
+            },
+            viewer.as_ref()
+        ),
+        search_users(
+            &*s.search,
+            &query,
+            PageParams {
+                page: page.page,
+                per_page: page.per_page
+            }
+        ),
     );
 
-    let thoughts = thoughts_result?.items.into_iter().map(|e| serde_json::json!({
-        "id": e.thought.id.as_uuid(),
-        "content": e.thought.content.as_str(),
-        "author": to_user_response(&e.author),
-        "like_count": e.like_count,
-        "boost_count": e.boost_count,
-        "reply_count": e.reply_count,
-        "created_at": e.thought.created_at,
-    })).collect::<Vec<_>>();
+    let thoughts = thoughts_result?
+        .items
+        .into_iter()
+        .map(|e| {
+            serde_json::json!({
+                "id": e.thought.id.as_uuid(),
+                "content": e.thought.content.as_str(),
+                "author": to_user_response(&e.author),
+                "like_count": e.like_count,
+                "boost_count": e.boost_count,
+                "reply_count": e.reply_count,
+                "created_at": e.thought.created_at,
+            })
+        })
+        .collect::<Vec<_>>();
 
-    let users = users_result?.items.into_iter().map(|u| to_user_response(&u)).collect::<Vec<_>>();
+    let users = users_result?
+        .items
+        .into_iter()
+        .map(|u| to_user_response(&u))
+        .collect::<Vec<_>>();
 
     Ok(Json(serde_json::json!({
         "query": query,
@@ -96,18 +149,36 @@ pub async fn search_handler(
     })))
 }
 
-pub async fn get_following_handler(State(s): State<AppState>, Path(username): Path<String>, Query(q): Query<PaginationQuery>) -> Result<Json<serde_json::Value>, ApiError> {
+pub async fn get_following_handler(
+    State(s): State<AppState>,
+    Path(username): Path<String>,
+    Query(q): Query<PaginationQuery>,
+) -> Result<Json<serde_json::Value>, ApiError> {
     let user = get_user_by_username(&*s.users, &username).await?;
-    let page = PageParams { page: q.page(), per_page: q.per_page() };
+    let page = PageParams {
+        page: q.page(),
+        per_page: q.per_page(),
+    };
     let result = get_following(&*s.follows, &user.id, page).await?;
-    Ok(Json(serde_json::json!({ "total": result.total, "items": result.items.iter().map(to_user_response).collect::<Vec<_>>() })))
+    Ok(Json(
+        serde_json::json!({ "total": result.total, "items": result.items.iter().map(to_user_response).collect::<Vec<_>>() }),
+    ))
 }
 
-pub async fn get_followers_handler(State(s): State<AppState>, Path(username): Path<String>, Query(q): Query<PaginationQuery>) -> Result<Json<serde_json::Value>, ApiError> {
+pub async fn get_followers_handler(
+    State(s): State<AppState>,
+    Path(username): Path<String>,
+    Query(q): Query<PaginationQuery>,
+) -> Result<Json<serde_json::Value>, ApiError> {
     let user = get_user_by_username(&*s.users, &username).await?;
-    let page = PageParams { page: q.page(), per_page: q.per_page() };
+    let page = PageParams {
+        page: q.page(),
+        per_page: q.per_page(),
+    };
     let result = get_followers(&*s.follows, &user.id, page).await?;
-    Ok(Json(serde_json::json!({ "total": result.total, "items": result.items.iter().map(to_user_response).collect::<Vec<_>>() })))
+    Ok(Json(
+        serde_json::json!({ "total": result.total, "items": result.items.iter().map(to_user_response).collect::<Vec<_>>() }),
+    ))
 }
 
 #[utoipa::path(
@@ -125,7 +196,10 @@ pub async fn user_thoughts_handler(
     Query(q): Query<PaginationQuery>,
 ) -> Result<Json<serde_json::Value>, ApiError> {
     let user = get_user_by_username(&*s.users, &username).await?;
-    let page = PageParams { page: q.page(), per_page: q.per_page() };
+    let page = PageParams {
+        page: q.page(),
+        per_page: q.per_page(),
+    };
     let result = get_user_feed(&*s.feed, &user.id, page, viewer.as_ref()).await?;
     Ok(Json(serde_json::json!({
         "total": result.total,
@@ -139,7 +213,10 @@ pub async fn get_popular_tags(
     State(s): State<AppState>,
     Query(params): Query<std::collections::HashMap<String, String>>,
 ) -> Result<Json<serde_json::Value>, ApiError> {
-    let limit: usize = params.get("limit").and_then(|v| v.parse().ok()).unwrap_or(20);
+    let limit: usize = params
+        .get("limit")
+        .and_then(|v| v.parse().ok())
+        .unwrap_or(20);
     let tags = uc_get_popular_tags(&*s.tags, limit.min(100)).await?;
     Ok(Json(serde_json::json!({
         "tags": tags.iter().map(|(name, count)| serde_json::json!({
@@ -163,7 +240,10 @@ pub async fn tag_thoughts_handler(
     OptionalAuthUser(viewer): OptionalAuthUser,
     Query(q): Query<PaginationQuery>,
 ) -> Result<Json<serde_json::Value>, ApiError> {
-    let page = PageParams { page: q.page(), per_page: q.per_page() };
+    let page = PageParams {
+        page: q.page(),
+        per_page: q.per_page(),
+    };
     let result = get_by_tag(&*s.feed, &tag_name, page, viewer.as_ref()).await?;
     Ok(Json(serde_json::json!({
         "tag": tag_name,