OXYGENHUB
# 38833ed78707 oxygenhub / crates / hub / src / web / issues.rs
38.1 KiB · Rust · last changed Name the kind of every number; show the issue -> proposal -> bookmark chain 1 month ago source blame history raw
1
//! Issues, labels and milestones (hub spec §8).
2
3
use super::settings::{csrf, require};
4
use super::{filters, lookup, lookup_role, Error, Page, RepoShell, Shell};
5
use crate::auth::{Access, Role, Viewer};
6
use crate::db::{self, accounts, issues as idb, notify as ndb};
7
use crate::notify::{self, Event};
8
use crate::render::{self, refs::Numbers};
9
use crate::repos::view;
10
use crate::Shared;
11
use askama::Template;
12
use axum::extract::{Form, Path, Query, State};
13
use axum::response::{IntoResponse, Redirect, Response};
14
use serde::Deserialize;
15
use std::collections::HashMap;
16
17
/// Markdown with cross references linked, for a repository; relative
18
/// links and images resolve against `reference` (the default bookmark for
19
/// issues and proposals, the tag for release notes).
20
pub async fn markdown(app: &Shared, row: &db::repos::RepoRow, reference: &str, text: &str) -> String {
21
    let repo_url = format!("/{}", row.slug());
22
    let (issues, proposals) = idb::numbers(&app.db, row.id).await.unwrap_or_default();
23
    let linked = render::refs::link(text, &Numbers { repo_url: &repo_url, issues: &issues, proposals: &proposals });
24
    render::markdown::render(&linked, &format!("{repo_url}/file/{reference}/"), &format!("{repo_url}/raw/{reference}/"))
25
}
26
27
/// Re-index a thread for search: title, body and every comment.
28
pub async fn reindex(app: &Shared, repo_id: i64, issue: &idb::IssueRow) {
29
    let comments = idb::comments(&app.db, issue.id).await.unwrap_or_default();
30
    let text = std::iter::once(issue.body.clone()).chain(comments.into_iter().map(|c| c.body)).collect::<Vec<_>>().join("\n\n");
31
    ndb::index(&app.db, "issue", repo_id, issue.id, issue.number, &issue.title, &text).await.ok();
32
}
33
34
// ------------------------------------------------------------------ list
35
36
pub struct IssueLine {
37
    pub issue: idb::IssueRow,
38
    pub labels: Vec<idb::Label>,
39
    pub assignees: Vec<String>,
40
    pub milestone: Option<String>,
41
    pub comments: i64,
42
}
43
44
#[derive(Template)]
45
#[template(path = "issues.html")]
46
pub struct IssuesPage {
47
    shell: Shell,
48
    repo: RepoShell,
49
    rows: Vec<IssueLine>,
50
    state: String,
51
    q: String,
52
    counts: (usize, usize),
53
    sort: String,
54
    pager: super::Pager,
55
}
56
57
#[derive(Deserialize)]
58
pub struct ListQuery {
59
    state: Option<String>,
60
    q: Option<String>,
61
    sort: Option<String>,
62
    page: Option<usize>,
63
}
64
65
/// The list's sort orders: `newest` (pinned first, the default),
66
/// `oldest`, `updated`, `comments`.
67
pub const SORTS: &[(&str, &str)] =
68
    &[("newest", "newest"), ("oldest", "oldest"), ("updated", "recently updated"), ("comments", "most comments")];
69
70
/// `label:bug assignee:andy milestone:v1 state:closed words…`
71
struct Filter {
72
    state: String,
73
    labels: Vec<String>,
74
    assignees: Vec<String>,
75
    authors: Vec<String>,
76
    milestone: Option<String>,
77
    words: Vec<String>,
78
}
79
80
fn parse_filter(state: Option<String>, q: &str) -> Filter {
81
    let mut f = Filter {
82
        state: state.unwrap_or_else(|| "open".into()),
83
        labels: vec![],
84
        assignees: vec![],
85
        authors: vec![],
86
        milestone: None,
87
        words: vec![],
88
    };
89
    for tok in q.split_whitespace() {
90
        match tok.split_once(':') {
91
            Some(("label", v)) => f.labels.push(v.to_lowercase()),
92
            Some(("assignee", v)) => f.assignees.push(v.to_lowercase()),
93
            Some(("author", v)) => f.authors.push(v.to_lowercase()),
94
            Some(("milestone", v)) => f.milestone = Some(v.to_lowercase()),
95
            Some(("state", v)) => f.state = v.to_string(),
96
            _ => f.words.push(tok.to_lowercase()),
97
        }
98
    }
99
    f
100
}
101
102
pub async fn list(
103
    State(app): State<Shared>,
104
    viewer: Viewer,
105
    Path((owner, name)): Path<(String, String)>,
106
    Query(q): Query<ListQuery>,
107
) -> Result<Page<IssuesPage>, Error> {
108
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issues"), &viewer);
109
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
110
    let e = |e| Error::from_db(shell.clone(), e);
111
    let all = idb::list(&app.db, row.id).await.map_err(e)?;
112
    let counts = (all.iter().filter(|i| i.state == "open").count(), all.iter().filter(|i| i.state == "closed").count());
113
    let qtext = q.q.clone().unwrap_or_default();
114
    let f = parse_filter(q.state, &qtext);
115
    let mut labels_by: HashMap<i64, Vec<idb::Label>> = HashMap::new();
116
    for (id, l) in idb::labels_by_issue(&app.db, row.id).await.map_err(e)? {
117
        labels_by.entry(id).or_default().push(l);
118
    }
119
    let mut assignees_by: HashMap<i64, Vec<String>> = HashMap::new();
120
    for (id, u) in idb::assignees_by_issue(&app.db, row.id).await.map_err(e)? {
121
        assignees_by.entry(id).or_default().push(u);
122
    }
123
    let milestones: HashMap<i64, String> =
124
        idb::milestones(&app.db, row.id).await.map_err(e)?.into_iter().map(|m| (m.id, m.title)).collect();
125
    let mut rows = Vec::new();
126
    for i in all {
127
        let labels = labels_by.remove(&i.id).unwrap_or_default();
128
        let assignees = assignees_by.remove(&i.id).unwrap_or_default();
129
        let milestone = i.milestone_id.and_then(|m| milestones.get(&m).cloned());
130
        let keep = (f.state == "all" || i.state == f.state)
131
            && f.labels.iter().all(|l| labels.iter().any(|x| x.name.to_lowercase() == *l))
132
            && f.assignees.iter().all(|a| assignees.iter().any(|x| x.to_lowercase() == *a))
133
            && (f.authors.is_empty() || f.authors.contains(&i.author.to_lowercase()))
134
            && f.milestone.as_ref().is_none_or(|m| milestone.as_ref().is_some_and(|x| x.to_lowercase() == *m))
135
            && f.words.iter().all(|w| i.title.to_lowercase().contains(w) || i.body.to_lowercase().contains(w));
136
        if keep {
137
            let comments: i64 = sqlx::query_scalar("SELECT COUNT(*) FROM issue_comments WHERE issue_id = ?")
138
                .bind(i.id)
139
                .fetch_one(&app.db)
140
                .await
141
                .map_err(e)?;
142
            rows.push(IssueLine { issue: i, labels, assignees, milestone, comments });
143
        }
144
    }
145
    let sort = q.sort.filter(|s| SORTS.iter().any(|(k, _)| k == s)).unwrap_or_else(|| "newest".into());
146
    match sort.as_str() {
147
        "oldest" => rows.sort_by_key(|r| r.issue.number),
148
        "updated" => rows.sort_by_key(|r| std::cmp::Reverse(r.issue.updated_ms)),
149
        "comments" => rows.sort_by_key(|r| (std::cmp::Reverse(r.comments), std::cmp::Reverse(r.issue.number))),
150
        _ => {}
151
    }
152
    let pager = super::Pager::new(rows.len(), q.page, &[("state", &f.state), ("q", &qtext), ("sort", &sort)]);
153
    let rows = pager.slice(rows);
154
    Ok(Page(IssuesPage {
155
        shell,
156
        repo: RepoShell::new(&app, &row, "issues").with_role(role),
157
        rows,
158
        state: f.state,
159
        q: qtext,
160
        counts,
161
        sort,
162
        pager,
163
    }))
164
}
165
166
// ------------------------------------------------------------------- new
167
168
#[derive(Template)]
169
#[template(path = "issue_new.html")]
170
pub struct NewIssuePage {
171
    shell: Shell,
172
    repo: RepoShell,
173
    templates: Vec<(String, String)>,
174
    template: String,
175
    error: Option<String>,
176
}
177
178
#[derive(Deserialize)]
179
pub struct NewQuery {
180
    template: Option<String>,
181
}
182
183
/// `.oxyhub/ISSUE_TEMPLATE/*.md` in the default bookmark's state.
184
async fn issue_templates(app: &Shared, repo: &crate::repos::RepoName, default: &str) -> Vec<(String, String)> {
185
    let default = default.to_string();
186
    app.repos
187
        .read(repo, move |r, cache| {
188
            let Ok(target) = view::resolve(r, cache, &default) else { return Ok(vec![]) };
189
            let loaded = cache.load(r, &target.heads)?;
190
            let mut out = Vec::new();
191
            for (path, f) in &loaded.snapshot.files {
192
                if let Some(rest) = path.strip_prefix(".oxyhub/ISSUE_TEMPLATE/") {
193
                    if let (Some(name), oxy_core::state::FileContent::Text { bytes, .. }) = (rest.strip_suffix(".md"), &f.content) {
194
                        out.push((name.to_string(), String::from_utf8_lossy(bytes).into_owned()));
195
                    }
196
                }
197
            }
198
            Ok(out)
199
        })
200
        .await
201
        .unwrap_or_default()
202
}
203
204
pub async fn new_form(
205
    State(app): State<Shared>,
206
    viewer: Viewer,
207
    Path((owner, name)): Path<(String, String)>,
208
    Query(q): Query<NewQuery>,
209
) -> Result<Page<NewIssuePage>, Error> {
210
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issues/new"), &viewer);
211
    require(&viewer, &shell)?;
212
    let (repo, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
213
    let templates = issue_templates(&app, &repo, &row.default_bookmark).await;
214
    let template = match q.template.as_deref() {
215
        Some("blank") => " ".into(),
216
        Some(t) => templates.iter().find(|(n, _)| n == t).map(|(_, b)| b.clone()).unwrap_or_default(),
217
        None if templates.is_empty() => " ".into(),
218
        None => String::new(),
219
    };
220
    Ok(Page(NewIssuePage { shell, repo: RepoShell::new(&app, &row, "issues").with_role(role), templates, template, error: None }))
221
}
222
223
#[derive(Deserialize)]
224
pub struct NewIssueForm {
225
    #[serde(rename = "_csrf")]
226
    csrf_token: String,
227
    title: String,
228
    #[serde(default)]
229
    body: String,
230
}
231
232
pub async fn create(
233
    State(app): State<Shared>,
234
    viewer: Viewer,
235
    Path((owner, name)): Path<(String, String)>,
236
    Form(f): Form<NewIssueForm>,
237
) -> Result<Response, Error> {
238
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issues/new"), &viewer);
239
    let me = require(&viewer, &shell)?;
240
    csrf(&viewer, &f.csrf_token, &shell)?;
241
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
242
    if f.title.trim().is_empty() {
243
        return Ok(Page(NewIssuePage {
244
            shell,
245
            repo: RepoShell::new(&app, &row, "issues").with_role(role),
246
            templates: vec![],
247
            template: f.body,
248
            error: Some("Give the issue a title.".into()),
249
        })
250
        .into_response());
251
    }
252
    let issue = idb::create(
253
        &app.db,
254
        idb::NewIssue {
255
            repo_id: row.id,
256
            title: f.title.trim(),
257
            body: f.body.trim(),
258
            author_id: Some(me.account.id),
259
            author: &me.account.username,
260
        },
261
    )
262
    .await
263
    .map_err(|e| Error::from_db(shell.clone(), e))?;
264
    idb::add_event(&app.db, issue.id, &me.account.username, "opened", "").await.ok();
265
    reindex(&app, row.id, &issue).await;
266
    let url = format!("/{owner}/{name}/issue/{}", issue.number);
267
    notify::deliver(
268
        &app,
269
        Event {
270
            kind: "issue.opened",
271
            title: format!("{owner}/{name}#{}: {}", issue.number, issue.title),
272
            url: url.clone(),
273
            actor: &me.account,
274
            repo_id: row.id,
275
            thread: Some(("issue", issue.id)),
276
            mention_text: &f.body,
277
            direct: vec![],
278
        },
279
    )
280
    .await;
281
    crate::hooks::emit(
282
        &app,
283
        &row,
284
        "issue.opened",
285
        &me.account.username,
286
        serde_json::json!({ "issue": { "number": issue.number, "title": issue.title, "body": issue.body } }),
287
    )
288
    .await;
289
    Ok(Redirect::to(&url).into_response())
290
}
291
292
// ---------------------------------------------------------------- detail
293
294
pub enum Item {
295
    Comment(idb::IssueComment, String),
296
    Event(idb::IssueEvent),
297
}
298
299
#[derive(Template)]
300
#[template(path = "issue.html")]
301
pub struct IssuePage {
302
    shell: Shell,
303
    repo: RepoShell,
304
    i: idb::IssueRow,
305
    body_html: String,
306
    timeline: Vec<Item>,
307
    comments: Vec<idb::IssueComment>,
308
    labels: Vec<idb::Label>,
309
    all_labels: Vec<idb::Label>,
310
    assignees: Vec<String>,
311
    milestone: Option<idb::Milestone>,
312
    milestones: Vec<(idb::Milestone, bool)>,
313
    subscribed: bool,
314
    can_edit: bool,
315
    can_triage: bool,
316
    /// Projects this issue is on that the viewer may see, with the column.
317
    projects: Vec<(crate::db::projects::Project, String)>,
318
    /// Proposals whose description closes it.
319
    closed_by: Vec<super::chain::Link>,
320
    notice: Option<String>,
321
    error: Option<String>,
322
}
323
324
/// The page assembler every action ends in.
325
#[allow(clippy::too_many_arguments)]
326
async fn detail(
327
    app: &Shared,
328
    shell: Shell,
329
    viewer: &Viewer,
330
    owner: &str,
331
    name: &str,
332
    number: i64,
333
    notice: Option<String>,
334
    error: Option<String>,
335
) -> Result<Page<IssuePage>, Error> {
336
    let (_, row, role) = lookup(app, &shell, viewer, owner, name).await?;
337
    let e = |e| Error::from_db(shell.clone(), e);
338
    let i = idb::get(&app.db, row.id, number).await.map_err(e)?.ok_or_else(|| Error::not_found(shell.clone()))?;
339
    let body_html = markdown(app, &row, &row.default_bookmark, &i.body).await;
340
    let comments = idb::comments(&app.db, i.id).await.map_err(e)?;
341
    let events = idb::events(&app.db, i.id).await.map_err(e)?;
342
    let mut timeline: Vec<(i64, Item)> = Vec::new();
343
    for c in &comments {
344
        timeline.push((c.created_ms, Item::Comment(c.clone(), markdown(app, &row, &row.default_bookmark, &c.body).await)));
345
    }
346
    for ev in events {
347
        if ev.event != "opened" {
348
            timeline.push((ev.at_ms, Item::Event(ev)));
349
        }
350
    }
351
    timeline.sort_by_key(|(t, _)| *t);
352
    let labels = idb::issue_labels(&app.db, i.id).await.map_err(e)?;
353
    let all_labels = idb::labels(&app.db, row.id).await.map_err(e)?;
354
    let assignees = idb::assignees(&app.db, i.id).await.map_err(e)?;
355
    let milestones: Vec<(idb::Milestone, bool)> = idb::milestones(&app.db, row.id)
356
        .await
357
        .map_err(e)?
358
        .into_iter()
359
        .map(|m| {
360
            let sel = i.milestone_id == Some(m.id);
361
            (m, sel)
362
        })
363
        .collect();
364
    let milestone = match i.milestone_id {
365
        Some(id) => idb::milestone(&app.db, id).await.map_err(e)?,
366
        None => None,
367
    };
368
    let me = viewer.account();
369
    let subscribed = match me {
370
        Some(a) => ndb::subscribed(&app.db, a.id, "issue", i.id).await.map_err(e)?,
371
        None => false,
372
    };
373
    let can_triage = role >= Role::Triage;
374
    let can_edit = me.is_some_and(|a| Some(a.id) == i.author_id) || can_triage;
375
    let projects = super::projects::placements_for(app, viewer, &row, i.number).await;
376
    let closed_by = super::chain::proposals_closing(app, &row, i.number).await;
377
    Ok(Page(IssuePage {
378
        shell,
379
        repo: RepoShell::new(app, &row, "issues").with_role(role),
380
        i,
381
        closed_by,
382
        body_html,
383
        timeline: timeline.into_iter().map(|(_, it)| it).collect(),
384
        comments,
385
        labels,
386
        all_labels,
387
        assignees,
388
        milestone,
389
        milestones,
390
        subscribed,
391
        can_edit,
392
        can_triage,
393
        projects,
394
        notice,
395
        error,
396
    }))
397
}
398
399
pub async fn show(
400
    State(app): State<Shared>,
401
    viewer: Viewer,
402
    Path((owner, name, number)): Path<(String, String, i64)>,
403
) -> Result<Response, Error> {
404
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
405
    // A number that belongs to a proposal goes there (shared number space).
406
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
407
    if idb::get(&app.db, row.id, number).await.map_err(|e| Error::from_db(shell.clone(), e))?.is_none()
408
        && db::proposals::get(&app.db, row.id, number).await.map_err(|e| Error::from_db(shell.clone(), e))?.is_some()
409
    {
410
        return Ok(Redirect::to(&format!("/{owner}/{name}/proposal/{number}")).into_response());
411
    }
412
    Ok(detail(&app, shell, &viewer, &owner, &name, number, None, None).await?.into_response())
413
}
414
415
// ---------------------------------------------------------------- actions
416
417
async fn issue_for(
418
    app: &Shared,
419
    shell: &Shell,
420
    viewer: &Viewer,
421
    owner: &str,
422
    name: &str,
423
    number: i64,
424
    access: Access,
425
) -> Result<(db::repos::RepoRow, idb::IssueRow, Role), Error> {
426
    let (_, row, role) = lookup_role(app, shell, viewer, owner, name, access).await?;
427
    let i = idb::get(&app.db, row.id, number)
428
        .await
429
        .map_err(|e| Error::from_db(shell.clone(), e))?
430
        .ok_or_else(|| Error::not_found(shell.clone()))?;
431
    Ok((row, i, role))
432
}
433
434
#[derive(Deserialize)]
435
pub struct CommentForm {
436
    #[serde(rename = "_csrf")]
437
    csrf_token: String,
438
    body: String,
439
    #[serde(default)]
440
    close: Option<String>,
441
    #[serde(default)]
442
    reopen: Option<String>,
443
}
444
445
pub async fn comment(
446
    State(app): State<Shared>,
447
    viewer: Viewer,
448
    Path((owner, name, number)): Path<(String, String, i64)>,
449
    Form(f): Form<CommentForm>,
450
) -> Result<Page<IssuePage>, Error> {
451
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
452
    let me = require(&viewer, &shell)?;
453
    csrf(&viewer, &f.csrf_token, &shell)?;
454
    let (row, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
455
    if i.locked && role < Role::Triage {
456
        return detail(&app, shell, &viewer, &owner, &name, number, None, Some("This issue is locked.".into())).await;
457
    }
458
    if f.body.trim().is_empty() {
459
        return detail(&app, shell, &viewer, &owner, &name, number, None, Some("An empty comment says nothing.".into())).await;
460
    }
461
    let e = |e| Error::from_db(shell.clone(), e);
462
    idb::add_comment(&app.db, i.id, Some(me.account.id), &me.account.username, f.body.trim()).await.map_err(e)?;
463
    let url = format!("/{owner}/{name}/issue/{number}");
464
    let mut kind = "issue.comment";
465
    let may_close = Some(me.account.id) == i.author_id || role >= Role::Triage;
466
    if f.close.is_some() && i.state == "open" && may_close {
467
        idb::set_state(&app.db, i.id, "closed", "completed").await.map_err(e)?;
468
        idb::add_event(&app.db, i.id, &me.account.username, "closed", "").await.ok();
469
        kind = "issue.closed";
470
    } else if f.reopen.is_some() && i.state == "closed" && may_close {
471
        idb::set_state(&app.db, i.id, "open", "").await.map_err(e)?;
472
        idb::add_event(&app.db, i.id, &me.account.username, "reopened", "").await.ok();
473
        kind = "issue.reopened";
474
    }
475
    reindex(&app, row.id, &i).await;
476
    let hook_event = if kind == "issue.comment" { "comment.issue" } else { kind };
477
    crate::hooks::emit(
478
        &app,
479
        &row,
480
        hook_event,
481
        &me.account.username,
482
        serde_json::json!({ "number": number, "issue": { "number": number, "title": i.title }, "comment": { "body": f.body.trim() } }),
483
    )
484
    .await;
485
    let direct = i.author_id.into_iter().collect();
486
    notify::deliver(
487
        &app,
488
        Event {
489
            kind,
490
            title: format!("{owner}/{name}#{number}: {}", i.title),
491
            url,
492
            actor: &me.account,
493
            repo_id: row.id,
494
            thread: Some(("issue", i.id)),
495
            mention_text: &f.body,
496
            direct,
497
        },
498
    )
499
    .await;
500
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
501
}
502
503
pub async fn delete_comment(
504
    State(app): State<Shared>,
505
    viewer: Viewer,
506
    Path((owner, name, number, id)): Path<(String, String, i64, i64)>,
507
    Form(f): Form<super::session::CsrfForm>,
508
) -> Result<Page<IssuePage>, Error> {
509
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
510
    let me = require(&viewer, &shell)?;
511
    csrf(&viewer, &f.csrf, &shell)?;
512
    let (row, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
513
    let c = idb::comments(&app.db, i.id).await.map_err(|e| Error::from_db(shell.clone(), e))?.into_iter().find(|c| c.id == id);
514
    if let Some(c) = c {
515
        if c.author_id == Some(me.account.id) || role >= Role::Triage {
516
            idb::delete_comment(&app.db, id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
517
            idb::add_event(&app.db, i.id, &me.account.username, "deleted a comment", "").await.ok();
518
            reindex(&app, row.id, &i).await;
519
        }
520
    }
521
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
522
}
523
524
#[derive(Deserialize)]
525
pub struct EditForm {
526
    #[serde(rename = "_csrf")]
527
    csrf_token: String,
528
    title: String,
529
    #[serde(default)]
530
    body: String,
531
}
532
533
pub async fn edit(
534
    State(app): State<Shared>,
535
    viewer: Viewer,
536
    Path((owner, name, number)): Path<(String, String, i64)>,
537
    Form(f): Form<EditForm>,
538
) -> Result<Page<IssuePage>, Error> {
539
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
540
    let me = require(&viewer, &shell)?;
541
    csrf(&viewer, &f.csrf_token, &shell)?;
542
    let (row, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
543
    if Some(me.account.id) != i.author_id && role < Role::Triage {
544
        return Err(Error::not_found(shell));
545
    }
546
    if f.title.trim().is_empty() {
547
        return detail(&app, shell, &viewer, &owner, &name, number, None, Some("An issue keeps a title.".into())).await;
548
    }
549
    idb::edit(&app.db, i.id, f.title.trim(), f.body.trim()).await.map_err(|e| Error::from_db(shell.clone(), e))?;
550
    idb::add_event(&app.db, i.id, &me.account.username, "edited", "").await.ok();
551
    if let Ok(Some(fresh)) = idb::get(&app.db, row.id, number).await {
552
        reindex(&app, row.id, &fresh).await;
553
    }
554
    detail(&app, shell, &viewer, &owner, &name, number, Some("Saved.".into()), None).await
555
}
556
557
#[derive(Deserialize)]
558
pub struct StateForm {
559
    #[serde(rename = "_csrf")]
560
    csrf_token: String,
561
    action: String,
562
}
563
564
pub async fn state(
565
    State(app): State<Shared>,
566
    viewer: Viewer,
567
    Path((owner, name, number)): Path<(String, String, i64)>,
568
    Form(f): Form<StateForm>,
569
) -> Result<Page<IssuePage>, Error> {
570
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
571
    let me = require(&viewer, &shell)?;
572
    csrf(&viewer, &f.csrf_token, &shell)?;
573
    let (row, i, _) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
574
    let role = crate::auth::roles::role_for(&app.db, Some(&me.account), &row).await.map_err(|e| Error::from_db(shell.clone(), e))?;
575
    if !crate::auth::roles::allows(role, Access::Read) || (role < Some(Role::Triage) && Some(me.account.id) != i.author_id) {
576
        return Err(Error::not_found(shell));
577
    }
578
    let e = |e| Error::from_db(shell.clone(), e);
579
    let (event, kind) = match f.action.as_str() {
580
        "close" => {
581
            idb::set_state(&app.db, i.id, "closed", "completed").await.map_err(e)?;
582
            ("closed", "issue.closed")
583
        }
584
        "not_planned" => {
585
            idb::set_state(&app.db, i.id, "closed", "not_planned").await.map_err(e)?;
586
            ("closed as not planned", "issue.closed")
587
        }
588
        "reopen" => {
589
            idb::set_state(&app.db, i.id, "open", "").await.map_err(e)?;
590
            ("reopened", "issue.reopened")
591
        }
592
        "lock" if role >= Some(Role::Triage) => {
593
            idb::set_flags(&app.db, i.id, Some(true), None).await.map_err(e)?;
594
            ("locked", "")
595
        }
596
        "unlock" if role >= Some(Role::Triage) => {
597
            idb::set_flags(&app.db, i.id, Some(false), None).await.map_err(e)?;
598
            ("unlocked", "")
599
        }
600
        "pin" if role >= Some(Role::Triage) => {
601
            idb::set_flags(&app.db, i.id, None, Some(true)).await.map_err(e)?;
602
            ("pinned", "")
603
        }
604
        "unpin" if role >= Some(Role::Triage) => {
605
            idb::set_flags(&app.db, i.id, None, Some(false)).await.map_err(e)?;
606
            ("unpinned", "")
607
        }
608
        _ => return Err(Error::bad(shell, "unknown action")),
609
    };
610
    idb::add_event(&app.db, i.id, &me.account.username, event, "").await.ok();
611
    if !kind.is_empty() {
612
        crate::hooks::emit(
613
            &app,
614
            &row,
615
            kind,
616
            &me.account.username,
617
            serde_json::json!({ "issue": { "number": number, "title": i.title }, "reason": event }),
618
        )
619
        .await;
620
        let direct = i.author_id.into_iter().collect();
621
        notify::deliver(
622
            &app,
623
            Event {
624
                kind,
625
                title: format!("{owner}/{name}#{number}: {}", i.title),
626
                url: format!("/{owner}/{name}/issue/{number}"),
627
                actor: &me.account,
628
                repo_id: row.id,
629
                thread: Some(("issue", i.id)),
630
                mention_text: "",
631
                direct,
632
            },
633
        )
634
        .await;
635
    }
636
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
637
}
638
639
#[derive(Deserialize)]
640
pub struct LabelsForm {
641
    #[serde(rename = "_csrf")]
642
    csrf_token: String,
643
    #[serde(default)]
644
    label: Vec<i64>,
645
}
646
647
pub async fn set_labels(
648
    State(app): State<Shared>,
649
    viewer: Viewer,
650
    Path((owner, name, number)): Path<(String, String, i64)>,
651
    axum_extra::extract::Form(f): axum_extra::extract::Form<LabelsForm>,
652
) -> Result<Page<IssuePage>, Error> {
653
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
654
    let me = require(&viewer, &shell)?;
655
    csrf(&viewer, &f.csrf_token, &shell)?;
656
    let (row, i, _) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
657
    let role = crate::auth::roles::role_for(&app.db, Some(&me.account), &row).await.map_err(|e| Error::from_db(shell.clone(), e))?;
658
    if role < Some(Role::Triage) {
659
        return Err(Error::not_found(shell));
660
    }
661
    let e = |e| Error::from_db(shell.clone(), e);
662
    for l in idb::labels(&app.db, row.id).await.map_err(e)? {
663
        idb::set_issue_label(&app.db, i.id, l.id, f.label.contains(&l.id)).await.map_err(e)?;
664
    }
665
    idb::add_event(&app.db, i.id, &me.account.username, "set labels", "").await.ok();
666
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
667
}
668
669
#[derive(Deserialize)]
670
pub struct AssignForm {
671
    #[serde(rename = "_csrf")]
672
    csrf_token: String,
673
    username: String,
674
    action: String,
675
}
676
677
pub async fn assign(
678
    State(app): State<Shared>,
679
    viewer: Viewer,
680
    Path((owner, name, number)): Path<(String, String, i64)>,
681
    Form(f): Form<AssignForm>,
682
) -> Result<Page<IssuePage>, Error> {
683
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
684
    let me = require(&viewer, &shell)?;
685
    csrf(&viewer, &f.csrf_token, &shell)?;
686
    let (row, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
687
    if role < Role::Triage {
688
        return Err(Error::not_found(shell));
689
    }
690
    let Some(target) = accounts::account_by_name(&app.db, f.username.trim()).await.map_err(|e| Error::from_db(shell.clone(), e))? else {
691
        return detail(&app, shell, &viewer, &owner, &name, number, None, Some("No such account.".into())).await;
692
    };
693
    let on = f.action == "add";
694
    idb::set_assignee(&app.db, i.id, target.id, on).await.map_err(|e| Error::from_db(shell.clone(), e))?;
695
    idb::add_event(&app.db, i.id, &me.account.username, if on { "assigned" } else { "unassigned" }, &target.username).await.ok();
696
    if on {
697
        notify::deliver(
698
            &app,
699
            Event {
700
                kind: "issue.assigned",
701
                title: format!("{owner}/{name}#{number}: {}", i.title),
702
                url: format!("/{owner}/{name}/issue/{number}"),
703
                actor: &me.account,
704
                repo_id: row.id,
705
                thread: None,
706
                mention_text: "",
707
                direct: vec![target.id],
708
            },
709
        )
710
        .await;
711
        ndb::subscribe(&app.db, target.id, "issue", i.id).await.ok();
712
    }
713
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
714
}
715
716
#[derive(Deserialize)]
717
pub struct MilestoneForm {
718
    #[serde(rename = "_csrf")]
719
    csrf_token: String,
720
    #[serde(default)]
721
    milestone: String,
722
}
723
724
pub async fn set_milestone(
725
    State(app): State<Shared>,
726
    viewer: Viewer,
727
    Path((owner, name, number)): Path<(String, String, i64)>,
728
    Form(f): Form<MilestoneForm>,
729
) -> Result<Page<IssuePage>, Error> {
730
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
731
    let me = require(&viewer, &shell)?;
732
    csrf(&viewer, &f.csrf_token, &shell)?;
733
    let (_, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
734
    if role < Role::Triage {
735
        return Err(Error::not_found(shell));
736
    }
737
    let id = f.milestone.trim().parse::<i64>().ok();
738
    idb::set_milestone(&app.db, i.id, id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
739
    idb::add_event(&app.db, i.id, &me.account.username, "set milestone", "").await.ok();
740
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
741
}
742
743
pub async fn subscribe(
744
    State(app): State<Shared>,
745
    viewer: Viewer,
746
    Path((owner, name, number)): Path<(String, String, i64)>,
747
    Form(f): Form<super::session::CsrfForm>,
748
) -> Result<Page<IssuePage>, Error> {
749
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
750
    let me = require(&viewer, &shell)?;
751
    csrf(&viewer, &f.csrf, &shell)?;
752
    let (_, i, _) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
753
    let e = |e| Error::from_db(shell.clone(), e);
754
    if ndb::subscribed(&app.db, me.account.id, "issue", i.id).await.map_err(e)? {
755
        ndb::unsubscribe(&app.db, me.account.id, "issue", i.id).await.map_err(e)?;
756
    } else {
757
        ndb::subscribe(&app.db, me.account.id, "issue", i.id).await.map_err(e)?;
758
    }
759
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
760
}
761
762
// ---------------------------------------------------------------- labels
763
764
#[derive(Template)]
765
#[template(path = "labels.html")]
766
pub struct LabelsPage {
767
    shell: Shell,
768
    repo: RepoShell,
769
    labels: Vec<idb::Label>,
770
    can_triage: bool,
771
    notice: Option<String>,
772
}
773
774
pub async fn labels(
775
    State(app): State<Shared>,
776
    viewer: Viewer,
777
    Path((owner, name)): Path<(String, String)>,
778
) -> Result<Page<LabelsPage>, Error> {
779
    let shell = Shell::new(&app, &format!("/{owner}/{name}/labels"), &viewer);
780
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
781
    let labels = idb::labels(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
782
    Ok(Page(LabelsPage {
783
        shell,
784
        repo: RepoShell::new(&app, &row, "issues").with_role(role),
785
        labels,
786
        can_triage: role >= Role::Triage,
787
        notice: None,
788
    }))
789
}
790
791
#[derive(Deserialize)]
792
pub struct LabelForm {
793
    #[serde(rename = "_csrf")]
794
    csrf_token: String,
795
    name: String,
796
    #[serde(default = "default_colour")]
797
    colour: String,
798
    #[serde(default)]
799
    description: String,
800
    #[serde(default)]
801
    delete: Option<String>,
802
}
803
804
fn default_colour() -> String {
805
    "#0072ff".into()
806
}
807
808
pub async fn save_label(
809
    State(app): State<Shared>,
810
    viewer: Viewer,
811
    Path((owner, name)): Path<(String, String)>,
812
    Form(f): Form<LabelForm>,
813
) -> Result<Page<LabelsPage>, Error> {
814
    let shell = Shell::new(&app, &format!("/{owner}/{name}/labels"), &viewer);
815
    require(&viewer, &shell)?;
816
    csrf(&viewer, &f.csrf_token, &shell)?;
817
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
818
    if role < Role::Triage {
819
        return Err(Error::not_found(shell));
820
    }
821
    let e = |e| Error::from_db(shell.clone(), e);
822
    let notice = if f.delete.is_some() {
823
        if let Some(l) = idb::label_by_name(&app.db, row.id, f.name.trim()).await.map_err(e)? {
824
            idb::delete_label(&app.db, l.id).await.map_err(e)?;
825
        }
826
        format!("Deleted {}.", f.name.trim())
827
    } else {
828
        let colour = if regex::Regex::new(r"^#[0-9a-fA-F]{6}$").unwrap().is_match(&f.colour) { f.colour.clone() } else { default_colour() };
829
        idb::upsert_label(&app.db, row.id, f.name.trim(), &colour, f.description.trim()).await.map_err(e)?;
830
        format!("Saved {}.", f.name.trim())
831
    };
832
    let labels = idb::labels(&app.db, row.id).await.map_err(e)?;
833
    Ok(Page(LabelsPage {
834
        shell,
835
        repo: RepoShell::new(&app, &row, "issues").with_role(role),
836
        labels,
837
        can_triage: true,
838
        notice: Some(notice),
839
    }))
840
}
841
842
// ------------------------------------------------------------ milestones
843
844
#[derive(Template)]
845
#[template(path = "milestones.html")]
846
pub struct MilestonesPage {
847
    shell: Shell,
848
    repo: RepoShell,
849
    rows: Vec<(idb::Milestone, i64, i64)>,
850
    can_triage: bool,
851
    notice: Option<String>,
852
}
853
854
async fn milestones_page(
855
    app: &Shared,
856
    shell: Shell,
857
    row: db::repos::RepoRow,
858
    role: Role,
859
    notice: Option<String>,
860
) -> Result<Page<MilestonesPage>, Error> {
861
    let mut rows = Vec::new();
862
    for m in idb::milestones(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))? {
863
        let (open, closed) = idb::milestone_counts(&app.db, m.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
864
        rows.push((m, open, closed));
865
    }
866
    Ok(Page(MilestonesPage {
867
        shell,
868
        repo: RepoShell::new(app, &row, "issues").with_role(role),
869
        rows,
870
        can_triage: role >= Role::Triage,
871
        notice,
872
    }))
873
}
874
875
pub async fn milestones(
876
    State(app): State<Shared>,
877
    viewer: Viewer,
878
    Path((owner, name)): Path<(String, String)>,
879
) -> Result<Page<MilestonesPage>, Error> {
880
    let shell = Shell::new(&app, &format!("/{owner}/{name}/milestones"), &viewer);
881
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
882
    milestones_page(&app, shell, row, role, None).await
883
}
884
885
#[derive(Deserialize)]
886
pub struct MilestoneSaveForm {
887
    #[serde(rename = "_csrf")]
888
    csrf_token: String,
889
    title: String,
890
    #[serde(default)]
891
    description: String,
892
    #[serde(default)]
893
    due: String,
894
    #[serde(default)]
895
    state: Option<String>,
896
}
897
898
pub async fn save_milestone(
899
    State(app): State<Shared>,
900
    viewer: Viewer,
901
    Path((owner, name)): Path<(String, String)>,
902
    Form(f): Form<MilestoneSaveForm>,
903
) -> Result<Page<MilestonesPage>, Error> {
904
    let shell = Shell::new(&app, &format!("/{owner}/{name}/milestones"), &viewer);
905
    require(&viewer, &shell)?;
906
    csrf(&viewer, &f.csrf_token, &shell)?;
907
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
908
    if role < Role::Triage {
909
        return Err(Error::not_found(shell));
910
    }
911
    let e = |e| Error::from_db(shell.clone(), e);
912
    if let Some(state) = f.state.as_deref() {
913
        if let Some(m) = idb::milestones(&app.db, row.id).await.map_err(e)?.into_iter().find(|m| m.title == f.title) {
914
            idb::set_milestone_state(&app.db, m.id, if state == "closed" { "closed" } else { "open" }).await.map_err(e)?;
915
        }
916
        return milestones_page(&app, shell, row, role, Some("Updated.".into())).await;
917
    }
918
    let due_ms = time::Date::parse(f.due.trim(), &time::macros::format_description!("[year]-[month]-[day]"))
919
        .ok()
920
        .map(|d| d.midnight().assume_utc().unix_timestamp() * 1000);
921
    idb::upsert_milestone(&app.db, row.id, f.title.trim(), f.description.trim(), due_ms).await.map_err(e)?;
922
    milestones_page(&app, shell, row, role, Some("Saved.".into())).await
923
}
924
925
// ----------------------------------------------------------------- watch
926
927
pub async fn watch(
928
    State(app): State<Shared>,
929
    viewer: Viewer,
930
    Path((owner, name)): Path<(String, String)>,
931
    Form(f): Form<super::session::CsrfForm>,
932
) -> Result<Response, Error> {
933
    let shell = Shell::new(&app, &format!("/{owner}/{name}"), &viewer);
934
    let me = require(&viewer, &shell)?;
935
    csrf(&viewer, &f.csrf, &shell)?;
936
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
937
    let on = !ndb::watching(&app.db, me.account.id, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
938
    ndb::set_watch(&app.db, me.account.id, row.id, on).await.map_err(|e| Error::from_db(shell.clone(), e))?;
939
    Ok(Redirect::to(&format!("/{owner}/{name}")).into_response())
940
}
941
942
/// Star or unstar a repository.
943
pub async fn star(
944
    State(app): State<Shared>,
945
    viewer: Viewer,
946
    Path((owner, name)): Path<(String, String)>,
947
    Form(f): Form<super::session::CsrfForm>,
948
) -> Result<Response, Error> {
949
    let shell = Shell::new(&app, &format!("/{owner}/{name}"), &viewer);
950
    let me = require(&viewer, &shell)?;
951
    csrf(&viewer, &f.csrf, &shell)?;
952
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
953
    db::repos::toggle_star(&app.db, me.account.id, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
954
    Ok(Redirect::to(&format!("/{owner}/{name}")).into_response())
955
}
956
957
/// Put `#N` references of pushed changes on the timelines of those issues
958
/// and proposals: "referenced by change <hash> on <bookmark>".
959
pub async fn references_from_messages(app: &Shared, row: &db::repos::RepoRow, messages: &[(String, String)], bookmark: &str, actor: &str) {
960
    let Ok((issues, proposals)) = idb::numbers(&app.db, row.id).await else { return };
961
    for (hash, message) in messages {
962
        let detail = format!("{} on {bookmark}", &hash[..12.min(hash.len())]);
963
        for n in render::refs::references(message) {
964
            if issues.contains(&n) {
965
                if let Ok(Some(i)) = idb::get(&app.db, row.id, n).await {
966
                    idb::add_event(&app.db, i.id, actor, "referenced by change", &detail).await.ok();
967
                }
968
            } else if proposals.contains(&n) {
969
                if let Ok(Some(p)) = db::proposals::get(&app.db, row.id, n).await {
970
                    db::proposals::add_event(&app.db, p.id, actor, "referenced by change", &detail).await.ok();
971
                }
972
            }
973
        }
974
    }
975
}
976
977
/// Close issues a landed change's message names (`closes #12`), when the
978
/// landing reached the default bookmark. Called from the push hook and
979
/// the hub's own landing.
980
pub async fn close_from_messages(app: &Shared, row: &db::repos::RepoRow, messages: &[(String, String)]) {
981
    for (hash, message) in messages {
982
        for n in render::refs::closes(message) {
983
            if let Ok(Some(i)) = idb::get(&app.db, row.id, n).await {
984
                if i.state == "open" {
985
                    idb::set_state(&app.db, i.id, "closed", "completed").await.ok();
986
                    idb::add_event(&app.db, i.id, "", "closed by change", &hash[..12.min(hash.len())]).await.ok();
987
                    for id in ndb::subscribers(&app.db, "issue", i.id).await.unwrap_or_default() {
988
                        let title = format!("{}#{}: {} (closed by {})", row.slug(), i.number, i.title, &hash[..12.min(hash.len())]);
989
                        let url = format!("/{}/issue/{}", row.slug(), i.number);
990
                        ndb::add(
991
                            &app.db,
992
                            ndb::New {
993
                                account_id: id,
994
                                repo_id: Some(row.id),
995
                                reason: ndb::Reason::Participating,
996
                                kind: "issue.closed",
997
                                title: &title,
998
                                url: &url,
999
                                actor: "",
1000
                            },
1001
                        )
1002
                        .await
1003
                        .ok();
1004
                    }
1005
                }
1006
            }
1007
        }
1008
    }
1009
}