tickets

9.7 KB

1. // project.hl — tickets.worldapi.org: THE MAP. Config, routes and WHO HEARS WHAT; the logic lives in lib/.
2. //
3. // WHERE THINGS ARE (one line per feature; README.md "Files" has the full list):
4. // tickets, their states and relations (parent / blocked-by) lib/tickets.hl (state names, page shapes: lib/tickets-helpers.hl)
5. // the history of a ticket (events) lib/events.hl
6. // projects, members, roles, slugs lib/projects.hl
7. // users, login through ident, API tokens, sessions lib/users.hl
8. // invites to a project (ident#22) lib/invites.hl
9. // connecting an app to a project (ticket #21) lib/connections.hl
10. // Markdown in text fields / the Markdown read view lib/markdown.hl / lib/mdview.hl
11. // the JSON API + /login/callback, /connect, /tickets/:ref lib/api.hl (plumbing: lib/api-helpers.hl, lib/jsoncheck.hl)
12. // the ticket #20 data migration (every start) lib/migrate.hl
13. // the ticket-file format of the import lib/import.hl (the import tool: tools/import.hl)
14. // shared small helpers (env, storage dir, URLs, sorting, Vienna time) lib/util.hl
15. // pages: shell, list, ticket, inbox, you, new project, settings, connect components/*.hl; CSS components/styles.hl
16. import WebFramework from 'hl:web'
17. import { env } from 'hl:proc'
19. import Styles from './components/styles.hl'
20. import { dark, darker } from './shared/tokens.hl'
21. import { migrateAll } from './lib/migrate.hl'
22. import { tagOf } from './lib/users.hl'
23. import { postTicket, getTicket, postComment, postState, postEdit, postAssign, postParent, postBlockers, getProjects, getInbox, getProject, postMembers, postMemberRemove, postInvites, connectExchange, projectConnections, projectDisconnect, connectStart, projectTickets, getProjectTicket, postProjectComment, postProjectState, postProjectEdit, postProjectAssign, postProjectParent, postProjectBlockers, oldTicketPage, loginCallback } from './lib/api.hl'
25. import TicketList from './components/ticket_list.hl'
26. import Ticket from './components/ticket.hl'
27. import Inbox from './components/inbox.hl'
28. import You from './components/you.hl'
29. import NewProject from './components/new_project.hl'
30. import Settings from './components/settings.hl'
31. import Connect from './components/connect.hl'
33. static siteName = "tickets"
35. appTitle = siteName
36. styles = Styles
38. // ---- THE INSTALLABLE APP (mission 046), the same way calendar.worldapi.org does it: hl:web's own web app manifest
39. // (/__hl/manifest.webmanifest, linked from every head with the apple-touch-icon and theme-color) and service worker
40. // (/__hl/sw.js) from these settings — no JavaScript of ours. Icons in icons/ (icon.svg, a ticket stub, is the source;
41. // the PNGs and favicon.ico are rendered from it with rsvg-convert / magick, README "PWA"). The theme colour is the
42. // header's background (darker, as tracker), the splash background the page's (dark) — both off the tokens, not written out again.
43. appThemeColor = darker.value
44. appBackgroundColor = dark.value
45. appIcons = [
46. { src = '/icons/icon-192.png' sizes = '192x192' purpose = 'any' }
47. { src = '/icons/icon-512.png' sizes = '512x512' purpose = 'any' }
48. { src = '/icons/icon-192.png' sizes = '192x192' purpose = 'maskable' }
49. { src = '/icons/icon-512.png' sizes = '512x512' purpose = 'maskable' }
50. ]
51. appTouchIcon = '/icons/apple-touch-icon.png'
52. appFavicon = '/icons/icon.svg'
53. // OFFLINE: the shell and `/` — `/` IS the ticket list, so offline it shows the list as this browser last loaded it,
54. // and the shell (components/main.hl) says "You are offline". Its value-form emits are never queued. Other pages are
55. // not kept, except a project list (/projects/<slug>, same component) this browser visited; the rest get hl:web's
56. // "Unavailable offline" page.
57. offline = [ TicketList ]
59. // ---- THE ROUTES: files, the function routes (lib/api.hl), the pages (components/) ----------------
60. routes = [
61. { pattern = "/favicon.ico" file = "./icons/favicon.ico" headers = { 'Cache-Control' = 'no-cache' } }
62. // the installable app (mission 046): the icons (manifest and service worker are hl:web's own, from appIcons / offline)
63. { pattern = "/icons/icon-192.png" file = "./icons/icon-192.png" headers = { 'Cache-Control' = 'no-cache' } }
64. { pattern = "/icons/icon-512.png" file = "./icons/icon-512.png" headers = { 'Cache-Control' = 'no-cache' } }
65. { pattern = "/icons/apple-touch-icon.png" file = "./icons/apple-touch-icon.png" headers = { 'Cache-Control' = 'no-cache' } }
66. { pattern = "/icons/icon.svg" file = "./icons/icon.svg" headers = { 'Cache-Control' = 'no-cache' } }
67. // the login button's return (ticket #7): it needs the request's session and the framework's session store, BY REFERENCE
68. { pattern = "/login/callback" function = (route, req) => { return loginCallback(route, &req, &server.sessions) } }
69. { pattern = "/login.js" file = "./login.js" headers = { 'Cache-Control' = 'no-cache' } }
70. // ticket #12 (mission 024): the Markdown editor <md-editor>, vendored from worldapi-components
71. { pattern = "/md-editor.js" file = "./shared/md-editor.js" headers = { 'Cache-Control' = 'no-cache' } }
72. { pattern = "/api/tickets" function = postTicket }
73. { pattern = "/api/tickets/:ref" function = getTicket }
74. { pattern = "/api/tickets/:ref/comments" function = postComment }
75. { pattern = "/api/tickets/:ref/state" function = postState }
76. { pattern = "/api/tickets/:ref/edit" function = postEdit }
77. { pattern = "/api/tickets/:ref/assign" function = postAssign }
78. { pattern = "/api/tickets/:ref/parent" function = postParent }
79. { pattern = "/api/tickets/:ref/blocked-by" function = postBlockers }
80. { pattern = "/api/projects" function = getProjects }
81. { pattern = "/api/inbox" function = getInbox }
82. { pattern = "/api/projects/:slug" function = getProject }
83. { pattern = "/api/projects/:slug/members" function = postMembers }
84. { pattern = "/api/projects/:slug/members/remove" function = postMemberRemove }
85. { pattern = "/api/projects/:slug/invites" function = postInvites }
86. { pattern = "/api/connect/exchange" function = connectExchange }
87. { pattern = "/api/projects/:slug/connections" function = projectConnections }
88. { pattern = "/api/projects/:slug/connections/remove" function = projectDisconnect }
89. { pattern = "/connect" function = connectStart }
90. { pattern = "/api/projects/:slug/tickets" function = projectTickets }
91. { pattern = "/api/projects/:slug/tickets/:number" function = getProjectTicket }
92. { pattern = "/api/projects/:slug/tickets/:number/comments" function = postProjectComment }
93. { pattern = "/api/projects/:slug/tickets/:number/state" function = postProjectState }
94. { pattern = "/api/projects/:slug/tickets/:number/edit" function = postProjectEdit }
95. { pattern = "/api/projects/:slug/tickets/:number/assign" function = postProjectAssign }
96. { pattern = "/api/projects/:slug/tickets/:number/parent" function = postProjectParent }
97. { pattern = "/api/projects/:slug/tickets/:number/blocked-by" function = postProjectBlockers }
98. { pattern = "/" component = TicketList }
99. { pattern = "/project/:projectName" component = TicketList }
100. { pattern = "/projects/:projectName" component = TicketList }
101. { pattern = "/state/:stateSlug" component = TicketList }
102. { pattern = "/project/:projectName/state/:stateSlug" component = TicketList }
103. { pattern = "/inbox" component = Inbox }
104. { pattern = "/new-project" component = NewProject }
105. { pattern = "/connect/:nonce" component = Connect }
106. { pattern = "/projects/:projectSlug/settings" component = Settings }
107. { pattern = "/you" component = You }
108. { pattern = "/projects/:projectSlug/:ticketNumber" component = Ticket }
109. // OLD PAGE URLS (`/tickets/<old global number>`, also `/tickets/<uuid>`) → 301 to `/projects/<slug>/<number>`
110. { pattern = "/tickets/:ref" function = oldTicketPage }
111. ]
113. // WHO GETS THE PUSH: tickets and events are public (reading needs no login). A frame
114. // reaches a connection only if a mounted component listens for it.
115. // `signedIn` / `signedOut` (ticket #7) go to the tabs of ONE session: the one whose login
116. // carries that random tag (session.data.tag, set at login) — every page of it switches to
117. // logged in / out without a reload.
118. audience = {
119. ticketCreated = (row, session) => { return true }
120. ticketEvent = (ticketId, ev, row, session) => { return true }
121. // ticket #4: the relation views (tickets-helpers.hl relationViewOf) of a ticket and its related ones
122. ticketsRelated = (views, session) => { return true }
123. // ticket #21: an app was connected / disconnected — the project page refreshes its line
124. connectionsChanged = (slug, session) => { return true }
125. signedIn = (tag, info, session) => { return tag != null && tagOf(session) == tag }
126. signedOut = (tag, session) => { return tag != null && tagOf(session) == tag }
127. }
129. sessionDir = env('TICKETS_SESSIONS') != null ? env('TICKETS_SESSIONS') : null
130. port = env('TICKETS_PORT') != null ? toNumber(env('TICKETS_PORT')) : 8350
131. // THE LISTENER's interface (mission 010, deploy to Byrodin): hl:web reads HL_HOST (or HOST)
132. // itself (hybriel#24): 127.0.0.1 on Byrodin behind nginx; unset = 0.0.0.0 (dev on Loreana).
133. // TICKETS_WATCH=0 turns the dev watcher off (the container: a deploy is an rsync + restart,
134. // half-copied .hl files must not be re-analysed); unset = on, as before.
135. watching = env('TICKETS_WATCH') != '0'
136. // THE MIGRATION of ticket #20 (lib/migrate.hl): idempotent, runs at every start
137. for (line of migrateAll()) { console.log('migrated: ' + line) }
138. server = new WebFramework(routes = routes, styles = styles, minify = true, port = port, watchMode = watching)
140. // THE GLOBAL ERROR HANDLER (ticket #7): a plugin's failure — above all hl:fetch's refused /
141. // timed-out exchange with ident (users.hl exchangeCode, invites.hl) — arrives here instead of aborting the
142. // request with a 500 that shows source paths; the failed call yields null and the caller answers
143. // it ("ident did not answer"). Every absorbed error is logged.
144. on Error(e) { console.log('error absorbed: ' + e.message) }