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/bootstrap/src/factory.rs

@@ -1,6 +1,6 @@
-use std::sync::Arc;
 use async_trait::async_trait;
 use sqlx::PgPool;
+use std::sync::Arc;
 
 use activitypub::ThoughtsObjectHandler;
 use activitypub_base::{ApFederationConfig, FederationData};
@@ -23,7 +23,9 @@ struct NoOpEventPublisher;
 
 #[async_trait]
 impl EventPublisher for NoOpEventPublisher {
-    async fn publish(&self, _e: &DomainEvent) -> Result<(), DomainError> { Ok(()) }
+    async fn publish(&self, _e: &DomainEvent) -> Result<(), DomainError> {
+        Ok(())
+    }
 }
 
 pub async fn build(cfg: &Config) -> Infrastructure {
@@ -58,7 +60,10 @@ pub async fn build(cfg: &Config) -> Infrastructure {
     // 3. ActivityPub federation
     let fed_data = FederationData::new(
         Arc::new(PostgresFederationRepository::new(pool.clone())),
-        Arc::new(PostgresApUserRepository::new(pool.clone(), cfg.base_url.clone())),
+        Arc::new(PostgresApUserRepository::new(
+            pool.clone(),
+            cfg.base_url.clone(),
+        )),
         Arc::new(ThoughtsObjectHandler::new(
             Arc::new(PgActivityPubRepository::new(pool.clone())),
             &cfg.base_url,
@@ -74,22 +79,31 @@ pub async fn build(cfg: &Config) -> Infrastructure {
 
     // 4. Application state
     let state = AppState {
-        users:         Arc::new(postgres::user::PgUserRepository::new(pool.clone())),
-        thoughts:      Arc::new(postgres::thought::PgThoughtRepository::new(pool.clone())),
-        likes:         Arc::new(postgres::like::PgLikeRepository::new(pool.clone())),
-        boosts:        Arc::new(postgres::boost::PgBoostRepository::new(pool.clone())),
-        follows:       Arc::new(postgres::follow::PgFollowRepository::new(pool.clone())),
-        blocks:        Arc::new(postgres::block::PgBlockRepository::new(pool.clone())),
-        tags:          Arc::new(postgres::tag::PgTagRepository::new(pool.clone())),
-        api_keys:      Arc::new(postgres::api_key::PgApiKeyRepository::new(pool.clone())),
-        top_friends:   Arc::new(postgres::top_friend::PgTopFriendRepository::new(pool.clone())),
-        notifications: Arc::new(postgres::notification::PgNotificationRepository::new(pool.clone())),
-        remote_actors: Arc::new(postgres::remote_actor::PgRemoteActorRepository::new(pool.clone())),
-        feed:          Arc::new(postgres::feed::PgFeedRepository::new(pool.clone())),
-        search:        Arc::new(postgres_search::PgSearchRepository::new(pool.clone())),
-        auth:          Arc::new(auth::JwtAuthService::new(cfg.jwt_secret.clone(), 86400 * 30)),
-        hasher:        Arc::new(auth::Argon2PasswordHasher),
-        events:        event_publisher,
+        users: Arc::new(postgres::user::PgUserRepository::new(pool.clone())),
+        thoughts: Arc::new(postgres::thought::PgThoughtRepository::new(pool.clone())),
+        likes: Arc::new(postgres::like::PgLikeRepository::new(pool.clone())),
+        boosts: Arc::new(postgres::boost::PgBoostRepository::new(pool.clone())),
+        follows: Arc::new(postgres::follow::PgFollowRepository::new(pool.clone())),
+        blocks: Arc::new(postgres::block::PgBlockRepository::new(pool.clone())),
+        tags: Arc::new(postgres::tag::PgTagRepository::new(pool.clone())),
+        api_keys: Arc::new(postgres::api_key::PgApiKeyRepository::new(pool.clone())),
+        top_friends: Arc::new(postgres::top_friend::PgTopFriendRepository::new(
+            pool.clone(),
+        )),
+        notifications: Arc::new(postgres::notification::PgNotificationRepository::new(
+            pool.clone(),
+        )),
+        remote_actors: Arc::new(postgres::remote_actor::PgRemoteActorRepository::new(
+            pool.clone(),
+        )),
+        feed: Arc::new(postgres::feed::PgFeedRepository::new(pool.clone())),
+        search: Arc::new(postgres_search::PgSearchRepository::new(pool.clone())),
+        auth: Arc::new(auth::JwtAuthService::new(
+            cfg.jwt_secret.clone(),
+            86400 * 30,
+        )),
+        hasher: Arc::new(auth::Argon2PasswordHasher),
+        events: event_publisher,
     };
 
     Infrastructure { state, fed_config }