utoipa: Add annotations to /me/crate_owner_invitations/{crate_id} endpoints

Author: Turbo87

src/controllers/crate_owner_invitation.rs

@@ -272,7 +272,14 @@ struct OwnerInvitation {
     crate_owner_invite: InvitationResponse,
 }
 
-/// Handles the `PUT /api/v1/me/crate_owner_invitations/:crate_id` route.
+/// Accept or decline a crate owner invitation.
+#[utoipa::path(
+    put,
+    path = "/api/v1/me/crate_owner_invitations/{crate_id}",
+    operation_id = "handle_crate_owner_invitation",
+    tag = "owners",
+    responses((status = 200, description = "Successful Response")),
+)]
 pub async fn handle_invite(state: AppState, req: BytesRequest) -> AppResult<ErasedJson> {
     let (parts, body) = req.0.into_parts();
 

src/router.rs

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

src/snapshots/crates_io__openapi__tests__openapi_snapshot.snap

@@ -468,6 +468,20 @@ snapshot_kind: text
         ]
       }
     },
+    "/api/v1/me/crate_owner_invitations/{crate_id}": {
+      "put": {
+        "operationId": "handle_crate_owner_invitation",
+        "responses": {
+          "200": {
+            "description": "Successful Response"
+          }
+        },
+        "summary": "Accept or decline a crate owner invitation.",
+        "tags": [
+          "owners"
+        ]
+      }
+    },
     "/api/v1/me/tokens": {
       "get": {
         "operationId": "list_api_tokens",