utoipa: Add annotations to /me/crate_owner_invitations endpoints

Author: Turbo87

src/controllers/crate_owner_invitation.rs

@@ -23,7 +23,14 @@ use http::request::Parts;
 use indexmap::IndexMap;
 use std::collections::{HashMap, HashSet};
 
-/// Handles the `GET /api/v1/me/crate_owner_invitations` route.
+/// List all crate owner invitations for the authenticated user.
+#[utoipa::path(
+    get,
+    path = "/api/v1/me/crate_owner_invitations",
+    operation_id = "list_crate_owner_invitations",
+    tag = "owners",
+    responses((status = 200, description = "Successful Response")),
+)]
 pub async fn list(app: AppState, req: Parts) -> AppResult<ErasedJson> {
     let mut conn = app.db_read().await?;
     let auth = AuthCheck::only_cookie().check(&req, &mut conn).await?;

src/router.rs

@@ -52,13 +52,10 @@ pub fn build_axum_router(state: AppState) -> Router<()> {
         .routes(routes!(token::list, token::new))
         .routes(routes!(token::show, token::revoke))
         .routes(routes!(token::revoke_current))
+        .routes(routes!(crate_owner_invitation::list))
         .split_for_parts();
 
     let mut router = router
-        .route(
-            "/api/v1/me/crate_owner_invitations",
-            get(crate_owner_invitation::list),
-        )
         .route(
             "/api/v1/me/crate_owner_invitations/:crate_id",
             put(crate_owner_invitation::handle_invite),

src/snapshots/crates_io__openapi__tests__openapi_snapshot.snap

@@ -454,6 +454,20 @@ snapshot_kind: text
         ]
       }
     },
+    "/api/v1/me/crate_owner_invitations": {
+      "get": {
+        "operationId": "list_crate_owner_invitations",
+        "responses": {
+          "200": {
+            "description": "Successful Response"
+          }
+        },
+        "summary": "List all crate owner invitations for the authenticated user.",
+        "tags": [
+          "owners"
+        ]
+      }
+    },
     "/api/v1/me/tokens": {
       "get": {
         "operationId": "list_api_tokens",