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/export.rs

@@ -5,12 +5,25 @@ use serde::Deserialize;
 
 use crate::{error::ApiError, state::AppState};
 
-#[derive(Debug, Deserialize)]
+#[derive(Debug, Deserialize, utoipa::ToSchema)]
 pub struct ExportRequest {
   pub format:      String,
+  #[schema(value_type = String)]
   pub destination: PathBuf,
 }
 
+#[utoipa::path(
+    post,
+    path = "/api/v1/export",
+    tag = "export",
+    responses(
+        (status = 200, description = "Export job submitted"),
+        (status = 401, description = "Unauthorized"),
+        (status = 403, description = "Forbidden"),
+        (status = 500, description = "Internal server error"),
+    ),
+    security(("bearer_auth" = []))
+)]
 pub async fn trigger_export(
   State(state): State<AppState>,
 ) -> Result<Json<serde_json::Value>, ApiError> {
@@ -25,6 +38,19 @@ pub async fn trigger_export(
   Ok(Json(serde_json::json!({ "job_id": job_id.to_string() })))
 }
 
+#[utoipa::path(
+    post,
+    path = "/api/v1/export/options",
+    tag = "export",
+    request_body = ExportRequest,
+    responses(
+        (status = 200, description = "Export job submitted"),
+        (status = 401, description = "Unauthorized"),
+        (status = 403, description = "Forbidden"),
+        (status = 500, description = "Internal server error"),
+    ),
+    security(("bearer_auth" = []))
+)]
 pub async fn trigger_export_with_options(
   State(state): State<AppState>,
   Json(req): Json<ExportRequest>,