tickets

9.5 KB

1. // components/settings.hl — `/projects/:projectSlug/settings` (ticket #20): the project's own page for its
2. // admins: title, slug (a new slug keeps the old one working), description (Markdown, <md-editor>) and the
3. // members with their roles (use / edit / admin), invited through ident's invite link (invites.hl) or added
4. // by the ident id / display name of someone who logged in here. Everybody else sees a plain refusal — the
5. // server checks the role in every face.
6. parent './main.hl'
7. import { projectByAnySlug, memberRows, updateProject, setMemberRole, isAdminOf, userByRef, roles, projectRecord } from '../lib/projects.hl'
8. import { removeMember } from '../lib/tickets.hl'
9. import { mayInvite, createInvite } from '../lib/invites.hl'
10. import { siteName } from '../project.hl'
11. import { userOfSession, writerOfSession } from '../lib/users.hl'
13. projectSlug = null
14. session = null
15. project = projectByAnySlug(projectSlug)
16. present = project != null
17. gone = project == null
18. me = userOfSession(session)
19. isAdmin = project != null && isAdminOf(project.id, me)
20. notAdmin = project != null && !isAdmin
21. projectId = project != null ? project.id : ''
22. projectHref = project != null ? '/projects/' + project.slug : '/'
23. title = project != null ? project.title : ''
24. slug = project != null ? project.slug : ''
25. description = project != null && project.description != null ? project.description : ''
26. members = project != null ? memberRows(project.id) : []
27. roleList = roles
28. saveMessage = ''
29. saved = false
30. memberMessage = ''
31. addRef = ''
32. addRole = 'use'
33. inviteRole = 'use'
34. inviteUses = '1'
35. inviteDays = '7'
36. inviteEmail = ''
37. inviteMessage = ''
38. inviteLink = ''
39. hasInviteLink = false
40. __title = siteName + ' | ' + (project != null ? project.title + ' settings' : 'no such project')
42. View {
43. projectSettings {
44. if (gone) { p { id = "gone" class = "empty" "There is no such project." } }
45. if (notAdmin) { p { id = "notadmin" class = "hint" "Only an admin of the project can open its settings. " a { href = projectHref "Back to the project" } } }
46. if (isAdmin) {
47. header {
48. h1 { id = "settingstitle" "Settings of " a { href = projectHref title } }
49. }
50. form { id = "detailsform"
51. on submit(e) {
52. e.preventDefault()
53. emit saveDetails(e)
54. }
55. label { "Title"
56. input { id = "settitle" name = "title" required = "required" maxlength = "100" autocomplete = "off" value = title on input(e) { emit setTitle(e.target.value) } }
57. }
58. label { "Slug (the address of the project; the old one keeps working)"
59. input { id = "setslug" name = "slug" required = "required" maxlength = "100" autocomplete = "off" value = slug on input(e) { emit setSlug(e.target.value) } }
60. }
61. label { "Description"
62. mdEditor { textarea { id = "setdescription" name = "description" rows = "6" value = description on input(e) { emit setDescription(e.target.value) } } }
63. }
64. button { id = "detailssave" type = "submit" "Save" }
65. p { id = "savemessage" class = "message" saveMessage }
66. }
67. section { id = "membersbox"
68. h2 { "Members" }
69. p { class = "muted" "use: comment, and move a ticket between open and review. edit: also open, edit and assign tickets and set any state. admin: also these settings and the members." }
70. ul { id = "members"
71. for (m of members) {
72. li {
73. strong { class = "membername" m.name }
74. select { class = "memberrole" name = "role" value = m.role on change(e) { emit changeRole(m.user, e.target.value) }
75. for (r of roleList) { option { value = r r } }
76. }
77. button { type = "button" class = "quiet danger removemember" "Remove" on click(e) { emit dropMember(m.user) } }
78. }
79. }
80. }
81. p { id = "membermessage" class = "message" memberMessage }
82. form { id = "addform"
83. on submit(e) {
84. e.preventDefault()
85. emit addPerson(e)
86. }
87. label { "Add a person by their ident id or display name"
88. input { id = "addref" name = "person" required = "required" autocomplete = "off" value = addRef on input(e) { emit setAddRef(e.target.value) } }
89. }
90. label { "Role"
91. select { id = "addrole" name = "role" value = addRole on change(e) { emit setAddRole(e.target.value) }
92. for (r of roleList) { option { value = r r } }
93. }
94. }
95. button { id = "addsave" type = "submit" "Add member" }
96. }
97. }
98. section { id = "invitebox"
99. h2 { "Invite" }
100. p { class = "muted" "Ident makes a link; whoever opens it and picks an identity joins with the role you choose. Share it yourself, or give an email address and ident mails it." }
101. form { id = "inviteform"
102. on submit(e) {
103. e.preventDefault()
104. emit sendInvite(e)
105. }
106. label { "Role"
107. select { id = "inviterole" name = "role" value = inviteRole on change(e) { emit setInviteRole(e.target.value) }
108. for (r of roleList) { option { value = r r } }
109. }
110. }
111. label { "People who can use the link"
112. input { id = "inviteuses" name = "uses" inputmode = "numeric" value = inviteUses on input(e) { emit setInviteUses(e.target.value) } }
113. }
114. label { "Valid for (days)"
115. input { id = "invitedays" name = "days" inputmode = "numeric" value = inviteDays on input(e) { emit setInviteDays(e.target.value) } }
116. }
117. label { "Email (optional)"
118. input { id = "inviteemail" name = "email" type = "email" autocomplete = "off" value = inviteEmail on input(e) { emit setInviteEmail(e.target.value) } }
119. }
120. button { id = "invitecreate" type = "submit" "Create invite link" }
121. }
122. p { id = "invitemessage" class = "message" inviteMessage }
123. if (hasInviteLink) { inviteShown { id = "invitelinkbox"
124. p { "The invite link — copy it now, it is not shown again:" }
125. code { id = "invitelink" inviteLink }
126. } }
127. }
128. }
129. }
130. }
132. on setTitle(v) { title = v }
133. on setSlug(v) { slug = v }
134. on setDescription(v) { description = v }
135. on setAddRef(v) { addRef = v }
136. on setAddRole(v) { addRole = v }
137. on setInviteRole(v) { inviteRole = v }
138. on setInviteUses(v) { inviteUses = v }
139. on setInviteDays(v) { inviteDays = v }
140. on setInviteEmail(v) { inviteEmail = v }
142. on saveDetails(e) {
143. r = emit server settingsSave(projectId, title, slug, description)
144. if (r == null || r.error != null) {
145. saveMessage = r != null ? r.error : 'could not save'
146. return null
147. }
148. saveMessage = 'Saved.'
149. title = r.title
150. slug = r.slug
151. projectHref = '/projects/' + r.slug
152. }
154. on changeRole(userId, role) {
155. r = emit server settingsRole(projectId, userId, role)
156. if (r == null || r.error != null) {
157. memberMessage = r != null ? r.error : 'could not change the role'
158. } else {
159. memberMessage = ''
160. }
161. members = r != null && r.members != null ? r.members : members
162. }
164. on dropMember(userId) {
165. r = emit server settingsRemove(projectId, userId)
166. if (r == null || r.error != null) {
167. memberMessage = r != null ? r.error : 'could not remove the member'
168. return null
169. }
170. memberMessage = ''
171. members = r.members
172. }
174. on addPerson(e) {
175. r = emit server settingsAdd(projectId, addRef, addRole)
176. if (r == null || r.error != null) {
177. memberMessage = r != null ? r.error : 'could not add the member'
178. return null
179. }
180. memberMessage = ''
181. addRef = ''
182. members = r.members
183. }
185. on sendInvite(e) {
186. r = emit server settingsInvite(projectId, inviteRole, inviteUses, inviteDays, inviteEmail)
187. if (r == null || r.error != null) {
188. inviteMessage = r != null ? r.error : 'could not create the invite'
189. return null
190. }
191. inviteMessage = r.mailed ? 'Mailed as well.' : ''
192. inviteLink = r.url
193. hasInviteLink = true
194. }
196. // ---- the faces: the writer is the session's user; the store checks the admin role ------------
197. on server settingsSave(projectId, title, slug, description, session) {
198. w = writerOfSession(session)
199. if (w.error != null) { return { error = w.error } }
200. if (hlTypeName(title) != 'String' || hlTypeName(slug) != 'String' || hlTypeName(description) != 'String') { return { error = 'title, slug and description must be text' } }
201. r = updateProject('' + projectId, w.user, title, slug, description)
202. if (r.error != null) { return { error = r.error } }
203. return { title = r.project.title slug = r.project.slug }
204. }
206. on server settingsRole(projectId, userId, role, session) {
207. w = writerOfSession(session)
208. if (w.error != null) { return { error = w.error } }
209. r = setMemberRole('' + projectId, w.user, '' + userId, '' + role)
210. if (r.error != null) { return { error = r.error members = memberRows('' + projectId) } }
211. return { members = r.members }
212. }
214. on server settingsRemove(projectId, userId, session) {
215. w = writerOfSession(session)
216. if (w.error != null) { return { error = w.error } }
217. r = removeMember('' + projectId, w.user, '' + userId)
218. if (r.error != null) { return { error = r.error } }
219. return { members = r.members }
220. }
222. on server settingsAdd(projectId, ref, role, session) {
223. w = writerOfSession(session)
224. if (w.error != null) { return { error = w.error } }
225. f = userByRef('' + ref, null)
226. if (f.error != null) { return { error = f.error } }
227. r = setMemberRole('' + projectId, w.user, f.user.id, '' + role)
228. if (r.error != null) { return { error = r.error } }
229. return { members = r.members }
230. }
232. on server settingsInvite(projectId, role, uses, days, email, session) {
233. w = writerOfSession(session)
234. if (w.error != null) { return { error = w.error } }
235. p = projectRecord('' + projectId)
236. if (p == null) { return { error = 'no such project' } }
237. no = mayInvite(p, w.user, '' + role)
238. if (no != null) { return { error = no.error } }
239. n = toNumber('' + uses)
240. d = toNumber('' + days)
241. if (n == null || n < 1 || n > 1000) { return { error = 'the number of people must be from 1 to 1000' } }
242. if (d == null || d < 1 || d > 90) { return { error = 'the days must be from 1 to 90' } }
243. return createInvite(p.id, '' + role, n, d, '' + email)
244. }