OXYGENHUB
# b6b7e4cf6b24 oxygenhub / crates / hub / src / web / issues.rs
38.0 KiB · Rust · last changed Webhooks: Discord and Slack formats (Discord hooks switched over), a masked URL that wraps, the last delivery in the table, an edit form, and web issue events delivered 1 month ago source blame history raw
18e381ea Andy McCall ↶ 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
c79a1111 Andy McCall ↶ 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}/"))
18e381ea Andy McCall ↶ 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),
1ac84c62 Andy McCall ↶ 53
    sort: String,
54
    pager: super::Pager,
18e381ea Andy McCall ↶ 55
}
56
57
#[derive(Deserialize)]
58
pub struct ListQuery {
59
    state: Option<String>,
60
    q: Option<String>,
1ac84c62 Andy McCall ↶ 61
    sort: Option<String>,
62
    page: Option<usize>,
18e381ea Andy McCall ↶ 63
}
64
1ac84c62 Andy McCall ↶ 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
18e381ea Andy McCall ↶ 70
/// `label:bug assignee:andy milestone:v1 state:closed words…`
71
struct Filter {
72
    state: String,
73
    labels: Vec<String>,
74
    assignees: Vec<String>,
1ac84c62 Andy McCall ↶ 75
    authors: Vec<String>,
18e381ea Andy McCall ↶ 76
    milestone: Option<String>,
77
    words: Vec<String>,
78
}
79
80
fn parse_filter(state: Option<String>, q: &str) -> Filter {
1ac84c62 Andy McCall ↶ 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
    };
18e381ea Andy McCall ↶ 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()),
1ac84c62 Andy McCall ↶ 93
            Some(("author", v)) => f.authors.push(v.to_lowercase()),
18e381ea Andy McCall ↶ 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))
1ac84c62 Andy McCall ↶ 133
            && (f.authors.is_empty() || f.authors.contains(&i.author.to_lowercase()))
18e381ea Andy McCall ↶ 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
    }
1ac84c62 Andy McCall ↶ 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
    }))
18e381ea Andy McCall ↶ 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;
9756c67d Andy McCall ↶ 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;
18e381ea Andy McCall ↶ 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,
e1ec9fbf Andy McCall ↶ 316
    /// Projects this issue is on that the viewer may see, with the column.
317
    projects: Vec<(crate::db::projects::Project, String)>,
18e381ea Andy McCall ↶ 318
    notice: Option<String>,
319
    error: Option<String>,
320
}
321
322
/// The page assembler every action ends in.
323
#[allow(clippy::too_many_arguments)]
324
async fn detail(
325
    app: &Shared,
326
    shell: Shell,
327
    viewer: &Viewer,
328
    owner: &str,
329
    name: &str,
330
    number: i64,
331
    notice: Option<String>,
332
    error: Option<String>,
333
) -> Result<Page<IssuePage>, Error> {
334
    let (_, row, role) = lookup(app, &shell, viewer, owner, name).await?;
335
    let e = |e| Error::from_db(shell.clone(), e);
336
    let i = idb::get(&app.db, row.id, number).await.map_err(e)?.ok_or_else(|| Error::not_found(shell.clone()))?;
c79a1111 Andy McCall ↶ 337
    let body_html = markdown(app, &row, &row.default_bookmark, &i.body).await;
18e381ea Andy McCall ↶ 338
    let comments = idb::comments(&app.db, i.id).await.map_err(e)?;
339
    let events = idb::events(&app.db, i.id).await.map_err(e)?;
340
    let mut timeline: Vec<(i64, Item)> = Vec::new();
341
    for c in &comments {
c79a1111 Andy McCall ↶ 342
        timeline.push((c.created_ms, Item::Comment(c.clone(), markdown(app, &row, &row.default_bookmark, &c.body).await)));
18e381ea Andy McCall ↶ 343
    }
344
    for ev in events {
345
        if ev.event != "opened" {
346
            timeline.push((ev.at_ms, Item::Event(ev)));
347
        }
348
    }
349
    timeline.sort_by_key(|(t, _)| *t);
350
    let labels = idb::issue_labels(&app.db, i.id).await.map_err(e)?;
351
    let all_labels = idb::labels(&app.db, row.id).await.map_err(e)?;
352
    let assignees = idb::assignees(&app.db, i.id).await.map_err(e)?;
353
    let milestones: Vec<(idb::Milestone, bool)> = idb::milestones(&app.db, row.id)
354
        .await
355
        .map_err(e)?
356
        .into_iter()
357
        .map(|m| {
358
            let sel = i.milestone_id == Some(m.id);
359
            (m, sel)
360
        })
361
        .collect();
362
    let milestone = match i.milestone_id {
363
        Some(id) => idb::milestone(&app.db, id).await.map_err(e)?,
364
        None => None,
365
    };
366
    let me = viewer.account();
367
    let subscribed = match me {
368
        Some(a) => ndb::subscribed(&app.db, a.id, "issue", i.id).await.map_err(e)?,
369
        None => false,
370
    };
371
    let can_triage = role >= Role::Triage;
372
    let can_edit = me.is_some_and(|a| Some(a.id) == i.author_id) || can_triage;
e1ec9fbf Andy McCall ↶ 373
    let projects = super::projects::placements_for(app, viewer, &row, i.number).await;
18e381ea Andy McCall ↶ 374
    Ok(Page(IssuePage {
375
        shell,
376
        repo: RepoShell::new(app, &row, "issues").with_role(role),
377
        i,
378
        body_html,
379
        timeline: timeline.into_iter().map(|(_, it)| it).collect(),
380
        comments,
381
        labels,
382
        all_labels,
383
        assignees,
384
        milestone,
385
        milestones,
386
        subscribed,
387
        can_edit,
388
        can_triage,
e1ec9fbf Andy McCall ↶ 389
        projects,
18e381ea Andy McCall ↶ 390
        notice,
391
        error,
392
    }))
393
}
394
395
pub async fn show(
396
    State(app): State<Shared>,
397
    viewer: Viewer,
398
    Path((owner, name, number)): Path<(String, String, i64)>,
399
) -> Result<Response, Error> {
400
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
401
    // A number that belongs to a proposal goes there (shared number space).
402
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
403
    if idb::get(&app.db, row.id, number).await.map_err(|e| Error::from_db(shell.clone(), e))?.is_none()
404
        && db::proposals::get(&app.db, row.id, number).await.map_err(|e| Error::from_db(shell.clone(), e))?.is_some()
405
    {
406
        return Ok(Redirect::to(&format!("/{owner}/{name}/proposal/{number}")).into_response());
407
    }
408
    Ok(detail(&app, shell, &viewer, &owner, &name, number, None, None).await?.into_response())
409
}
410
411
// ---------------------------------------------------------------- actions
412
413
async fn issue_for(
414
    app: &Shared,
415
    shell: &Shell,
416
    viewer: &Viewer,
417
    owner: &str,
418
    name: &str,
419
    number: i64,
420
    access: Access,
421
) -> Result<(db::repos::RepoRow, idb::IssueRow, Role), Error> {
422
    let (_, row, role) = lookup_role(app, shell, viewer, owner, name, access).await?;
423
    let i = idb::get(&app.db, row.id, number)
424
        .await
425
        .map_err(|e| Error::from_db(shell.clone(), e))?
426
        .ok_or_else(|| Error::not_found(shell.clone()))?;
427
    Ok((row, i, role))
428
}
429
430
#[derive(Deserialize)]
431
pub struct CommentForm {
432
    #[serde(rename = "_csrf")]
433
    csrf_token: String,
434
    body: String,
435
    #[serde(default)]
436
    close: Option<String>,
437
    #[serde(default)]
438
    reopen: Option<String>,
439
}
440
441
pub async fn comment(
442
    State(app): State<Shared>,
443
    viewer: Viewer,
444
    Path((owner, name, number)): Path<(String, String, i64)>,
445
    Form(f): Form<CommentForm>,
446
) -> Result<Page<IssuePage>, Error> {
447
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
448
    let me = require(&viewer, &shell)?;
449
    csrf(&viewer, &f.csrf_token, &shell)?;
450
    let (row, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
451
    if i.locked && role < Role::Triage {
452
        return detail(&app, shell, &viewer, &owner, &name, number, None, Some("This issue is locked.".into())).await;
453
    }
454
    if f.body.trim().is_empty() {
455
        return detail(&app, shell, &viewer, &owner, &name, number, None, Some("An empty comment says nothing.".into())).await;
456
    }
457
    let e = |e| Error::from_db(shell.clone(), e);
458
    idb::add_comment(&app.db, i.id, Some(me.account.id), &me.account.username, f.body.trim()).await.map_err(e)?;
459
    let url = format!("/{owner}/{name}/issue/{number}");
460
    let mut kind = "issue.comment";
461
    let may_close = Some(me.account.id) == i.author_id || role >= Role::Triage;
462
    if f.close.is_some() && i.state == "open" && may_close {
463
        idb::set_state(&app.db, i.id, "closed", "completed").await.map_err(e)?;
464
        idb::add_event(&app.db, i.id, &me.account.username, "closed", "").await.ok();
465
        kind = "issue.closed";
466
    } else if f.reopen.is_some() && i.state == "closed" && may_close {
467
        idb::set_state(&app.db, i.id, "open", "").await.map_err(e)?;
468
        idb::add_event(&app.db, i.id, &me.account.username, "reopened", "").await.ok();
469
        kind = "issue.reopened";
470
    }
471
    reindex(&app, row.id, &i).await;
9756c67d Andy McCall ↶ 472
    let hook_event = if kind == "issue.comment" { "comment.issue" } else { kind };
473
    crate::hooks::emit(
474
        &app,
475
        &row,
476
        hook_event,
477
        &me.account.username,
478
        serde_json::json!({ "number": number, "issue": { "number": number, "title": i.title }, "comment": { "body": f.body.trim() } }),
479
    )
480
    .await;
18e381ea Andy McCall ↶ 481
    let direct = i.author_id.into_iter().collect();
482
    notify::deliver(
483
        &app,
484
        Event {
485
            kind,
486
            title: format!("{owner}/{name}#{number}: {}", i.title),
487
            url,
488
            actor: &me.account,
489
            repo_id: row.id,
490
            thread: Some(("issue", i.id)),
491
            mention_text: &f.body,
492
            direct,
493
        },
494
    )
495
    .await;
496
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
497
}
498
499
pub async fn delete_comment(
500
    State(app): State<Shared>,
501
    viewer: Viewer,
502
    Path((owner, name, number, id)): Path<(String, String, i64, i64)>,
503
    Form(f): Form<super::session::CsrfForm>,
504
) -> Result<Page<IssuePage>, Error> {
505
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
506
    let me = require(&viewer, &shell)?;
507
    csrf(&viewer, &f.csrf, &shell)?;
508
    let (row, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
509
    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);
510
    if let Some(c) = c {
511
        if c.author_id == Some(me.account.id) || role >= Role::Triage {
512
            idb::delete_comment(&app.db, id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
513
            idb::add_event(&app.db, i.id, &me.account.username, "deleted a comment", "").await.ok();
514
            reindex(&app, row.id, &i).await;
515
        }
516
    }
517
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
518
}
519
520
#[derive(Deserialize)]
521
pub struct EditForm {
522
    #[serde(rename = "_csrf")]
523
    csrf_token: String,
524
    title: String,
525
    #[serde(default)]
526
    body: String,
527
}
528
529
pub async fn edit(
530
    State(app): State<Shared>,
531
    viewer: Viewer,
532
    Path((owner, name, number)): Path<(String, String, i64)>,
533
    Form(f): Form<EditForm>,
534
) -> Result<Page<IssuePage>, Error> {
535
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
536
    let me = require(&viewer, &shell)?;
537
    csrf(&viewer, &f.csrf_token, &shell)?;
538
    let (row, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
539
    if Some(me.account.id) != i.author_id && role < Role::Triage {
540
        return Err(Error::not_found(shell));
541
    }
542
    if f.title.trim().is_empty() {
543
        return detail(&app, shell, &viewer, &owner, &name, number, None, Some("An issue keeps a title.".into())).await;
544
    }
545
    idb::edit(&app.db, i.id, f.title.trim(), f.body.trim()).await.map_err(|e| Error::from_db(shell.clone(), e))?;
546
    idb::add_event(&app.db, i.id, &me.account.username, "edited", "").await.ok();
547
    if let Ok(Some(fresh)) = idb::get(&app.db, row.id, number).await {
548
        reindex(&app, row.id, &fresh).await;
549
    }
550
    detail(&app, shell, &viewer, &owner, &name, number, Some("Saved.".into()), None).await
551
}
552
553
#[derive(Deserialize)]
554
pub struct StateForm {
555
    #[serde(rename = "_csrf")]
556
    csrf_token: String,
557
    action: String,
558
}
559
560
pub async fn state(
561
    State(app): State<Shared>,
562
    viewer: Viewer,
563
    Path((owner, name, number)): Path<(String, String, i64)>,
564
    Form(f): Form<StateForm>,
565
) -> Result<Page<IssuePage>, Error> {
566
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
567
    let me = require(&viewer, &shell)?;
568
    csrf(&viewer, &f.csrf_token, &shell)?;
569
    let (row, i, _) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
570
    let role = crate::auth::roles::role_for(&app.db, Some(&me.account), &row).await.map_err(|e| Error::from_db(shell.clone(), e))?;
571
    if !crate::auth::roles::allows(role, Access::Read) || (role < Some(Role::Triage) && Some(me.account.id) != i.author_id) {
572
        return Err(Error::not_found(shell));
573
    }
574
    let e = |e| Error::from_db(shell.clone(), e);
575
    let (event, kind) = match f.action.as_str() {
576
        "close" => {
577
            idb::set_state(&app.db, i.id, "closed", "completed").await.map_err(e)?;
578
            ("closed", "issue.closed")
579
        }
580
        "not_planned" => {
581
            idb::set_state(&app.db, i.id, "closed", "not_planned").await.map_err(e)?;
582
            ("closed as not planned", "issue.closed")
583
        }
584
        "reopen" => {
585
            idb::set_state(&app.db, i.id, "open", "").await.map_err(e)?;
586
            ("reopened", "issue.reopened")
587
        }
588
        "lock" if role >= Some(Role::Triage) => {
589
            idb::set_flags(&app.db, i.id, Some(true), None).await.map_err(e)?;
590
            ("locked", "")
591
        }
592
        "unlock" if role >= Some(Role::Triage) => {
593
            idb::set_flags(&app.db, i.id, Some(false), None).await.map_err(e)?;
594
            ("unlocked", "")
595
        }
596
        "pin" if role >= Some(Role::Triage) => {
597
            idb::set_flags(&app.db, i.id, None, Some(true)).await.map_err(e)?;
598
            ("pinned", "")
599
        }
600
        "unpin" if role >= Some(Role::Triage) => {
601
            idb::set_flags(&app.db, i.id, None, Some(false)).await.map_err(e)?;
602
            ("unpinned", "")
603
        }
604
        _ => return Err(Error::bad(shell, "unknown action")),
605
    };
606
    idb::add_event(&app.db, i.id, &me.account.username, event, "").await.ok();
607
    if !kind.is_empty() {
9756c67d Andy McCall ↶ 608
        crate::hooks::emit(
609
            &app,
610
            &row,
611
            kind,
612
            &me.account.username,
613
            serde_json::json!({ "issue": { "number": number, "title": i.title }, "reason": event }),
614
        )
615
        .await;
18e381ea Andy McCall ↶ 616
        let direct = i.author_id.into_iter().collect();
617
        notify::deliver(
618
            &app,
619
            Event {
620
                kind,
621
                title: format!("{owner}/{name}#{number}: {}", i.title),
622
                url: format!("/{owner}/{name}/issue/{number}"),
623
                actor: &me.account,
624
                repo_id: row.id,
625
                thread: Some(("issue", i.id)),
626
                mention_text: "",
627
                direct,
628
            },
629
        )
630
        .await;
631
    }
632
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
633
}
634
635
#[derive(Deserialize)]
636
pub struct LabelsForm {
637
    #[serde(rename = "_csrf")]
638
    csrf_token: String,
639
    #[serde(default)]
640
    label: Vec<i64>,
641
}
642
643
pub async fn set_labels(
644
    State(app): State<Shared>,
645
    viewer: Viewer,
646
    Path((owner, name, number)): Path<(String, String, i64)>,
647
    axum_extra::extract::Form(f): axum_extra::extract::Form<LabelsForm>,
648
) -> Result<Page<IssuePage>, Error> {
649
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
650
    let me = require(&viewer, &shell)?;
651
    csrf(&viewer, &f.csrf_token, &shell)?;
652
    let (row, i, _) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
653
    let role = crate::auth::roles::role_for(&app.db, Some(&me.account), &row).await.map_err(|e| Error::from_db(shell.clone(), e))?;
654
    if role < Some(Role::Triage) {
655
        return Err(Error::not_found(shell));
656
    }
657
    let e = |e| Error::from_db(shell.clone(), e);
658
    for l in idb::labels(&app.db, row.id).await.map_err(e)? {
659
        idb::set_issue_label(&app.db, i.id, l.id, f.label.contains(&l.id)).await.map_err(e)?;
660
    }
661
    idb::add_event(&app.db, i.id, &me.account.username, "set labels", "").await.ok();
662
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
663
}
664
665
#[derive(Deserialize)]
666
pub struct AssignForm {
667
    #[serde(rename = "_csrf")]
668
    csrf_token: String,
669
    username: String,
670
    action: String,
671
}
672
673
pub async fn assign(
674
    State(app): State<Shared>,
675
    viewer: Viewer,
676
    Path((owner, name, number)): Path<(String, String, i64)>,
677
    Form(f): Form<AssignForm>,
678
) -> Result<Page<IssuePage>, Error> {
679
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
680
    let me = require(&viewer, &shell)?;
681
    csrf(&viewer, &f.csrf_token, &shell)?;
682
    let (row, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
683
    if role < Role::Triage {
684
        return Err(Error::not_found(shell));
685
    }
686
    let Some(target) = accounts::account_by_name(&app.db, f.username.trim()).await.map_err(|e| Error::from_db(shell.clone(), e))? else {
687
        return detail(&app, shell, &viewer, &owner, &name, number, None, Some("No such account.".into())).await;
688
    };
689
    let on = f.action == "add";
690
    idb::set_assignee(&app.db, i.id, target.id, on).await.map_err(|e| Error::from_db(shell.clone(), e))?;
691
    idb::add_event(&app.db, i.id, &me.account.username, if on { "assigned" } else { "unassigned" }, &target.username).await.ok();
692
    if on {
693
        notify::deliver(
694
            &app,
695
            Event {
696
                kind: "issue.assigned",
697
                title: format!("{owner}/{name}#{number}: {}", i.title),
698
                url: format!("/{owner}/{name}/issue/{number}"),
699
                actor: &me.account,
700
                repo_id: row.id,
701
                thread: None,
702
                mention_text: "",
703
                direct: vec![target.id],
704
            },
705
        )
706
        .await;
707
        ndb::subscribe(&app.db, target.id, "issue", i.id).await.ok();
708
    }
709
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
710
}
711
712
#[derive(Deserialize)]
713
pub struct MilestoneForm {
714
    #[serde(rename = "_csrf")]
715
    csrf_token: String,
716
    #[serde(default)]
717
    milestone: String,
718
}
719
720
pub async fn set_milestone(
721
    State(app): State<Shared>,
722
    viewer: Viewer,
723
    Path((owner, name, number)): Path<(String, String, i64)>,
724
    Form(f): Form<MilestoneForm>,
725
) -> Result<Page<IssuePage>, Error> {
726
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
727
    let me = require(&viewer, &shell)?;
728
    csrf(&viewer, &f.csrf_token, &shell)?;
729
    let (_, i, role) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
730
    if role < Role::Triage {
731
        return Err(Error::not_found(shell));
732
    }
733
    let id = f.milestone.trim().parse::<i64>().ok();
734
    idb::set_milestone(&app.db, i.id, id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
735
    idb::add_event(&app.db, i.id, &me.account.username, "set milestone", "").await.ok();
736
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
737
}
738
739
pub async fn subscribe(
740
    State(app): State<Shared>,
741
    viewer: Viewer,
742
    Path((owner, name, number)): Path<(String, String, i64)>,
743
    Form(f): Form<super::session::CsrfForm>,
744
) -> Result<Page<IssuePage>, Error> {
745
    let shell = Shell::new(&app, &format!("/{owner}/{name}/issue/{number}"), &viewer);
746
    let me = require(&viewer, &shell)?;
747
    csrf(&viewer, &f.csrf, &shell)?;
748
    let (_, i, _) = issue_for(&app, &shell, &viewer, &owner, &name, number, Access::Read).await?;
749
    let e = |e| Error::from_db(shell.clone(), e);
750
    if ndb::subscribed(&app.db, me.account.id, "issue", i.id).await.map_err(e)? {
751
        ndb::unsubscribe(&app.db, me.account.id, "issue", i.id).await.map_err(e)?;
752
    } else {
753
        ndb::subscribe(&app.db, me.account.id, "issue", i.id).await.map_err(e)?;
754
    }
755
    detail(&app, shell, &viewer, &owner, &name, number, None, None).await
756
}
757
758
// ---------------------------------------------------------------- labels
759
760
#[derive(Template)]
761
#[template(path = "labels.html")]
762
pub struct LabelsPage {
763
    shell: Shell,
764
    repo: RepoShell,
765
    labels: Vec<idb::Label>,
766
    can_triage: bool,
767
    notice: Option<String>,
768
}
769
770
pub async fn labels(
771
    State(app): State<Shared>,
772
    viewer: Viewer,
773
    Path((owner, name)): Path<(String, String)>,
774
) -> Result<Page<LabelsPage>, Error> {
775
    let shell = Shell::new(&app, &format!("/{owner}/{name}/labels"), &viewer);
776
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
777
    let labels = idb::labels(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
778
    Ok(Page(LabelsPage {
779
        shell,
780
        repo: RepoShell::new(&app, &row, "issues").with_role(role),
781
        labels,
782
        can_triage: role >= Role::Triage,
783
        notice: None,
784
    }))
785
}
786
787
#[derive(Deserialize)]
788
pub struct LabelForm {
789
    #[serde(rename = "_csrf")]
790
    csrf_token: String,
791
    name: String,
792
    #[serde(default = "default_colour")]
793
    colour: String,
794
    #[serde(default)]
795
    description: String,
796
    #[serde(default)]
797
    delete: Option<String>,
798
}
799
800
fn default_colour() -> String {
801
    "#0072ff".into()
802
}
803
804
pub async fn save_label(
805
    State(app): State<Shared>,
806
    viewer: Viewer,
807
    Path((owner, name)): Path<(String, String)>,
808
    Form(f): Form<LabelForm>,
809
) -> Result<Page<LabelsPage>, Error> {
810
    let shell = Shell::new(&app, &format!("/{owner}/{name}/labels"), &viewer);
811
    require(&viewer, &shell)?;
812
    csrf(&viewer, &f.csrf_token, &shell)?;
813
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
814
    if role < Role::Triage {
815
        return Err(Error::not_found(shell));
816
    }
817
    let e = |e| Error::from_db(shell.clone(), e);
818
    let notice = if f.delete.is_some() {
819
        if let Some(l) = idb::label_by_name(&app.db, row.id, f.name.trim()).await.map_err(e)? {
820
            idb::delete_label(&app.db, l.id).await.map_err(e)?;
821
        }
822
        format!("Deleted {}.", f.name.trim())
823
    } else {
824
        let colour = if regex::Regex::new(r"^#[0-9a-fA-F]{6}$").unwrap().is_match(&f.colour) { f.colour.clone() } else { default_colour() };
825
        idb::upsert_label(&app.db, row.id, f.name.trim(), &colour, f.description.trim()).await.map_err(e)?;
826
        format!("Saved {}.", f.name.trim())
827
    };
828
    let labels = idb::labels(&app.db, row.id).await.map_err(e)?;
829
    Ok(Page(LabelsPage {
830
        shell,
831
        repo: RepoShell::new(&app, &row, "issues").with_role(role),
832
        labels,
833
        can_triage: true,
834
        notice: Some(notice),
835
    }))
836
}
837
838
// ------------------------------------------------------------ milestones
839
840
#[derive(Template)]
841
#[template(path = "milestones.html")]
842
pub struct MilestonesPage {
843
    shell: Shell,
844
    repo: RepoShell,
845
    rows: Vec<(idb::Milestone, i64, i64)>,
846
    can_triage: bool,
847
    notice: Option<String>,
848
}
849
850
async fn milestones_page(
851
    app: &Shared,
852
    shell: Shell,
853
    row: db::repos::RepoRow,
854
    role: Role,
855
    notice: Option<String>,
856
) -> Result<Page<MilestonesPage>, Error> {
857
    let mut rows = Vec::new();
858
    for m in idb::milestones(&app.db, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))? {
859
        let (open, closed) = idb::milestone_counts(&app.db, m.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
860
        rows.push((m, open, closed));
861
    }
862
    Ok(Page(MilestonesPage {
863
        shell,
864
        repo: RepoShell::new(app, &row, "issues").with_role(role),
865
        rows,
866
        can_triage: role >= Role::Triage,
867
        notice,
868
    }))
869
}
870
871
pub async fn milestones(
872
    State(app): State<Shared>,
873
    viewer: Viewer,
874
    Path((owner, name)): Path<(String, String)>,
875
) -> Result<Page<MilestonesPage>, Error> {
876
    let shell = Shell::new(&app, &format!("/{owner}/{name}/milestones"), &viewer);
877
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
878
    milestones_page(&app, shell, row, role, None).await
879
}
880
881
#[derive(Deserialize)]
882
pub struct MilestoneSaveForm {
883
    #[serde(rename = "_csrf")]
884
    csrf_token: String,
885
    title: String,
886
    #[serde(default)]
887
    description: String,
888
    #[serde(default)]
889
    due: String,
890
    #[serde(default)]
891
    state: Option<String>,
892
}
893
894
pub async fn save_milestone(
895
    State(app): State<Shared>,
896
    viewer: Viewer,
897
    Path((owner, name)): Path<(String, String)>,
898
    Form(f): Form<MilestoneSaveForm>,
899
) -> Result<Page<MilestonesPage>, Error> {
900
    let shell = Shell::new(&app, &format!("/{owner}/{name}/milestones"), &viewer);
901
    require(&viewer, &shell)?;
902
    csrf(&viewer, &f.csrf_token, &shell)?;
903
    let (_, row, role) = lookup(&app, &shell, &viewer, &owner, &name).await?;
904
    if role < Role::Triage {
905
        return Err(Error::not_found(shell));
906
    }
907
    let e = |e| Error::from_db(shell.clone(), e);
908
    if let Some(state) = f.state.as_deref() {
909
        if let Some(m) = idb::milestones(&app.db, row.id).await.map_err(e)?.into_iter().find(|m| m.title == f.title) {
910
            idb::set_milestone_state(&app.db, m.id, if state == "closed" { "closed" } else { "open" }).await.map_err(e)?;
911
        }
912
        return milestones_page(&app, shell, row, role, Some("Updated.".into())).await;
913
    }
914
    let due_ms = time::Date::parse(f.due.trim(), &time::macros::format_description!("[year]-[month]-[day]"))
915
        .ok()
916
        .map(|d| d.midnight().assume_utc().unix_timestamp() * 1000);
917
    idb::upsert_milestone(&app.db, row.id, f.title.trim(), f.description.trim(), due_ms).await.map_err(e)?;
918
    milestones_page(&app, shell, row, role, Some("Saved.".into())).await
919
}
920
921
// ----------------------------------------------------------------- watch
922
923
pub async fn watch(
924
    State(app): State<Shared>,
925
    viewer: Viewer,
926
    Path((owner, name)): Path<(String, String)>,
927
    Form(f): Form<super::session::CsrfForm>,
928
) -> Result<Response, Error> {
929
    let shell = Shell::new(&app, &format!("/{owner}/{name}"), &viewer);
930
    let me = require(&viewer, &shell)?;
931
    csrf(&viewer, &f.csrf, &shell)?;
932
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
933
    let on = !ndb::watching(&app.db, me.account.id, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
934
    ndb::set_watch(&app.db, me.account.id, row.id, on).await.map_err(|e| Error::from_db(shell.clone(), e))?;
935
    Ok(Redirect::to(&format!("/{owner}/{name}")).into_response())
936
}
937
1553bfc9 Andy McCall ↶ 938
/// Star or unstar a repository.
939
pub async fn star(
940
    State(app): State<Shared>,
941
    viewer: Viewer,
942
    Path((owner, name)): Path<(String, String)>,
943
    Form(f): Form<super::session::CsrfForm>,
944
) -> Result<Response, Error> {
945
    let shell = Shell::new(&app, &format!("/{owner}/{name}"), &viewer);
946
    let me = require(&viewer, &shell)?;
947
    csrf(&viewer, &f.csrf, &shell)?;
948
    let (_, row, _) = lookup(&app, &shell, &viewer, &owner, &name).await?;
949
    db::repos::toggle_star(&app.db, me.account.id, row.id).await.map_err(|e| Error::from_db(shell.clone(), e))?;
950
    Ok(Redirect::to(&format!("/{owner}/{name}")).into_response())
951
}
952
78001759 Andy McCall ↶ 953
/// Put `#N` references of pushed changes on the timelines of those issues
954
/// and proposals: "referenced by change <hash> on <bookmark>".
955
pub async fn references_from_messages(app: &Shared, row: &db::repos::RepoRow, messages: &[(String, String)], bookmark: &str, actor: &str) {
956
    let Ok((issues, proposals)) = idb::numbers(&app.db, row.id).await else { return };
957
    for (hash, message) in messages {
958
        let detail = format!("{} on {bookmark}", &hash[..12.min(hash.len())]);
959
        for n in render::refs::references(message) {
960
            if issues.contains(&n) {
961
                if let Ok(Some(i)) = idb::get(&app.db, row.id, n).await {
962
                    idb::add_event(&app.db, i.id, actor, "referenced by change", &detail).await.ok();
963
                }
964
            } else if proposals.contains(&n) {
965
                if let Ok(Some(p)) = db::proposals::get(&app.db, row.id, n).await {
966
                    db::proposals::add_event(&app.db, p.id, actor, "referenced by change", &detail).await.ok();
967
                }
968
            }
969
        }
970
    }
971
}
972
18e381ea Andy McCall ↶ 973
/// Close issues a landed change's message names (`closes #12`), when the
974
/// landing reached the default bookmark. Called from the push hook and
975
/// the hub's own landing.
976
pub async fn close_from_messages(app: &Shared, row: &db::repos::RepoRow, messages: &[(String, String)]) {
977
    for (hash, message) in messages {
978
        for n in render::refs::closes(message) {
979
            if let Ok(Some(i)) = idb::get(&app.db, row.id, n).await {
980
                if i.state == "open" {
981
                    idb::set_state(&app.db, i.id, "closed", "completed").await.ok();
982
                    idb::add_event(&app.db, i.id, "", "closed by change", &hash[..12.min(hash.len())]).await.ok();
983
                    for id in ndb::subscribers(&app.db, "issue", i.id).await.unwrap_or_default() {
eb0c44a9 Andy McCall ↶ 984
                        let title = format!("{}#{}: {} (closed by {})", row.slug(), i.number, i.title, &hash[..12.min(hash.len())]);
985
                        let url = format!("/{}/issue/{}", row.slug(), i.number);
18e381ea Andy McCall ↶ 986
                        ndb::add(
987
                            &app.db,
eb0c44a9 Andy McCall ↶ 988
                            ndb::New {
989
                                account_id: id,
990
                                repo_id: Some(row.id),
991
                                reason: ndb::Reason::Participating,
992
                                kind: "issue.closed",
993
                                title: &title,
994
                                url: &url,
995
                                actor: "",
996
                            },
18e381ea Andy McCall ↶ 997
                        )
998
                        .await
999
                        .ok();
1000
                    }
1001
                }
1002
            }
1003
        }
1004
    }
1005
}