gitoria

4.3 KB

1. // tickets.hl — THE TICKETS OF A REPO (ticket gitoria#10; CONCEPT "/tickets"). The tickets are NOT stored in
2. // gitoria: they live in tickets.worldapi.org, in a project named after the repo. The project is made by
3. // tickets itself the moment the first ticket is opened (its API creates a project with its first ticket), so
4. // anyone who logs in to tickets.worldapi.org sees a repo's tickets like those of any tickets project.
5. //
6. // project name = <slug>.<host of the public url> (e.g. myrepo.gitoria.worldapi.org). A repo slug has no
7. // dot, so it never meets another repo's project or one of the dotted app projects of the system.
8. // read = GET <tickets>/api/projects/<project>/tickets (public; 404 = no ticket yet)
9. // write = POST <tickets>/api/projects/<project>/tickets with gitoria's own API token: tickets takes the
10. // author from the token (there is no author field), so the ticket says in its text who opened it here.
11. // Config (environment, or `.env` beside project.hl — never printed):
12. // GITORIA_TICKETS_URL default https://tickets.worldapi.org
13. // GITORIA_TICKETS_TOKEN the API token (tkt_…) of the tickets user "gitoria" — without it the list still shows,
14. // opening a ticket says it is not set up
15. import { fetch } from 'hl:fetch'
16. import { envOr, hostOnly, plainError } from './users.hl'
18. static NL = "
19. "
21. static ticketsRaw = envOr('GITORIA_TICKETS_URL', 'https://tickets.worldapi.org')
22. static ticketsUrl = ticketsRaw.endsWith('/') ? ticketsRaw.slice(0, ticketsRaw.length - 1) : ticketsRaw
23. static ticketsToken = envOr('GITORIA_TICKETS_TOKEN', '')
24. static maxRows = 200
26. static ticketsProject = (slug) => { return slug + '.' + hostOnly }
28. // one row for the page (a state's words are shown as tickets writes them)
29. static viewOf = (t) => {
30. return { number = t.number subject = t.subject state = t.state stateSlug = t.stateSlug created = t.created updated = t.updated url = ticketsUrl + t.href }
31. }
33. // the repo's tickets, newest update first (tickets' order): { tickets, count, truncated, project, url } or { error }
34. static loadTickets = (slug) => {
35. let project = ticketsProject(slug)
36. let r = fetch(ticketsUrl + '/api/projects/' + project + '/tickets', { method = 'GET' headers = { 'user-agent' = 'gitoria.worldapi.org (tickets)' } timeoutMs = 10000 })
37. if (r == null || r.status == null || r.status == 0) { return { error = 'tickets.worldapi.org did not answer' } }
38. let base = { project = project url = ticketsUrl + '/projects/' + project }
39. if (r.status == 404) { base.tickets = [] base.count = 0 base.truncated = false return base }
40. let j = r.status == 200 ? r.json() : null
41. if (j == null || j.tickets == null) { return { error = 'tickets.worldapi.org answered ' + r.status } }
42. let out = []
43. for (t of j.tickets) { if (out.length < maxRows) { out.push(viewOf(t)) } }
44. base.tickets = out
45. base.count = j.tickets.length
46. base.truncated = j.tickets.length > out.length
47. return base
48. }
50. // open a ticket for a repo as `name` (a display name): { ticket } or { error, field }
51. static openTicket = (slug, name, subject, summary) => {
52. let s = subject == null ? '' : ('' + subject).trim()
53. if (s == '') { return { error = 'the ticket needs a subject' field = 'subject' } }
54. let bad = plainError(s, 200, 'the subject')
55. if (bad != null) { return { error = bad field = 'subject' } }
56. let body = summary == null ? '' : ('' + summary).trim()
57. if (body.length > 20000) { return { error = 'the text is too long (at most 20000 characters)' field = 'summary' } }
58. if (ticketsToken == '') { return { error = 'opening tickets is not set up on this server (GITORIA_TICKETS_TOKEN missing)' field = '' } }
59. let text = (body == '' ? '' : body + NL + NL) + '— opened by ' + name + ' in gitoria'
60. let r = fetch(ticketsUrl + '/api/projects/' + ticketsProject(slug) + '/tickets', { method = 'POST' json = { subject = s summary = text } headers = { 'user-agent' = 'gitoria.worldapi.org (tickets)' 'authorization' = 'Bearer ' + ticketsToken } timeoutMs = 10000 })
61. if (r == null || r.status == null || r.status == 0) { return { error = 'tickets.worldapi.org did not answer' field = '' } }
62. let j = r.json()
63. if (r.status != 201 || j == null || j.ticket == null) {
64. let why = j != null && j.error != null ? ': ' + j.error : ''
65. return { error = 'tickets.worldapi.org refused the ticket (' + r.status + why + ')' field = '' }
66. }
67. return { ticket = viewOf(j.ticket) }
68. }