use axum::{ extract::{Path, Query, State}, http::StatusCode, response::{IntoResponse, Redirect}, }; use axum_cookie::CookieManager; use serde::Serialize; use tracing::{debug, debug_span, info, instrument, trace, warn, Instrument}; use crate::data::user as user_repo; use crate::{app::AppState, errors::ErrorResponse, session}; #[derive(Debug, serde::Deserialize)] pub struct OAuthCallbackParams { pub code: Option, pub state: Option, pub error: Option, pub error_description: Option, } /// Handles the beginning of the OAuth authorization flow. /// /// Requires the `provider` path parameter, which determines the OAuth provider to use. #[instrument(skip_all, fields(provider = %provider))] pub async fn oauth_authorize_handler( State(app_state): State, Path(provider): Path, cookie: CookieManager, ) -> axum::response::Response { let Some(prov) = app_state.auth.get(&provider) else { warn!(%provider, "Unknown OAuth provider"); return ErrorResponse::bad_request("invalid_provider", Some(provider)).into_response(); }; trace!("Starting OAuth authorization"); let auth_info = match prov.authorize(&app_state.jwt_encoding_key).await { Ok(info) => info, Err(e) => return e.into_response(), }; session::set_session_cookie(&cookie, &auth_info.session_token); trace!("Redirecting to provider authorization page"); Redirect::to(auth_info.authorize_url.as_str()).into_response() } /// Handles the callback from the OAuth provider after the user has authorized the app. /// /// Requires the `provider` path parameter, which determines the OAuth provider to use for finishing the OAuth flow. /// Requires the `code` and `state` query parameters, which are returned by the OAuth provider after the user has authorized the app. pub async fn oauth_callback_handler( State(app_state): State, Path(provider): Path, Query(params): Query, cookie: CookieManager, ) -> axum::response::Response { // Validate provider let Some(prov) = app_state.auth.get(&provider) else { warn!(%provider, "Unknown OAuth provider"); return ErrorResponse::bad_request("invalid_provider", Some(provider)).into_response(); }; // Process callback-returned errors from provider if let Some(error) = params.error { warn!(%provider, error = %error, desc = ?params.error_description, "OAuth callback returned an error"); return ErrorResponse::bad_request(error, params.error_description).into_response(); } // Acquire required parameters let Some(code) = params.code.as_deref() else { return ErrorResponse::bad_request("invalid_request", Some("missing code".into())).into_response(); }; let Some(state) = params.state.as_deref() else { return ErrorResponse::bad_request("invalid_request", Some("missing state".into())).into_response(); }; debug_span!("oauth_callback_handler", provider = %provider, code = %code, state = %state); // Handle callback from provider let user = match prov.handle_callback(code, state, &cookie, &app_state.jwt_decoding_key).await { Ok(u) => u, Err(e) => { warn!(%provider, "OAuth callback handling failed"); return e.into_response(); } }; // --- Simplified Sign-in / Sign-up Flow --- let linking_span = debug_span!("account_linking", provider_user_id = %user.id, provider_email = ?user.email, email_verified = %user.email_verified); let db_user_result: Result = async { // 1. Check if we already have this specific provider account linked if let Some(user) = user_repo::find_user_by_provider_id(&app_state.db, &provider, &user.id).await? { debug!(user_id = %user.id, "Found existing user by provider ID"); return Ok(user); } // 2. If not, try to find an existing user by verified email to link to let user_to_link = if user.email_verified { if let Some(email) = user.email.as_deref() { // Try to find a user with this email if let Some(existing_user) = user_repo::find_user_by_email(&app_state.db, email).await? { debug!(user_id = %existing_user.id, "Found existing user by email, linking new provider"); existing_user } else { // No user with this email, create a new one debug!("No user found by email, creating a new one"); user_repo::create_user(&app_state.db, Some(email)).await? } } else { // Verified, but no email for some reason. Create a user without an email. user_repo::create_user(&app_state.db, None).await? } } else { // No verified email, so we must create a new user without an email. debug!("No verified email, creating a new user"); user_repo::create_user(&app_state.db, None).await? }; // 3. Link the new provider account to our user record (whether old or new) user_repo::link_oauth_account( &app_state.db, user_to_link.id, &provider, &user.id, user.email.as_deref(), Some(&user.username), user.name.as_deref(), user.avatar_url.as_deref(), ) .await?; Ok(user_to_link) } .instrument(linking_span) .await; let _: user_repo::User = match db_user_result { Ok(u) => u, Err(e) => { warn!(error = %(&e as &dyn std::error::Error), "Failed to process user linking/creation"); return ErrorResponse::with_status(StatusCode::INTERNAL_SERVER_ERROR, "database_error", None).into_response(); } }; // Create session token let session_token = session::create_jwt_for_user(&provider, &user, &app_state.jwt_encoding_key); session::set_session_cookie(&cookie, &session_token); info!(%provider, "Signed in successfully"); // Process avatar asynchronously (don't block the response) if let Some(avatar_url) = user.avatar_url.as_deref() { let image_storage = app_state.image_storage.clone(); let user_public_id = user.id.clone(); let avatar_url = avatar_url.to_string(); debug!(%user_public_id, %avatar_url, "Processing avatar"); tokio::spawn(async move { match image_storage.process_avatar(&user_public_id, &avatar_url).await { Ok(avatar_urls) => { info!( user_id = %user_public_id, original_url = %avatar_urls.original_url, mini_url = %avatar_urls.mini_url, "Avatar processed successfully" ); } Err(e) => { warn!( user_id = %user_public_id, avatar_url = %avatar_url, error = %e, "Failed to process avatar" ); } } }); } (StatusCode::FOUND, Redirect::to("/api/profile")).into_response() } /// Handles the request to the profile endpoint. /// /// Requires the `session` cookie to be present. pub async fn profile_handler(State(app_state): State, cookie: CookieManager) -> axum::response::Response { let Some(token_str) = session::get_session_token(&cookie) else { debug!("Missing session cookie"); return ErrorResponse::unauthorized("missing session cookie").into_response(); }; let Some(claims) = session::decode_jwt(&token_str, &app_state.jwt_decoding_key) else { debug!("Invalid session token"); return ErrorResponse::unauthorized("invalid session token").into_response(); }; // sub format: provider:provider_user_id let (prov, prov_user_id) = match claims.subject.split_once(':') { Some((p, id)) => (p, id), None => { debug!("Malformed session token subject"); return ErrorResponse::unauthorized("invalid session token").into_response(); } }; match user_repo::find_user_by_provider_id(&app_state.db, prov, prov_user_id).await { Ok(Some(db_user)) => { // Include linked providers in the profile payload match user_repo::list_user_providers(&app_state.db, db_user.id).await { Ok(providers) => { #[derive(Serialize)] struct ProfilePayload { id: i64, email: Option, providers: Vec, created_at: chrono::DateTime, updated_at: chrono::DateTime, } let body = ProfilePayload { id: db_user.id, email: db_user.email.clone(), providers, created_at: db_user.created_at, updated_at: db_user.updated_at, }; axum::Json(body).into_response() } Err(e) => { warn!(error = %e, "Failed to list user providers"); ErrorResponse::with_status( StatusCode::INTERNAL_SERVER_ERROR, "database_error", Some("could not fetch providers".into()), ) .into_response() } } } Ok(None) => { debug!("User not found for session"); ErrorResponse::unauthorized("session not found").into_response() } Err(e) => { warn!(error = %e, "Failed to fetch user for session"); ErrorResponse::with_status( StatusCode::INTERNAL_SERVER_ERROR, "database_error", Some("could not fetch user".into()), ) .into_response() } } } pub async fn logout_handler(State(app_state): State, cookie: CookieManager) -> axum::response::Response { if let Some(token_str) = session::get_session_token(&cookie) { // Remove from in-memory sessions if present app_state.sessions.remove(&token_str); } session::clear_session_cookie(&cookie); info!("Signed out successfully"); (StatusCode::FOUND, Redirect::to("/")).into_response() } #[derive(Serialize)] struct ProviderInfo { id: &'static str, name: &'static str, active: bool, } pub async fn list_providers_handler(State(app_state): State) -> axum::response::Response { let providers: Vec = app_state .auth .values() .map(|provider| ProviderInfo { id: provider.id(), name: provider.label(), active: provider.active(), }) .collect(); axum::Json(providers).into_response() } pub async fn health_handler( State(app_state): State, Query(params): Query>, ) -> axum::response::Response { // Force health check in debug mode #[cfg(debug_assertions)] if params.contains_key("force") { app_state.check_health().await; } let ok = app_state.health.read().await.ok(); let status = if ok { StatusCode::OK } else { StatusCode::SERVICE_UNAVAILABLE }; let body = serde_json::json!({ "ok": ok }); (status, axum::Json(body)).into_response() }