//! Creating repositories and their settings pages (hub spec ยง6.3). use super::settings::{csrf, require}; use super::{filters, lookup_role, Error, Page, RepoShell, Shell}; use crate::auth::{roles, Access, Role, Viewer}; use crate::db::{self, accounts}; use crate::repos::RepoName; use crate::Shared; use askama::Template; use axum::extract::{Form, Path, State}; use axum::response::{IntoResponse, Redirect, Response}; use hub_api::Visibility; use serde::Deserialize; #[derive(Template)] #[template(path = "repo_new.html")] pub struct NewRepoPage { shell: Shell, owners: Vec, error: Option, } pub(crate) async fn owners_for(app: &Shared, me: &accounts::Account) -> Vec { let mut owners = vec![me.username.clone()]; if let Ok(orgs) = accounts::orgs_of(&app.db, me.id).await { owners.extend(orgs.into_iter().map(|(o, _)| o.name)); } owners } pub async fn new_form(State(app): State, viewer: Viewer) -> Result, Error> { let shell = Shell::new(&app, "/new", &viewer); let me = require(&viewer, &shell)?; let owners = owners_for(&app, &me.account).await; Ok(Page(NewRepoPage { shell, owners, error: None })) } #[derive(Deserialize)] pub struct NewRepoForm { #[serde(rename = "_csrf")] csrf_token: String, owner: String, name: String, #[serde(default)] description: String, #[serde(default = "default_visibility")] visibility: String, } fn default_visibility() -> String { "public".into() } pub async fn create(State(app): State, viewer: Viewer, Form(f): Form) -> Result { let shell = Shell::new(&app, "/new", &viewer); let me = require(&viewer, &shell)?; csrf(&viewer, &f.csrf_token, &shell)?; let owners = owners_for(&app, &me.account).await; let fail = |msg: &str| Page(NewRepoPage { shell: shell.clone(), owners: owners.clone(), error: Some(msg.into()) }).into_response(); let Some(name) = RepoName::new(f.owner.trim(), f.name.trim()) else { return Ok(fail("A repository name is letters, digits, dots, dashes and underscores.")); }; if !roles::may_create_under(&app.db, &me.account, &name.owner).await.map_err(|e| Error::from_db(shell.clone(), e))? { return Ok(fail("You cannot create repositories under that owner.")); } let Some(visibility) = Visibility::parse(&f.visibility) else { return Ok(fail("Visibility is public, internal or private.")) }; if db::repos::get(&app.db, &name.owner, &name.name).await.map_err(|e| Error::from_db(shell.clone(), e))?.is_some() || app.repos.exists(&name) { return Ok(fail("That repository exists.")); } app.repos.create(&name, None).map_err(|e| Error::from_repo(shell.clone(), e))?; db::repos::create(&app.db, &name.owner, &name.name, f.description.trim(), visibility) .await .map_err(|e| Error::from_db(shell.clone(), e))?; accounts::audit(&app.db, Some(&me.account), "repo.created", &name.to_string(), visibility.as_str()).await.ok(); Ok(Redirect::to(&name.url()).into_response()) } #[derive(Template)] #[template(path = "repo_settings.html")] pub struct RepoSettingsPage { shell: Shell, repo: RepoShell, row: db::repos::RepoRow, collaborators: Vec, teams: Vec, role: Role, requirements: db::proposals::Requirements, hooks: Vec, required_checks: String, notice: Option, error: Option, } async fn settings_page( app: &Shared, shell: Shell, row: db::repos::RepoRow, role: Role, notice: Option, error: Option, ) -> Result, Error> { let collaborators = accounts::collaborators(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?; let teams = match accounts::org_by_name(&app.db, &row.owner).await.map_err(|e| Error::from_db(shell.clone(), e))? { Some(org) => accounts::teams(&app.db, org.id).await.map_err(|e| Error::from_db(shell.clone(), e))?, None => vec![], }; let repo = RepoShell::new(app, &row, "settings").with_role(role); let requirements = db::proposals::requirements(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?; let hooks = db::hooks::hooks_for_repo(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?; let required_checks = db::hooks::required_checks(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?.join(", "); Ok(Page(RepoSettingsPage { shell, repo, row, collaborators, teams, role, requirements, hooks, required_checks, notice, error })) } pub async fn settings( State(app): State, viewer: Viewer, Path((owner, name)): Path<(String, String)>, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer); let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?; settings_page(&app, shell, row, role, None, None).await } #[derive(Deserialize)] pub struct GeneralForm { #[serde(rename = "_csrf")] csrf_token: String, description: String, default_bookmark: String, visibility: String, #[serde(default)] topics: String, } pub async fn update( State(app): State, viewer: Viewer, Path((owner, name)): Path<(String, String)>, Form(f): Form, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer); let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?; csrf(&viewer, &f.csrf_token, &shell)?; let e = |e| Error::from_db(shell.clone(), e); let topics = match db::repos::parse_topics(&f.topics) { Ok(t) => t, Err(msg) => return settings_page(&app, shell, row, role, None, Some(msg)).await, }; db::repos::set_description(&app.db, row.id, f.description.trim()).await.map_err(e)?; db::repos::set_topics(&app.db, row.id, &topics).await.map_err(e)?; if crate::repos::names::valid_segment(f.default_bookmark.trim()) { db::repos::set_default_bookmark(&app.db, row.id, f.default_bookmark.trim()).await.map_err(e)?; } if role >= Role::Admin { if let Some(v) = Visibility::parse(&f.visibility) { db::repos::set_visibility(&app.db, row.id, v).await.map_err(e)?; } } accounts::audit(&app.db, viewer.account(), "repo.updated", &format!("{owner}/{name}"), "").await.ok(); let row = db::repos::get_by_id(&app.db, row.id).await.map_err(e)?.unwrap_or(row); settings_page(&app, shell, row, role, Some("Saved.".into()), None).await } #[derive(Deserialize)] pub struct CollaboratorForm { #[serde(rename = "_csrf")] csrf_token: String, #[serde(default)] username: String, #[serde(default)] team: String, #[serde(default)] role: String, #[serde(default)] remove: Option, } pub async fn collaborator( State(app): State, viewer: Viewer, Path((owner, name)): Path<(String, String)>, Form(f): Form, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer); let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?; csrf(&viewer, &f.csrf_token, &shell)?; let e = |e| Error::from_db(shell.clone(), e); let (account_id, team_id, label) = if !f.username.trim().is_empty() { match accounts::account_by_name(&app.db, f.username.trim()).await.map_err(e)? { Some(a) => (Some(a.id), None, a.username), None => return settings_page(&app, shell, row, role, None, Some("No such account.".into())).await, } } else if !f.team.trim().is_empty() { let org = accounts::org_by_name(&app.db, &row.owner).await.map_err(e)?; let team = match org { Some(o) => accounts::team_by_name(&app.db, o.id, f.team.trim()).await.map_err(e)?, None => None, }; match team { Some(t) => (None, Some(t.id), format!("team {}", t.name)), None => return settings_page(&app, shell, row, role, None, Some("No such team in this organisation.".into())).await, } } else { return settings_page(&app, shell, row, role, None, Some("Name an account or a team.".into())).await; }; if f.remove.is_some() { accounts::remove_collaborator(&app.db, row.id, account_id, team_id).await.map_err(e)?; accounts::audit(&app.db, viewer.account(), "repo.collaborator.removed", &format!("{owner}/{name}"), &label).await.ok(); return settings_page(&app, shell, row, role, Some(format!("Removed {label}.")), None).await; } let Some(new_role) = Role::parse(&f.role) else { return settings_page(&app, shell, row, role, None, Some("Pick a role.".into())).await; }; accounts::set_collaborator(&app.db, row.id, account_id, team_id, new_role.as_str()).await.map_err(e)?; accounts::audit( &app.db, viewer.account(), "repo.collaborator.set", &format!("{owner}/{name}"), &format!("{label} {}", new_role.as_str()), ) .await .ok(); settings_page(&app, shell, row, role, Some(format!("{label} now has {} access.", new_role.as_str())), None).await } #[derive(Deserialize)] pub struct DeleteForm { #[serde(rename = "_csrf")] csrf_token: String, confirm: String, } pub async fn delete( State(app): State, viewer: Viewer, Path((owner, name)): Path<(String, String)>, Form(f): Form, ) -> Result { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer); let (repo, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?; csrf(&viewer, &f.csrf_token, &shell)?; if f.confirm.trim() != repo.to_string() { return Ok(settings_page(&app, shell, row, role, None, Some("Type the repository's full name to delete it.".into())) .await? .into_response()); } let _guard = app.repos.write_guard(&repo).await; app.repos.trash(&repo).map_err(|e| Error::from_repo(shell.clone(), e))?; db::repos::delete(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?; accounts::audit(&app.db, viewer.account(), "repo.deleted", &repo.to_string(), "moved to trash").await.ok(); Ok(Redirect::to(&format!("/{owner}")).into_response()) } #[derive(Deserialize)] pub struct RequirementsForm { #[serde(rename = "_csrf")] csrf_token: String, #[serde(default)] required_approvals: i64, #[serde(default)] require_owners: Option, #[serde(default)] allow_conflicts: Option, } pub async fn requirements( State(app): State, viewer: Viewer, Path((owner, name)): Path<(String, String)>, Form(f): Form, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer); let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?; csrf(&viewer, &f.csrf_token, &shell)?; let r = db::proposals::Requirements { required_approvals: f.required_approvals.max(0), require_owners: f.require_owners.is_some(), allow_conflicts: f.allow_conflicts.is_some(), }; db::proposals::set_requirements(&app.db, row.id, r).await.map_err(|e| Error::from_db(shell.clone(), e))?; accounts::audit( &app.db, viewer.account(), "repo.requirements", &format!("{owner}/{name}"), &format!("{} approvals, owners {}, conflicts {}", r.required_approvals, r.require_owners, r.allow_conflicts), ) .await .ok(); settings_page(&app, shell, row, role, Some("Landing requirements saved.".into()), None).await } #[derive(Deserialize)] pub struct HookForm { #[serde(rename = "_csrf")] csrf_token: String, #[serde(default)] url: String, #[serde(default)] secret: String, #[serde(default = "star")] events: String, #[serde(default)] id: Option, #[serde(default)] action: String, } fn star() -> String { "*".into() } pub async fn hooks( State(app): State, viewer: Viewer, Path((owner, name)): Path<(String, String)>, Form(f): Form, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer); let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?; csrf(&viewer, &f.csrf_token, &shell)?; let e = |e| Error::from_db(shell.clone(), e); let notice = match (f.action.as_str(), f.id) { ("delete", Some(id)) => { if db::hooks::hook(&app.db, id).await.map_err(e)?.is_some_and(|h| h.repo_id == Some(row.id)) { db::hooks::delete_hook(&app.db, id).await.map_err(e)?; } "Webhook deleted.".to_string() } ("toggle", Some(id)) => { if let Some(h) = db::hooks::hook(&app.db, id).await.map_err(e)?.filter(|h| h.repo_id == Some(row.id)) { db::hooks::set_hook_active(&app.db, id, !h.active).await.map_err(e)?; } "Webhook updated.".to_string() } ("ping", Some(id)) => { if let Some(h) = db::hooks::hook(&app.db, id).await.map_err(e)?.filter(|h| h.repo_id == Some(row.id)) { let delivery = crate::auth::random_hex(16); let env = hub_api::WebhookEnvelope { event: "ping".into(), delivery: delivery.clone(), repository: None, actor: viewer.account().map(|a| a.username.clone()).unwrap_or_default(), at_ms: db::now_ms(), data: serde_json::json!({ "zen": "changes commute" }), }; db::hooks::queue_delivery(&app.db, h.id, &delivery, "ping", &serde_json::to_string(&env).unwrap_or_default()) .await .map_err(e)?; app.events.notify_deliveries(); } "Ping queued.".to_string() } _ => { if !(f.url.starts_with("http://") || f.url.starts_with("https://")) { return settings_page(&app, shell, row, role, None, Some("A webhook URL starts with http:// or https://.".into())).await; } db::hooks::create_hook(&app.db, Some(row.id), None, f.url.trim(), f.secret.trim(), f.events.trim()).await.map_err(e)?; accounts::audit(&app.db, viewer.account(), "hook.created", &format!("{owner}/{name}"), f.url.trim()).await.ok(); "Webhook added.".to_string() } }; settings_page(&app, shell, row, role, Some(notice), None).await } #[derive(Template)] #[template(path = "deliveries.html")] pub struct DeliveriesPage { shell: Shell, repo: RepoShell, hook: db::hooks::Hook, rows: Vec, } pub async fn deliveries( State(app): State, viewer: Viewer, Path((owner, name, id)): Path<(String, String, i64)>, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings/hooks/{id}/deliveries"), &viewer); let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?; let hook = db::hooks::hook(&app.db, id) .await .map_err(|e| Error::from_db(shell.clone(), e))? .filter(|h| h.repo_id == Some(row.id)) .ok_or_else(|| Error::not_found(shell.clone()))?; let rows = db::hooks::deliveries_for_hook(&app.db, id, 100).await.map_err(|e| Error::from_db(shell.clone(), e))?; Ok(Page(DeliveriesPage { shell, repo: RepoShell::new(&app, &row, "settings").with_role(role), hook, rows })) } pub async fn redeliver( State(app): State, viewer: Viewer, Path((owner, name, id, delivery)): Path<(String, String, i64, i64)>, Form(f): Form, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings/hooks/{id}/deliveries"), &viewer); let (_, row, _) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?; csrf(&viewer, &f.csrf, &shell)?; let mine = db::hooks::hook(&app.db, id).await.ok().flatten().is_some_and(|h| h.repo_id == Some(row.id)); if mine && db::hooks::delivery(&app.db, delivery).await.map_err(|e| Error::from_db(shell.clone(), e))?.is_some_and(|d| d.hook_id == id) { db::hooks::redeliver(&app.db, delivery).await.map_err(|e| Error::from_db(shell.clone(), e))?; app.events.notify_deliveries(); } deliveries(State(app), viewer, Path((owner, name, id))).await } #[derive(Deserialize)] pub struct ChecksForm { #[serde(rename = "_csrf")] csrf_token: String, #[serde(default)] required_checks: String, } pub async fn required_checks( State(app): State, viewer: Viewer, Path((owner, name)): Path<(String, String)>, Form(f): Form, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer); let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?; csrf(&viewer, &f.csrf_token, &shell)?; let names: Vec = f.required_checks.split(',').map(str::trim).filter(|s| !s.is_empty()).map(String::from).collect(); db::hooks::set_required_checks(&app.db, row.id, &names).await.map_err(|e| Error::from_db(shell.clone(), e))?; settings_page(&app, shell, row, role, Some("Required checks saved.".into()), None).await } #[derive(Deserialize)] pub struct MirrorForm { #[serde(rename = "_csrf")] csrf_token: String, #[serde(default)] enabled: Option, } pub async fn mirror( State(app): State, viewer: Viewer, Path((owner, name)): Path<(String, String)>, Form(f): Form, ) -> Result, Error> { let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer); let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?; csrf(&viewer, &f.csrf_token, &shell)?; db::repos::set_git_mirror(&app.db, row.id, f.enabled.is_some()).await.map_err(|e| Error::from_db(shell.clone(), e))?; let row = db::repos::get_by_id(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?.unwrap_or(row); if row.git_mirror { crate::mirror::refresh(&app, &row).await; } accounts::audit(&app.db, viewer.account(), "repo.mirror", &format!("{owner}/{name}"), if row.git_mirror { "on" } else { "off" }) .await .ok(); let row = db::repos::get_by_id(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?.unwrap_or(row); let notice = if row.git_mirror { "The Git mirror is on and up to date." } else { "The Git mirror is off." }; settings_page(&app, shell, row, role, Some(notice.into()), None).await }