utoipa: Add annotations to /me/crate_owner_invitations/accept/{token} endpoints

Author: Turbo87

src/controllers/crate_owner_invitation.rs

@@ -307,7 +307,14 @@ pub async fn handle_invite(state: AppState, req: BytesRequest) -> AppResult<Eras
     Ok(json!({ "crate_owner_invitation": crate_invite }))
 }
 
-/// Handles the `PUT /api/v1/me/crate_owner_invitations/accept/:token` route.
+/// Accept a crate owner invitation with a token.
+#[utoipa::path(
+    put,
+    path = "/api/v1/me/crate_owner_invitations/accept/{token}",
+    operation_id = "accept_crate_owner_invitation_with_token",
+    tag = "owners",
+    responses((status = 200, description = "Successful Response")),
+)]
 pub async fn handle_invite_with_token(
     state: AppState,
     Path(token): Path<String>,

src/router.rs

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

src/snapshots/crates_io__openapi__tests__openapi_snapshot.snap

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