OXYGENHUB
# 36e5a9c15a84 oxygenhub / crates / hub / src / web / repo_settings.rs
37.4 KiB · Rust · last changed An organisation's storage policy 1 month ago source blame history raw
1
//! Creating repositories and their settings pages (hub spec §6.3).
2
3
use super::settings::{csrf, require};
4
use super::{filters, lookup_role, Error, Page, RepoShell, Shell};
5
use crate::auth::{roles, Access, Role, Viewer};
6
use crate::db::{self, accounts};
7
use crate::repos::RepoName;
8
use crate::Shared;
9
use askama::Template;
10
use axum::extract::{Form, Path, State};
11
use axum::response::{IntoResponse, Redirect, Response};
12
use hub_api::Visibility;
13
use serde::Deserialize;
14
15
#[derive(Template)]
16
#[template(path = "repo_new.html")]
17
pub struct NewRepoPage {
18
    shell: Shell,
19
    owners: Vec<String>,
20
    error: Option<String>,
21
}
22
23
pub(crate) async fn owners_for(app: &Shared, me: &accounts::Account) -> Vec<String> {
24
    let mut owners = vec![me.username.clone()];
25
    if let Ok(orgs) = accounts::orgs_of(&app.db, me.id).await {
26
        owners.extend(orgs.into_iter().map(|(o, _)| o.name));
27
    }
28
    owners
29
}
30
31
pub async fn new_form(State(app): State<Shared>, viewer: Viewer) -> Result<Page<NewRepoPage>, Error> {
32
    let shell = Shell::new(&app, "/new", &viewer);
33
    let me = require(&viewer, &shell)?;
34
    let owners = owners_for(&app, &me.account).await;
35
    Ok(Page(NewRepoPage { shell, owners, error: None }))
36
}
37
38
#[derive(Deserialize)]
39
pub struct NewRepoForm {
40
    #[serde(rename = "_csrf")]
41
    csrf_token: String,
42
    owner: String,
43
    name: String,
44
    #[serde(default)]
45
    description: String,
46
    #[serde(default = "default_visibility")]
47
    visibility: String,
48
    /// `hub` (this server's disk, the default) or `bucket` (oxygenhub#96).
49
    #[serde(default)]
50
    storage: String,
51
    #[serde(flatten)]
52
    bucket: BucketForm,
53
}
54
55
/// A bucket and the credentials for it, as the New repository form and
56
/// Settings → Storage give them; only the kind the URL names is read.
57
#[derive(Deserialize, Default)]
58
pub struct BucketForm {
59
    #[serde(default)]
60
    store_url: String,
61
    #[serde(default)]
62
    access_key_id: String,
63
    #[serde(default)]
64
    secret_access_key: String,
65
    #[serde(default)]
66
    service_account_key: String,
67
    #[serde(default)]
68
    tenant_id: String,
69
    #[serde(default)]
70
    client_id: String,
71
    #[serde(default)]
72
    client_secret: String,
73
}
74
75
impl BucketForm {
76
    fn credentials(&self, scheme: &str) -> Result<oxy_strata::Credentials, String> {
77
        crate::storage::credentials_from(
78
            scheme,
79
            &self.access_key_id,
80
            &self.secret_access_key,
81
            &self.service_account_key,
82
            &self.tenant_id,
83
            &self.client_id,
84
            &self.client_secret,
85
        )
86
    }
87
}
88
89
fn default_visibility() -> String {
90
    "public".into()
91
}
92
93
pub async fn create(State(app): State<Shared>, viewer: Viewer, Form(f): Form<NewRepoForm>) -> Result<Response, Error> {
94
    let shell = Shell::new(&app, "/new", &viewer);
95
    let me = require(&viewer, &shell)?;
96
    csrf(&viewer, &f.csrf_token, &shell)?;
97
    let owners = owners_for(&app, &me.account).await;
98
    let fail = |msg: &str| Page(NewRepoPage { shell: shell.clone(), owners: owners.clone(), error: Some(msg.into()) }).into_response();
99
    let Some(name) = RepoName::new(f.owner.trim(), f.name.trim()) else {
100
        return Ok(fail("A repository name is letters, digits, dots, dashes and underscores."));
101
    };
102
    if name.name.ends_with(crate::wiki::SUFFIX) {
103
        return Ok(fail("A name cannot end in .wiki: that is the address of a repository's wiki."));
104
    }
105
    if !roles::may_create_under(&app.db, &me.account, &name.owner).await.map_err(|e| Error::from_db(shell.clone(), e))? {
106
        return Ok(fail("You cannot create repositories under that owner."));
107
    }
108
    let Some(visibility) = Visibility::parse(&f.visibility) else { return Ok(fail("Visibility is public, internal or private.")) };
109
    if db::repos::get(&app.db, &name.owner, &name.name).await.map_err(|e| Error::from_db(shell.clone(), e))?.is_some()
110
        || app.repos.exists(&name)
111
    {
112
        return Ok(fail("That repository exists."));
113
    }
114
    // An organisation's storage policy (oxygenhub#96).
115
    if let Some(org) = accounts::org_by_name(&app.db, &name.owner).await.map_err(|e| Error::from_db(shell.clone(), e))? {
116
        let policy = crate::storage::policy(&app.db, org.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
117
        let store = (f.storage == "bucket").then_some(f.bucket.store_url.as_str());
118
        if let Err(e) = policy.permits(&org.name, store) {
119
            return Ok(fail(&format!("{e}.")));
120
        }
121
    }
122
    if f.storage == "bucket" {
123
        // Kept in the owner's bucket (oxygenhub#96): checked before
124
        // anything is made, and nothing is left behind when it fails.
125
        let url = f.bucket.store_url.trim();
126
        let parsed = match crate::storage::check_url(url) {
127
            Ok(p) => p,
128
            Err(e) => return Ok(fail(&format!("Store: {e}."))),
129
        };
130
        let credentials = match f.bucket.credentials(&parsed.scheme) {
131
            Ok(c) => c,
132
            Err(e) => return Ok(fail(&format!("Credentials: {e}."))),
133
        };
134
        let row = db::repos::create(&app.db, &name.owner, &name.name, f.description.trim(), visibility)
135
            .await
136
            .map_err(|e| Error::from_db(shell.clone(), e))?;
137
        if let Err(e) = crate::storage::create(&app, &name, row.id, url, credentials).await {
138
            db::repos::delete(&app.db, row.id).await.ok();
139
            return Ok(fail(&format!("The bucket did not pass the check, so nothing was created: {e}")));
140
        }
141
        accounts::audit(
142
            &app.db,
143
            Some(&me.account),
144
            "repo.created",
145
            &name.to_string(),
146
            &format!("{} in {}", visibility.as_str(), parsed.plain()),
147
        )
148
        .await
149
        .ok();
150
        return Ok(Redirect::to(&name.url()).into_response());
151
    }
152
    app.repos.create(&name, None).map_err(|e| Error::from_repo(shell.clone(), e))?;
153
    db::repos::create(&app.db, &name.owner, &name.name, f.description.trim(), visibility)
154
        .await
155
        .map_err(|e| Error::from_db(shell.clone(), e))?;
156
    accounts::audit(&app.db, Some(&me.account), "repo.created", &name.to_string(), visibility.as_str()).await.ok();
157
    Ok(Redirect::to(&name.url()).into_response())
158
}
159
160
#[derive(Template)]
161
#[template(path = "repo_settings.html")]
162
pub struct RepoSettingsPage {
163
    shell: Shell,
164
    repo: RepoShell,
165
    row: db::repos::RepoRow,
166
    collaborators: Vec<accounts::Collaborator>,
167
    teams: Vec<accounts::Team>,
168
    role: Role,
169
    requirements: db::proposals::Requirements,
170
    hooks: Vec<super::webhooks::HookRow>,
171
    required_checks: String,
172
    /// Whether hub.toml alone would run Flow here, and whether it runs.
173
    flow_default: bool,
174
    flow_enabled: bool,
175
    site_admin: bool,
176
    notice: Option<String>,
177
    error: Option<String>,
178
    /// Runners that may take this repository's jobs: (runner, what it
179
    /// serves, whether it is this repository's own).
180
    runners: Vec<(db::runners::Runner, String, bool)>,
181
    /// A registration token just made, shown once.
182
    runner_token: Option<String>,
183
    /// The repository's AI assistants and prompt (#97).
184
    assistants: super::assistants::Panel,
185
    /// The repository's Flow variables (#102).
186
    variables: super::variables::Panel,
187
    /// The repository's Flow secrets (#107).
188
    secrets: super::secrets::Panel,
189
    /// Where its data lives, when in a bucket (oxygenhub#96).
190
    storage: Option<crate::storage::Storage>,
191
}
192
193
async fn settings_page(
194
    app: &Shared,
195
    shell: Shell,
196
    row: db::repos::RepoRow,
197
    role: Role,
198
    notice: Option<String>,
199
    error: Option<String>,
200
) -> Result<Page<RepoSettingsPage>, Error> {
201
    let collaborators = accounts::collaborators(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
202
    let teams = match accounts::org_by_name(&app.db, &row.owner).await.map_err(|e| Error::from_db(shell.clone(), e))? {
203
        Some(org) => accounts::teams(&app.db, org.id).await.map_err(|e| Error::from_db(shell.clone(), e))?,
204
        None => vec![],
205
    };
206
    let repo = RepoShell::new(app, &row, "settings").with_role(role);
207
    let requirements = db::proposals::requirements(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
208
    let hooks = db::hooks::hooks_for_repo(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
209
    let hooks = super::webhooks::rows(app, hooks).await.map_err(|e| Error::from_db(shell.clone(), e))?;
210
    let required_checks = db::hooks::required_checks(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?.join(", ");
211
    let flow_default = app.config.flow.allows(&row.owner, &row.name);
212
    let flow_enabled = crate::flow::enabled(app, &row);
213
    let site_admin = shell.is_admin;
214
    let runners = db::runners::serving(&app.db, &row.owner, row.id)
215
        .await
216
        .map_err(|e| Error::from_db(shell.clone(), e))?
217
        .into_iter()
218
        .map(|r| {
219
            let own = r.scope_repo_id == Some(row.id);
220
            let serves = if own {
221
                "this repository".to_string()
222
            } else if r.scope_owner.is_empty() {
223
                "the whole site".to_string()
224
            } else {
225
                format!("{}'s repositories", r.scope_owner)
226
            };
227
            (r, serves, own)
228
        })
229
        .collect();
230
    let assistants = super::assistants::panel(app, &repo_assistants(&row)).await.map_err(|e| Error::from_db(shell.clone(), e))?;
231
    let variables = super::variables::panel(app, &repo_assistants(&row)).await.map_err(|e| Error::from_db(shell.clone(), e))?;
232
    let secrets = super::secrets::panel(app, &repo_assistants(&row)).await.map_err(|e| Error::from_db(shell.clone(), e))?;
233
    let storage = crate::storage::of(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
234
    Ok(Page(RepoSettingsPage {
235
        storage,
236
        assistants,
237
        variables,
238
        secrets,
239
        runners,
240
        runner_token: None,
241
        shell,
242
        repo,
243
        row,
244
        collaborators,
245
        teams,
246
        role,
247
        requirements,
248
        hooks,
249
        required_checks,
250
        flow_default,
251
        flow_enabled,
252
        site_admin,
253
        notice,
254
        error,
255
    }))
256
}
257
258
pub async fn settings(
259
    State(app): State<Shared>,
260
    viewer: Viewer,
261
    Path((owner, name)): Path<(String, String)>,
262
) -> Result<Page<RepoSettingsPage>, Error> {
263
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
264
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?;
265
    settings_page(&app, shell, row, role, None, None).await
266
}
267
268
#[derive(Deserialize)]
269
pub struct GeneralForm {
270
    #[serde(rename = "_csrf")]
271
    csrf_token: String,
272
    description: String,
273
    default_bookmark: String,
274
    visibility: String,
275
    #[serde(default)]
276
    topics: String,
277
}
278
279
pub async fn update(
280
    State(app): State<Shared>,
281
    viewer: Viewer,
282
    Path((owner, name)): Path<(String, String)>,
283
    Form(f): Form<GeneralForm>,
284
) -> Result<Page<RepoSettingsPage>, Error> {
285
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
286
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?;
287
    csrf(&viewer, &f.csrf_token, &shell)?;
288
    let e = |e| Error::from_db(shell.clone(), e);
289
    let topics = match db::repos::parse_topics(&f.topics) {
290
        Ok(t) => t,
291
        Err(msg) => return settings_page(&app, shell, row, role, None, Some(msg)).await,
292
    };
293
    db::repos::set_description(&app.db, row.id, f.description.trim()).await.map_err(e)?;
294
    db::repos::set_topics(&app.db, row.id, &topics).await.map_err(e)?;
295
    if crate::repos::names::valid_segment(f.default_bookmark.trim()) {
296
        db::repos::set_default_bookmark(&app.db, row.id, f.default_bookmark.trim()).await.map_err(e)?;
297
    }
298
    if role >= Role::Admin {
299
        if let Some(v) = Visibility::parse(&f.visibility) {
300
            db::repos::set_visibility(&app.db, row.id, v).await.map_err(e)?;
301
        }
302
    }
303
    accounts::audit(&app.db, viewer.account(), "repo.updated", &format!("{owner}/{name}"), "").await.ok();
304
    let row = db::repos::get_by_id(&app.db, row.id).await.map_err(e)?.unwrap_or(row);
305
    settings_page(&app, shell, row, role, Some("Saved.".into()), None).await
306
}
307
308
#[derive(Deserialize)]
309
pub struct CollaboratorForm {
310
    #[serde(rename = "_csrf")]
311
    csrf_token: String,
312
    #[serde(default)]
313
    username: String,
314
    #[serde(default)]
315
    team: String,
316
    #[serde(default)]
317
    role: String,
318
    #[serde(default)]
319
    remove: Option<String>,
320
}
321
322
pub async fn collaborator(
323
    State(app): State<Shared>,
324
    viewer: Viewer,
325
    Path((owner, name)): Path<(String, String)>,
326
    Form(f): Form<CollaboratorForm>,
327
) -> Result<Page<RepoSettingsPage>, Error> {
328
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
329
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
330
    csrf(&viewer, &f.csrf_token, &shell)?;
331
    let e = |e| Error::from_db(shell.clone(), e);
332
    let (account_id, team_id, label) = if !f.username.trim().is_empty() {
333
        match accounts::account_by_name(&app.db, f.username.trim()).await.map_err(e)? {
334
            Some(a) => (Some(a.id), None, a.username),
335
            None => return settings_page(&app, shell, row, role, None, Some("No such account.".into())).await,
336
        }
337
    } else if !f.team.trim().is_empty() {
338
        let org = accounts::org_by_name(&app.db, &row.owner).await.map_err(e)?;
339
        let team = match org {
340
            Some(o) => accounts::team_by_name(&app.db, o.id, f.team.trim()).await.map_err(e)?,
341
            None => None,
342
        };
343
        match team {
344
            Some(t) => (None, Some(t.id), format!("team {}", t.name)),
345
            None => return settings_page(&app, shell, row, role, None, Some("No such team in this organisation.".into())).await,
346
        }
347
    } else {
348
        return settings_page(&app, shell, row, role, None, Some("Name an account or a team.".into())).await;
349
    };
350
    if f.remove.is_some() {
351
        accounts::remove_collaborator(&app.db, row.id, account_id, team_id).await.map_err(e)?;
352
        accounts::audit(&app.db, viewer.account(), "repo.collaborator.removed", &format!("{owner}/{name}"), &label).await.ok();
353
        return settings_page(&app, shell, row, role, Some(format!("Removed {label}.")), None).await;
354
    }
355
    let Some(new_role) = Role::parse(&f.role) else {
356
        return settings_page(&app, shell, row, role, None, Some("Pick a role.".into())).await;
357
    };
358
    accounts::set_collaborator(&app.db, row.id, account_id, team_id, new_role.as_str()).await.map_err(e)?;
359
    accounts::audit(
360
        &app.db,
361
        viewer.account(),
362
        "repo.collaborator.set",
363
        &format!("{owner}/{name}"),
364
        &format!("{label} {}", new_role.as_str()),
365
    )
366
    .await
367
    .ok();
368
    settings_page(&app, shell, row, role, Some(format!("{label} now has {} access.", new_role.as_str())), None).await
369
}
370
371
#[derive(Deserialize)]
372
pub struct TransferForm {
373
    #[serde(rename = "_csrf")]
374
    csrf_token: String,
375
    owner: String,
376
    confirm: String,
377
}
378
379
/// `POST /{owner}/{name}/settings/transfer`: move the repository to a
380
/// user or organisation the admin may create repositories under (#108).
381
/// The old URL redirects and oxy remotes keep working.
382
pub async fn transfer(
383
    State(app): State<Shared>,
384
    viewer: Viewer,
385
    Path((owner, name)): Path<(String, String)>,
386
    Form(f): Form<TransferForm>,
387
) -> Result<Response, Error> {
388
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
389
    let (repo, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
390
    csrf(&viewer, &f.csrf_token, &shell)?;
391
    let me = viewer.account().cloned().ok_or_else(|| Error::not_found(shell.clone()))?;
392
    let fail = |msg: &str| settings_page(&app, shell.clone(), row.clone(), role, None, Some(msg.into()));
393
    if f.confirm.trim() != repo.to_string() {
394
        return Ok(fail("Type the repository's full name to confirm.").await?.into_response());
395
    }
396
    let to = f.owner.trim().trim_start_matches('@').to_string();
397
    let Some(dest) = RepoName::new(&to, &row.name) else {
398
        return Ok(fail("That is not an owner name.").await?.into_response());
399
    };
400
    if dest.owner == row.owner {
401
        return Ok(fail("The repository is already there.").await?.into_response());
402
    }
403
    let e = |e| Error::from_db(shell.clone(), e);
404
    let known = accounts::account_by_name(&app.db, &dest.owner).await.map_err(e)?.is_some()
405
        || accounts::org_by_name(&app.db, &dest.owner).await.map_err(e)?.is_some();
406
    if !known {
407
        return Ok(fail("There is no user or organisation of that name.").await?.into_response());
408
    }
409
    if !roles::may_create_under(&app.db, &me, &dest.owner).await.map_err(e)? {
410
        return Ok(fail("You cannot create repositories under that owner, so you cannot move one there.").await?.into_response());
411
    }
412
    if db::repos::get(&app.db, &dest.owner, &dest.name).await.map_err(e)?.is_some() || app.repos.exists(&dest) {
413
        return Ok(fail("That owner already has a repository of this name.").await?.into_response());
414
    }
415
    {
416
        let _guard = app.repos.write_guard(&repo).await;
417
        app.repos.rename(&repo, &dest).map_err(|e| Error::from_repo(shell.clone(), e))?;
418
        crate::storage::renamed(&app, &repo, &dest);
419
        if app.wikis.exists(&repo) {
420
            app.wikis.rename(&repo, &dest).ok();
421
        }
422
        db::repos::transfer(&app.db, row.id, &row.owner, &row.name, &dest.owner).await.map_err(e)?;
423
        let mirror = crate::mirror::mirror_dir(&app, &repo);
424
        if mirror.is_dir() {
425
            let to = crate::mirror::mirror_dir(&app, &dest);
426
            if let Some(parent) = to.parent() {
427
                std::fs::create_dir_all(parent).ok();
428
            }
429
            std::fs::rename(&mirror, &to).ok();
430
        }
431
    }
432
    accounts::audit(&app.db, Some(&me), "repo.transferred", &repo.to_string(), &dest.to_string()).await.ok();
433
    let notice = super::settings::urlencode(&format!("Moved from {repo}; the old address redirects here."));
434
    Ok(Redirect::to(&format!("{}/settings?notice={notice}", dest.url())).into_response())
435
}
436
437
#[derive(Deserialize)]
438
pub struct ArchiveForm {
439
    #[serde(rename = "_csrf")]
440
    csrf_token: String,
441
    /// `archive` or `unarchive`.
442
    action: String,
443
    #[serde(default)]
444
    reason: String,
445
}
446
447
/// `POST /{owner}/{name}/settings/archive`: read-only, with a reason, or
448
/// back again (#108).
449
pub async fn archive(
450
    State(app): State<Shared>,
451
    viewer: Viewer,
452
    Path((owner, name)): Path<(String, String)>,
453
    Form(f): Form<ArchiveForm>,
454
) -> Result<Page<RepoSettingsPage>, Error> {
455
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
456
    let (repo, mut row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
457
    csrf(&viewer, &f.csrf_token, &shell)?;
458
    let archive = match f.action.as_str() {
459
        "archive" => true,
460
        "unarchive" => false,
461
        _ => return settings_page(&app, shell, row, role, None, Some("Unknown action.".into())).await,
462
    };
463
    let reason: String = f.reason.trim().chars().take(500).collect();
464
    db::repos::set_archived(&app.db, row.id, archive, &reason).await.map_err(|e| Error::from_db(shell.clone(), e))?;
465
    accounts::audit(&app.db, viewer.account(), if archive { "repo.archived" } else { "repo.unarchived" }, &repo.to_string(), &reason)
466
        .await
467
        .ok();
468
    row.archived = archive;
469
    row.archived_reason = if archive { reason } else { String::new() };
470
    let notice = if archive {
471
        "The repository is archived: read-only until it is brought back."
472
    } else {
473
        "The repository is back: writes are allowed again."
474
    };
475
    settings_page(&app, shell, row, role, Some(notice.into()), None).await
476
}
477
478
/// `POST /{owner}/{name}/settings/wiki/delete`: the wiki to the trash (#104).
479
pub async fn wiki_delete(
480
    State(app): State<Shared>,
481
    viewer: Viewer,
482
    Path((owner, name)): Path<(String, String)>,
483
    Form(f): Form<DeleteForm>,
484
) -> Result<Page<RepoSettingsPage>, Error> {
485
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
486
    let (repo, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
487
    csrf(&viewer, &f.csrf_token, &shell)?;
488
    if f.confirm.trim() != repo.to_string() {
489
        return settings_page(&app, shell, row, role, None, Some("Type the repository's full name to confirm.".into())).await;
490
    }
491
    if !crate::wiki::exists(&app, &repo) {
492
        return settings_page(&app, shell, row, role, None, Some("This repository has no wiki.".into())).await;
493
    }
494
    let _guard = app.wikis.write_guard(&repo).await;
495
    crate::wiki::trash(&app, &repo).map_err(|e| Error::from_repo(shell.clone(), e))?;
496
    drop(_guard);
497
    accounts::audit(&app.db, viewer.account(), "wiki.data_deleted", &repo.to_string(), "moved to trash").await.ok();
498
    settings_page(&app, shell, row, role, Some("The wiki is in the trash; a new first page starts a fresh one.".into()), None).await
499
}
500
501
#[derive(Deserialize)]
502
pub struct DeleteForm {
503
    #[serde(rename = "_csrf")]
504
    csrf_token: String,
505
    confirm: String,
506
}
507
508
pub async fn delete(
509
    State(app): State<Shared>,
510
    viewer: Viewer,
511
    Path((owner, name)): Path<(String, String)>,
512
    Form(f): Form<DeleteForm>,
513
) -> Result<Response, Error> {
514
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
515
    let (repo, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
516
    csrf(&viewer, &f.csrf_token, &shell)?;
517
    if f.confirm.trim() != repo.to_string() {
518
        return Ok(settings_page(&app, shell, row, role, None, Some("Type the repository's full name to delete it.".into()))
519
            .await?
520
            .into_response());
521
    }
522
    let _guard = app.repos.write_guard(&repo).await;
523
    app.repos.trash(&repo).map_err(|e| Error::from_repo(shell.clone(), e))?;
524
    // A repository kept in a bucket leaves its data there: the owner's.
525
    crate::storage::removed(&app, &repo);
526
    crate::wiki::trash(&app, &repo).ok();
527
    db::repos::delete(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
528
    crate::assistants::delete_scope(&app.db, crate::levels::Scope::Repo(row.id)).await.ok();
529
    crate::variables::delete_scope(&app.db, crate::levels::Scope::Repo(row.id)).await.ok();
530
    crate::secrets::delete_scope(&app.db, crate::levels::Scope::Repo(row.id)).await.ok();
531
    accounts::audit(&app.db, viewer.account(), "repo.deleted", &repo.to_string(), "moved to trash").await.ok();
532
    Ok(Redirect::to(&format!("/{owner}")).into_response())
533
}
534
535
#[derive(Deserialize)]
536
pub struct RequirementsForm {
537
    #[serde(rename = "_csrf")]
538
    csrf_token: String,
539
    #[serde(default)]
540
    required_approvals: i64,
541
    #[serde(default)]
542
    require_owners: Option<String>,
543
    #[serde(default)]
544
    allow_conflicts: Option<String>,
545
}
546
547
pub async fn requirements(
548
    State(app): State<Shared>,
549
    viewer: Viewer,
550
    Path((owner, name)): Path<(String, String)>,
551
    Form(f): Form<RequirementsForm>,
552
) -> Result<Page<RepoSettingsPage>, Error> {
553
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
554
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?;
555
    csrf(&viewer, &f.csrf_token, &shell)?;
556
    let r = db::proposals::Requirements {
557
        required_approvals: f.required_approvals.max(0),
558
        require_owners: f.require_owners.is_some(),
559
        allow_conflicts: f.allow_conflicts.is_some(),
560
    };
561
    db::proposals::set_requirements(&app.db, row.id, r).await.map_err(|e| Error::from_db(shell.clone(), e))?;
562
    accounts::audit(
563
        &app.db,
564
        viewer.account(),
565
        "repo.requirements",
566
        &format!("{owner}/{name}"),
567
        &format!("{} approvals, owners {}, conflicts {}", r.required_approvals, r.require_owners, r.allow_conflicts),
568
    )
569
    .await
570
    .ok();
571
    settings_page(&app, shell, row, role, Some("Landing requirements saved.".into()), None).await
572
}
573
574
pub async fn hooks(
575
    State(app): State<Shared>,
576
    viewer: Viewer,
577
    Path((owner, name)): Path<(String, String)>,
578
    Form(f): Form<super::webhooks::HookForm>,
579
) -> Result<Page<RepoSettingsPage>, Error> {
580
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
581
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
582
    csrf(&viewer, &f.csrf_token, &shell)?;
583
    let scope = super::webhooks::Scope::Repo { id: row.id, slug: format!("{owner}/{name}") };
584
    match super::webhooks::apply(&app, &viewer, &scope, f).await.map_err(|e| Error::from_db(shell.clone(), e))? {
585
        Ok(notice) => settings_page(&app, shell, row, role, Some(notice), None).await,
586
        Err(error) => settings_page(&app, shell, row, role, None, Some(error)).await,
587
    }
588
}
589
590
pub async fn deliveries(
591
    State(app): State<Shared>,
592
    viewer: Viewer,
593
    Path((owner, name, id)): Path<(String, String, i64)>,
594
) -> Result<Page<super::webhooks::DeliveriesPage>, Error> {
595
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings/hooks/{id}/deliveries"), &viewer);
596
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
597
    let scope = super::webhooks::Scope::Repo { id: row.id, slug: format!("{owner}/{name}") };
598
    super::webhooks::deliveries_page(&app, shell, &scope, Some(RepoShell::new(&app, &row, "settings").with_role(role)), id).await
599
}
600
601
pub async fn redeliver(
602
    State(app): State<Shared>,
603
    viewer: Viewer,
604
    Path((owner, name, id, delivery)): Path<(String, String, i64, i64)>,
605
    Form(f): Form<super::session::CsrfForm>,
606
) -> Result<Page<super::webhooks::DeliveriesPage>, Error> {
607
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings/hooks/{id}/deliveries"), &viewer);
608
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
609
    csrf(&viewer, &f.csrf, &shell)?;
610
    let scope = super::webhooks::Scope::Repo { id: row.id, slug: format!("{owner}/{name}") };
611
    super::webhooks::redeliver(&app, &scope, id, delivery).await.map_err(|e| Error::from_db(shell.clone(), e))?;
612
    super::webhooks::deliveries_page(&app, shell, &scope, Some(RepoShell::new(&app, &row, "settings").with_role(role)), id).await
613
}
614
615
#[derive(Deserialize)]
616
pub struct ChecksForm {
617
    #[serde(rename = "_csrf")]
618
    csrf_token: String,
619
    #[serde(default)]
620
    required_checks: String,
621
}
622
623
pub async fn required_checks(
624
    State(app): State<Shared>,
625
    viewer: Viewer,
626
    Path((owner, name)): Path<(String, String)>,
627
    Form(f): Form<ChecksForm>,
628
) -> Result<Page<RepoSettingsPage>, Error> {
629
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
630
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?;
631
    csrf(&viewer, &f.csrf_token, &shell)?;
632
    let names: Vec<String> = f.required_checks.split(',').map(str::trim).filter(|s| !s.is_empty()).map(String::from).collect();
633
    db::hooks::set_required_checks(&app.db, row.id, &names).await.map_err(|e| Error::from_db(shell.clone(), e))?;
634
    settings_page(&app, shell, row, role, Some("Required checks saved.".into()), None).await
635
}
636
637
#[derive(Deserialize)]
638
pub struct StorageForm {
639
    #[serde(rename = "_csrf")]
640
    csrf_token: String,
641
    /// `check`, or `credentials` (with the new ones).
642
    action: String,
643
    #[serde(flatten)]
644
    bucket: BucketForm,
645
}
646
647
/// Settings → Storage (oxygenhub#96): check the bucket again, or replace
648
/// its credentials once the new ones pass the check.
649
pub async fn storage(
650
    State(app): State<Shared>,
651
    viewer: Viewer,
652
    Path((owner, name)): Path<(String, String)>,
653
    Form(f): Form<StorageForm>,
654
) -> Result<Page<RepoSettingsPage>, Error> {
655
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
656
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
657
    csrf(&viewer, &f.csrf_token, &shell)?;
658
    let Some(s) = crate::storage::of(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))? else {
659
        return settings_page(&app, shell, row, role, None, Some("This repository is kept on this server's disk.".into())).await;
660
    };
661
    let scheme = s.url.split("://").next().unwrap_or("").to_string();
662
    let outcome = match f.action.as_str() {
663
        "credentials" => match f.bucket.credentials(&scheme) {
664
            Ok(c) => crate::storage::set_credentials(&app, &s, c).await.map(|r| format!("New credentials saved: {r}.")),
665
            Err(e) => Err(format!("Credentials: {e}")),
666
        },
667
        _ => crate::storage::check(&app, &s).await.map(|r| format!("The bucket passed the check: {r}.")),
668
    };
669
    match outcome {
670
        Ok(notice) => {
671
            accounts::audit(&app.db, viewer.account(), "repo.storage", &format!("{owner}/{name}"), &f.action).await.ok();
672
            settings_page(&app, shell, row, role, Some(notice), None).await
673
        }
674
        Err(e) => settings_page(&app, shell, row, role, None, Some(format!("Storage: {e}"))).await,
675
    }
676
}
677
678
#[derive(Deserialize)]
679
pub struct MirrorForm {
680
    #[serde(rename = "_csrf")]
681
    csrf_token: String,
682
    #[serde(default)]
683
    enabled: Option<String>,
684
}
685
686
#[derive(Deserialize)]
687
pub struct FlowForm {
688
    #[serde(rename = "_csrf")]
689
    csrf_token: String,
690
    /// `on`, `off`, or `default`.
691
    flow: String,
692
}
693
694
/// Turn OxygenFlow on or off for one repository. Runs use the site's
695
/// runners, so only site administrators decide.
696
pub async fn flow(
697
    State(app): State<Shared>,
698
    viewer: Viewer,
699
    Path((owner, name)): Path<(String, String)>,
700
    Form(f): Form<FlowForm>,
701
) -> Result<Page<RepoSettingsPage>, Error> {
702
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
703
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?;
704
    csrf(&viewer, &f.csrf_token, &shell)?;
705
    if !viewer.is_admin() {
706
        return settings_page(&app, shell, row, role, None, Some("Only site administrators turn OxygenFlow on or off.".into())).await;
707
    }
708
    let setting = match f.flow.as_str() {
709
        "on" => "on",
710
        "off" => "off",
711
        "default" => "",
712
        _ => return settings_page(&app, shell, row, role, None, Some("Pick on, off or the site default.".into())).await,
713
    };
714
    db::repos::set_flow(&app.db, row.id, setting).await.map_err(|e| Error::from_db(shell.clone(), e))?;
715
    let label = if setting.is_empty() { "default" } else { setting };
716
    accounts::audit(&app.db, viewer.account(), "repo.flow", &format!("{owner}/{name}"), label).await.ok();
717
    let row = db::repos::get_by_id(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?.unwrap_or(row);
718
    let notice = if crate::flow::enabled(&app, &row) {
719
        "OxygenFlow is on: pushes with a .flow/pipeline.kdl start runs."
720
    } else {
721
        "OxygenFlow is off for this repository."
722
    };
723
    settings_page(&app, shell, row, role, Some(notice.into()), None).await
724
}
725
726
pub async fn mirror(
727
    State(app): State<Shared>,
728
    viewer: Viewer,
729
    Path((owner, name)): Path<(String, String)>,
730
    Form(f): Form<MirrorForm>,
731
) -> Result<Page<RepoSettingsPage>, Error> {
732
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
733
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Maintain).await?;
734
    csrf(&viewer, &f.csrf_token, &shell)?;
735
    db::repos::set_git_mirror(&app.db, row.id, f.enabled.is_some()).await.map_err(|e| Error::from_db(shell.clone(), e))?;
736
    let row = db::repos::get_by_id(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?.unwrap_or(row);
737
    if row.git_mirror {
738
        crate::mirror::refresh(&app, &row).await;
739
    }
740
    accounts::audit(&app.db, viewer.account(), "repo.mirror", &format!("{owner}/{name}"), if row.git_mirror { "on" } else { "off" })
741
        .await
742
        .ok();
743
    let row = db::repos::get_by_id(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?.unwrap_or(row);
744
    let notice = if row.git_mirror { "The Git mirror is on and up to date." } else { "The Git mirror is off." };
745
    settings_page(&app, shell, row, role, Some(notice.into()), None).await
746
}
747
748
/// `POST /{owner}/{name}/settings/runners/token`: a one-time registration
749
/// token for a runner that serves this repository only (oxygenhub#41).
750
pub async fn runner_token(
751
    State(app): State<Shared>,
752
    viewer: Viewer,
753
    Path((owner, name)): Path<(String, String)>,
754
    Form(f): Form<super::session::CsrfForm>,
755
) -> Result<Page<RepoSettingsPage>, Error> {
756
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
757
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
758
    csrf(&viewer, &f.csrf, &shell)?;
759
    let me = viewer.account().map(|a| a.username.clone()).unwrap_or_default();
760
    let token = format!("flowreg_{}", crate::auth::random_hex(24));
761
    let scope = db::runners::Scope { owner: row.owner.clone(), repo_id: Some(row.id) };
762
    db::runners::add_registration(&app.db, &blake3::hash(token.as_bytes()).to_hex(), &me, &scope)
763
        .await
764
        .map_err(|e| Error::from_db(shell.clone(), e))?;
765
    accounts::audit(&app.db, viewer.account(), "flow.runner.token", &row.slug(), "registration token for this repository").await.ok();
766
    let mut page = settings_page(&app, shell, row, role, Some("Copy the token now; it is not shown again.".into()), None).await?;
767
    page.0.runner_token = Some(token);
768
    Ok(page)
769
}
770
771
/// `POST /{owner}/{name}/settings/runners/{id}/remove`: remove one of this
772
/// repository's own runners, when it is running nothing.
773
pub async fn runner_remove(
774
    State(app): State<Shared>,
775
    viewer: Viewer,
776
    Path((owner, name, id)): Path<(String, String, i64)>,
777
    Form(f): Form<super::session::CsrfForm>,
778
) -> Result<Page<RepoSettingsPage>, Error> {
779
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
780
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
781
    csrf(&viewer, &f.csrf, &shell)?;
782
    let e = |e| Error::from_db(shell.clone(), e);
783
    let Some(r) = db::runners::get(&app.db, id).await.map_err(e)?.filter(|r| r.scope_repo_id == Some(row.id)) else {
784
        return Err(Error::not_found(shell));
785
    };
786
    if db::runners::running(&app.db).await.map_err(e)?.iter().any(|(rid, n)| *rid == id && *n > 0) {
787
        return settings_page(&app, shell, row, role, None, Some(format!("{} is running jobs: wait for them to finish.", r.name))).await;
788
    }
789
    db::runners::remove(&app.db, id).await.map_err(e)?;
790
    accounts::audit(&app.db, viewer.account(), "flow.runner.removed", &r.name, &row.slug()).await.ok();
791
    settings_page(&app, shell, row, role, Some(format!("{} removed: its credential no longer works.", r.name)), None).await
792
}
793
794
fn repo_assistants(row: &db::repos::RepoRow) -> crate::levels::At {
795
    crate::levels::At::repo(row)
796
}
797
798
/// `POST /{owner}/{name}/settings/assistants`: the repository's assistants
799
/// and prompt (#97), for its admins.
800
pub async fn assistants(
801
    State(app): State<Shared>,
802
    viewer: Viewer,
803
    Path((owner, name)): Path<(String, String)>,
804
    Form(f): Form<super::assistants::AssistantForm>,
805
) -> Result<Page<RepoSettingsPage>, Error> {
806
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
807
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
808
    csrf(&viewer, &f.csrf_token, &shell)?;
809
    match super::assistants::apply(&app, &viewer, &repo_assistants(&row), f).await.map_err(|e| Error::from_db(shell.clone(), e))? {
810
        Ok(notice) => settings_page(&app, shell, row, role, Some(notice), None).await,
811
        Err(error) => settings_page(&app, shell, row, role, None, Some(error)).await,
812
    }
813
}
814
815
/// `POST /{owner}/{name}/settings/variables`: the repository's Flow
816
/// variables (#102), for its admins.
817
pub async fn variables(
818
    State(app): State<Shared>,
819
    viewer: Viewer,
820
    Path((owner, name)): Path<(String, String)>,
821
    Form(f): Form<super::variables::VariableForm>,
822
) -> Result<Page<RepoSettingsPage>, Error> {
823
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
824
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
825
    csrf(&viewer, &f.csrf_token, &shell)?;
826
    match super::variables::apply(&app, &viewer, &repo_assistants(&row), f).await.map_err(|e| Error::from_db(shell.clone(), e))? {
827
        Ok(notice) => settings_page(&app, shell, row, role, Some(notice), None).await,
828
        Err(error) => settings_page(&app, shell, row, role, None, Some(error)).await,
829
    }
830
}
831
832
/// `POST /{owner}/{name}/settings/secrets`: the repository's Flow secrets
833
/// (#107), for its admins.
834
pub async fn secrets(
835
    State(app): State<Shared>,
836
    viewer: Viewer,
837
    Path((owner, name)): Path<(String, String)>,
838
    Form(f): Form<super::secrets::SecretForm>,
839
) -> Result<Page<RepoSettingsPage>, Error> {
840
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
841
    let (_, row, role) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
842
    csrf(&viewer, &f.csrf_token, &shell)?;
843
    match super::secrets::apply(&app, &viewer, &repo_assistants(&row), f).await.map_err(|e| Error::from_db(shell.clone(), e))? {
844
        Ok(notice) => settings_page(&app, shell, row, role, Some(notice), None).await,
845
        Err(error) => settings_page(&app, shell, row, role, None, Some(error)).await,
846
    }
847
}
848
849
/// `POST /{owner}/{name}/settings/assistants/models`: what a provider offers (#109).
850
pub async fn assistant_models(
851
    State(app): State<Shared>,
852
    viewer: Viewer,
853
    Path((owner, name)): Path<(String, String)>,
854
    Form(f): Form<super::assistants::ModelsForm>,
855
) -> Result<axum::Json<serde_json::Value>, Error> {
856
    let shell = Shell::new(&app, &format!("/{owner}/{name}/settings"), &viewer);
857
    let (_, row, _) = lookup_role(&app, &shell, &viewer, &owner, &name, Access::Admin).await?;
858
    csrf(&viewer, &f.csrf_token, &shell)?;
859
    Ok(axum::Json(super::assistants::models(&app, &repo_assistants(&row), f).await.map_err(|e| Error::from_db(shell.clone(), e))?))
860
}