pinakes-server: add utoipa annotations to all routes; fix tests

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I28cf5b7b7cff8e90e123d624d97cf9656a6a6964

crates/pinakes-server/src/routes/webhooks.rs

@@ -3,12 +3,23 @@ use serde::Serialize;
 
 use crate::{error::ApiError, state::AppState};
 
-#[derive(Debug, Serialize)]
+#[derive(Debug, Serialize, utoipa::ToSchema)]
 pub struct WebhookInfo {
   pub url:    String,
   pub events: Vec<String>,
 }
 
+#[utoipa::path(
+    get,
+    path = "/api/v1/webhooks",
+    tag = "webhooks",
+    responses(
+        (status = 200, description = "List of configured webhooks", body = Vec<WebhookInfo>),
+        (status = 401, description = "Unauthorized"),
+        (status = 403, description = "Forbidden"),
+    ),
+    security(("bearer_auth" = []))
+)]
 pub async fn list_webhooks(
   State(state): State<AppState>,
 ) -> Result<Json<Vec<WebhookInfo>>, ApiError> {
@@ -26,6 +37,17 @@ pub async fn list_webhooks(
   Ok(Json(hooks))
 }
 
+#[utoipa::path(
+    post,
+    path = "/api/v1/webhooks/test",
+    tag = "webhooks",
+    responses(
+        (status = 200, description = "Test webhook sent"),
+        (status = 401, description = "Unauthorized"),
+        (status = 403, description = "Forbidden"),
+    ),
+    security(("bearer_auth" = []))
+)]
 pub async fn test_webhook(
   State(state): State<AppState>,
 ) -> Result<Json<serde_json::Value>, ApiError> {