use actix_web::{HttpResponse, web}; use crate::api::response::{ApiErrorResponse, ApiResponse}; use crate::error::AppError; use crate::service::AppService; use crate::service::workspace::invitations::{CreateInvitationParams, CreateInvitationResponse}; use crate::session::Session; #[utoipa::path( post, path = "/api/v1/workspaces/{workspace_name}/invitations", tag = "Workspaces", operation_id = "workspaceCreateInvitation", summary = "Create an invitation", description = "Invite a user by email to join the workspace. An invitation email is sent. Requires admin role.", params( ("workspace_name" = String, Path, description = "Workspace name.") ), request_body( content = CreateInvitationParams, description = "Email and optional role.", content_type = "application/json" ), responses( (status = 200, description = "Invitation created and email sent.", body = ApiResponse), (status = 400, description = "Email is empty, role is invalid, or invitation already exists.", body = ApiErrorResponse), (status = 401, description = "Unauthenticated or insufficient role.", body = ApiErrorResponse), (status = 500, description = "Database or email service failed.", body = ApiErrorResponse) ) )] pub async fn handle( service: web::Data, session: Session, path: web::Path, params: web::Json, ) -> Result { let ws = service.workspace.find_workspace_by_name(&path).await?; let data = service .workspace .workspace_create_invitation(&session, &ws, params.into_inner()) .await?; Ok(HttpResponse::Ok().json(ApiResponse::new(data))) }