ident

4.6 KB

1. // lib/notify-helpers.hl — what lib/notify.hl looks up: the checks of a kind name, a text and a URL, the time
2. // stamp, the two orders (newest first, by name), on/off words. No table access. Statics only.
3. import { timestamp } from 'hl:time'
4. import { countOf, hasControl, urlChars } from './util.hl'
6. static maxName = 60
7. static maxText = 2000
8. static maxUrl = 2000
10. static bool = (v) => { return v == true }
11. static onOff = (b) => { return b ? 'on' : 'off' }
13. // "YYYY-MM-DD HH:MM UTC" (hl:time knows no zones, hybriel #11)
14. static stamp = (ms) => {
15. if (ms == null) { return '' }
16. t = timestamp(ms)
17. return t.slice(0, 10) + ' ' + t.slice(11, 16) + ' UTC'
18. }
20. // NEWEST FIRST by `created` (a tie by the id); insertion sort by hand (no list sort(), hybriel #6)
21. static idAfter = (a, b) => {
22. let i = 0
23. while (i < a.length && i < b.length) {
24. let x = a.charCodeAt(i)
25. let y = b.charCodeAt(i)
26. if (x != y) { return x > y }
27. i = i + 1
28. }
29. return a.length > b.length
30. }
31. static newerThan = (a, b) => {
32. ca = a.created == null ? 0 : a.created
33. cb = b.created == null ? 0 : b.created
34. if (ca != cb) { return ca > cb }
35. return idAfter(a.id, b.id)
36. }
37. static newestFirst = (list) => {
38. out = []
39. if (countOf(list) == 0) { return out }
40. for (x of list) { out.push(x) }
41. let i = 1
42. while (i < out.length) {
43. let cur = out[i]
44. let j = i - 1
45. while (j >= 0 && newerThan(cur, out[j])) {
46. out[j + 1] = out[j]
47. j = j - 1
48. }
49. out[j + 1] = cur
50. i = i + 1
51. }
52. return out
53. }
54. // kinds by name, A-Z (char codes)
55. static nameBefore = (a, b) => {
56. x = a.name.toLowerCase()
57. y = b.name.toLowerCase()
58. let i = 0
59. while (i < x.length && i < y.length) {
60. if (x.charCodeAt(i) != y.charCodeAt(i)) { return x.charCodeAt(i) < y.charCodeAt(i) }
61. i = i + 1
62. }
63. return x.length < y.length
64. }
65. static byName = (list) => {
66. out = []
67. if (countOf(list) == 0) { return out }
68. for (x of list) { out.push(x) }
69. let i = 1
70. while (i < out.length) {
71. let cur = out[i]
72. let j = i - 1
73. while (j >= 0 && nameBefore(cur, out[j])) {
74. out[j + 1] = out[j]
75. j = j - 1
76. }
77. out[j + 1] = cur
78. i = i + 1
79. }
80. return out
81. }
83. // ---- validation -------------------------------------------------------------------------
84. // A KIND NAME / NOTIFICATION NAME: trimmed, 1-60 chars, one line. Answers { name } or { error }.
85. static checkKindName = (v, what) => {
86. if (v == null || hlTypeName(v) != 'String') { return { error = 'field ' + what + ' must be a string' } }
87. t = v.trim()
88. if (t == '') { return { error = 'field ' + what + ' is empty' } }
89. if (t.length > maxName) { return { error = 'field ' + what + ' is longer than ' + maxName + ' characters' } }
90. if (hasControl(t)) { return { error = 'field ' + what + ' contains a control character' } }
91. return { name = t }
92. }
93. // THE TEXT: 1-2000 chars (Markdown by the worldapi convention; shown as plain text with
94. // its line breaks); tab, line feed and carriage return are the only control characters
95. static checkText = (v) => {
96. if (v == null || hlTypeName(v) != 'String') { return { error = 'field text must be a string' } }
97. t = v.trim()
98. if (t == '') { return { error = 'field text is empty' } }
99. if (t.length > maxText) { return { error = 'field text is longer than ' + maxText + ' characters' } }
100. let i = 0
101. while (i < t.length) {
102. let c = t.charCodeAt(i)
103. if ((c < 32 && c != 9 && c != 10 && c != 13) || c == 127) { return { error = 'field text contains a control character' } }
104. i = i + 1
105. }
106. return { text = t }
107. }
108. // AN ICON / ACTION LINK: an absolute http(s) URL, printable URL characters only, ≤ 2000
109. static checkUrl = (v, what) => {
110. if (v == null || hlTypeName(v) != 'String') { return { error = 'field ' + what + ' must be a string' } }
111. t = v.trim()
112. if (t.length > maxUrl) { return { error = 'field ' + what + ' is longer than ' + maxUrl + ' characters' } }
113. let i = 0
114. while (i < t.length) {
115. if (!urlChars.includes(t[i])) { return { error = 'field ' + what + ' contains a character that is not allowed in a URL' } }
116. i = i + 1
117. }
118. lower = t.toLowerCase()
119. scheme = lower.slice(0, 7) == 'http://' ? 7 : (lower.slice(0, 8) == 'https://' ? 8 : 0)
120. if (scheme == 0) { return { error = 'field ' + what + ' must be an http:// or https:// URL' } }
121. rest = t.slice(scheme, t.length)
122. if (rest == '' || rest[0] == '/' || rest[0] == '?') { return { error = 'field ' + what + ' has no host' } }
123. return { url = t }
124. }
126. // a user's switch over the app's preset: 'on' / 'off', or '' = the preset
127. static switchValue = (userValue, preset) => {
128. if (userValue == 'on') { return true }
129. if (userValue == 'off') { return false }
130. return preset
131. }
132. static kindRowOut = (k) => { return { name = k.name push = bool(k.push) email = bool(k.email) } }
133. static unreadCount = (rows) => {
134. let n = 0
135. for (r of rows) { if (r.unread) { n = n + 1 } }
136. return n
137. }