calendar

7.0 KB

1. // reminders.hl — THE REMINDERS (ticket calendar#4), shared by the server (events.hl checks and stores them) and the
2. // month view in the browser (the editor rows, the notification times).
3. // Stored as WorldAPI Event `$reminders` (https://worldapi.org/standards/event): `{ $before: 'PT30M' }` (30 minutes, or 'PT2H'
4. // hours before the start) and `{ $days_before: 1, $time: '20:00' }` (that many days before, at that wall-clock time).
5. // The page edits them as ROWS: { unit = 'minutes' | 'hours' | 'days' n = '30' time = '20:00' } (all text).
6. // Event without `$reminders` = inherits the calendar's; `[]` = none.
7. import { isText, isTime, pad, prevDay, nextDay } from './dates.hl'
9. static maxRows = 8
10. static defaultRows = [
11. { unit = 'hours' n = '1' time = '09:00' }
12. { unit = 'days' n = '1' time = '20:00' }
13. ]
15. // digits only, no sign, no leading noise; 1..5 digits
16. static isCount = (s) => {
17. if (!isText(s) || s.length < 1 || s.length > 5) { return false }
18. let i = 0
19. while (i < s.length) {
20. let c = s.charCodeAt(i)
21. if (c < 48 || c > 57) { return false }
22. i = i + 1
23. }
24. return true
25. }
27. // rows the page sent → { error } or { reminders } (the stored `$reminders` list)
28. static toReminders = (rows) => {
29. if (rows == null || hlTypeName(rows) != 'Hybrid') { return { error = 'the reminders must be a list' } }
30. if (rows.length > maxRows) { return { error = 'at most ' + maxRows + ' reminders' } }
31. let out = []
32. let i = 0
33. while (i < rows.length) {
34. let r = rows[i]
35. if (r == null || hlTypeName(r) != 'Hybrid' || !isCount(r.n)) { return { error = 'a reminder needs a whole number' } }
36. let n = toNumber(r.n)
37. if (r.unit == 'minutes') {
38. if (n < 1 || n > 10080) { return { error = 'minutes must be 1 to 10080' } }
39. let o = {}
40. o['$before'] = 'PT' + n + 'M'
41. out.push(o)
42. } else if (r.unit == 'hours') {
43. if (n < 1 || n > 168) { return { error = 'hours must be 1 to 168' } }
44. let o = {}
45. o['$before'] = 'PT' + n + 'H'
46. out.push(o)
47. } else if (r.unit == 'days') {
48. if (n > 30) { return { error = 'days must be 0 to 30' } }
49. if (!isTime(r.time)) { return { error = 'a day reminder needs a time' } }
50. let o = {}
51. o['$days_before'] = n
52. o['$time'] = r.time
53. out.push(o)
54. } else { return { error = 'a reminder is minutes, hours or days before' } }
55. i = i + 1
56. }
57. return { reminders = out }
58. }
60. // the stored `$reminders` → rows for the editor (what is not ours to read is left out)
61. static toRows = (list) => {
62. let out = []
63. if (list == null) { return out }
64. let i = 0
65. while (i < list.length) {
66. let r = list[i]
67. let b = r['$before']
68. if (isText(b) && b.length > 3 && b.slice(0, 2) == 'PT') {
69. let unit = b.slice(b.length - 1) == 'H' ? 'hours' : 'minutes'
70. let digits = b.slice(2, b.length - 1)
71. if ((b.slice(b.length - 1) == 'H' || b.slice(b.length - 1) == 'M') && isCount(digits)) { out.push({ unit = unit n = digits time = '09:00' }) }
72. } else if (r['$days_before'] != null && isTime(r['$time'])) {
73. out.push({ unit = 'days' n = '' + r['$days_before'] time = r['$time'] })
74. }
75. i = i + 1
76. }
77. return out
78. }
80. // a date moved by n days (n may be negative)
81. static shift = (date, n) => {
82. let d = date
83. let k = n
84. while (k > 0) { d = nextDay(d) k = k - 1 }
85. while (k < 0) { d = prevDay(d) k = k + 1 }
86. return d
87. }
89. // rows for a list in the editor: each carries its position `i` and the class that shows the time only for days
90. static withIndex = (rows) => {
91. let out = []
92. let i = 0
93. while (i < rows.length) {
94. let r = rows[i]
95. out.push({ i = i unit = r.unit n = r.n time = r.time cls = r.unit == 'days' ? 'days' : 'other' })
96. i = i + 1
97. }
98. return out
99. }
101. static plural = (n, one, many) => { return n + ' ' + (n == 1 ? one : many) }
103. // one row as words: "1 hour before", "the day before at 20:00", "2 days before at 09:00", "the same day at 08:00"
104. static describeRow = (r) => {
105. let n = toNumber(r.n)
106. if (r.unit == 'minutes') { return plural(n, 'minute', 'minutes') + ' before' }
107. if (r.unit == 'hours') { return plural(n, 'hour', 'hours') + ' before' }
108. if (n == 0) { return 'the same day at ' + r.time }
109. if (n == 1) { return 'the day before at ' + r.time }
110. return n + ' days before at ' + r.time
111. }
113. static describe = (rows) => {
114. if (rows == null || rows.length == 0) { return 'no reminders' }
115. let out = ''
116. let i = 0
117. while (i < rows.length) {
118. out = out + (i == 0 ? '' : ', ') + describeRow(rows[i])
119. i = i + 1
120. }
121. return out
122. }
124. // ---- browser side: the time a reminder fires (epoch ms) --------------------------------------------------
125. // The wall clock of a time zone as an offset (ms) from UTC at the instant t.
126. static offsetOf = (zone, t) => {
127. let f = Intl.DateTimeFormat('en-US', { timeZone = zone hourCycle = 'h23' year = 'numeric' month = 'numeric' day = 'numeric' hour = 'numeric' minute = 'numeric' second = 'numeric' })
128. let parts = f.formatToParts(new Date(t))
129. let v = { year = 0 month = 1 day = 1 hour = 0 minute = 0 second = 0 }
130. let i = 0
131. while (i < parts.length) {
132. let p = parts[i]
133. if (p.type != 'literal') { v[p.type] = toNumber(p.value) }
134. i = i + 1
135. }
136. return Date.UTC(v.year, v.month - 1, v.day, v.hour, v.minute, v.second) - (t - t % 1000)
137. }
139. // 'YYYY-MM-DDTHH:MM:SS' wall clock in `zone` ('' = the device's own zone) → the instant, epoch ms
140. static instantOf = (wall, zone) => {
141. let y = toNumber(wall.slice(0, 4))
142. let mo = toNumber(wall.slice(5, 7))
143. let d = toNumber(wall.slice(8, 10))
144. let h = toNumber(wall.slice(11, 13))
145. let mi = toNumber(wall.slice(14, 16))
146. if (zone == null || zone == '') { return new Date(y, mo - 1, d, h, mi, 0).getTime() }
147. let guess = Date.UTC(y, mo - 1, d, h, mi, 0)
148. let t = guess - offsetOf(zone, guess)
149. return guess - offsetOf(zone, t)
150. }
152. // the words of the notification (title = the event's title)
153. static bodyOf = (ev, r) => {
154. let at = ev.allDay ? '' : ' at ' + ev.startTime
155. let text = ''
156. if (r.unit == 'minutes') { text = 'Starts in ' + plural(toNumber(r.n), 'minute', 'minutes') }
157. else if (r.unit == 'hours') { text = 'Starts in ' + plural(toNumber(r.n), 'hour', 'hours') }
158. else {
159. let n = toNumber(r.n)
160. text = n == 0 ? 'Today' + at : (n == 1 ? 'Tomorrow' + at : 'In ' + n + ' days' + at + ', ' + ev.startDate)
161. }
162. return ev.place != '' ? text + ' · ' + ev.place : text
163. }
165. // the events { id title allDay startDate startTime place zone rows } → the reminders still to come:
166. // [{ key, at, title, body }] within `horizon` ms of `nowMs`
167. static plan = (events, nowMs, horizon) => {
168. let out = []
169. let i = 0
170. while (i < events.length) {
171. let ev = events[i]
172. let zone = ev.allDay ? '' : ev.zone
173. let startWall = ev.startDate + 'T' + (ev.allDay ? '00:00' : ev.startTime) + ':00'
174. let start = instantOf(startWall, zone)
175. let j = 0
176. while (j < ev.rows.length) {
177. let r = ev.rows[j]
178. let at = 0
179. if (r.unit == 'minutes') { at = start - toNumber(r.n) * 60000 }
180. else if (r.unit == 'hours') { at = start - toNumber(r.n) * 3600000 }
181. else {
182. let day = ev.startDate
183. let k = toNumber(r.n)
184. while (k > 0) { day = prevDay(day) k = k - 1 }
185. at = instantOf(day + 'T' + r.time + ':00', zone)
186. }
187. if (at > nowMs && at < nowMs + horizon) {
188. out.push({ key = ev.id + ':' + at at = at title = ev.title body = bodyOf(ev, r) })
189. }
190. j = j + 1
191. }
192. i = i + 1
193. }
194. return out
195. }