calendar

5.0 KB

1. // lib/events-helpers.hl — what lib/events.hl looks up (calendar mission 001, code order): the size limits, what the
2. // page sends → a WorldAPI Event record (build), a stored event → what the page shows (viewOf), the temporary ids of
3. // events made offline, the window check of the faces and the order by start.
4. import { isText, isDate, isTime, isZone, nextDay, prevDay, before } from '../components/month-view/dates.hl'
5. import { toReminders, toRows } from '../components/month-view/reminders.hl'
7. static maxTitle = 200
8. static maxPlace = 200
9. static maxNotes = 5000
11. // what the page sends: { id?, custom, reminders (rows), title, allDay, startDate, startTime, endDate, endTime, place, notes, zone }
12. // → { error } or { record } (a WorldAPI Event without owner/id). endDate/endTime may be empty (no end); all-day: the
13. // last day, inclusive ('' = one day).
14. static build = (b) => {
15. if (b == null || hlTypeName(b) != 'Hybrid') { return { error = 'the event must be an object' } }
16. if (!isText(b.title) || b.title.trim() == '') { return { error = 'the event needs a title' } }
17. if (b.title.length > maxTitle) { return { error = 'the title is too long (at most ' + maxTitle + ' characters)' } }
18. if (!isText(b.place) || b.place.length > maxPlace) { return { error = 'the place is too long (at most ' + maxPlace + ' characters)' } }
19. if (!isText(b.notes) || b.notes.length > maxNotes) { return { error = 'the notes are too long (at most ' + maxNotes + ' characters)' } }
20. if (b.allDay != true && b.allDay != false) { return { error = 'allDay must be true or false' } }
21. if (!isDate(b.startDate)) { return { error = 'the start date is not a date' } }
22. if (!isZone(b.zone)) { return { error = 'the time zone is missing' } }
23. let r = {}
24. r['$type'] = 'event'
25. r['$version'] = 1
26. r['$title'] = b.title.trim()
27. if (b.notes.trim() != '') { r['$description'] = b.notes }
28. if (b.place.trim() != '') { r['$location'] = b.place.trim() }
29. r['$status'] = 'confirmed'
30. r['$visibility'] = 'private'
31. // no own reminders: `$reminders` stays out and the calendar's apply; own ones (also none at all) are written
32. if (b.custom == true) {
33. let rem = toReminders(b.reminders)
34. if (rem.error != null) { return { error = rem.error } }
35. r['$reminders'] = rem.reminders
36. }
37. if (b.allDay) {
38. r['$kind'] = 'allday'
39. r['$start'] = b.startDate
40. if (isText(b.endDate) && b.endDate != '') {
41. if (!isDate(b.endDate)) { return { error = 'the end date is not a date' } }
42. if (before(b.endDate, b.startDate)) { return { error = 'the end is before the start' } }
43. if (b.endDate != b.startDate) { r['$end'] = nextDay(b.endDate) }
44. }
45. return { record = r }
46. }
47. if (!isTime(b.startTime)) { return { error = 'the start time is not a time' } }
48. r['$kind'] = 'appointment'
49. r['$timezone'] = b.zone
50. r['$start'] = b.startDate + 'T' + b.startTime + ':00'
51. let hasEnd = (isText(b.endDate) && b.endDate != '') || (isText(b.endTime) && b.endTime != '')
52. if (hasEnd) {
53. let ed = isText(b.endDate) && b.endDate != '' ? b.endDate : b.startDate
54. if (!isDate(ed)) { return { error = 'the end date is not a date' } }
55. if (!isTime(b.endTime)) { return { error = 'the end time is not a time' } }
56. let end = ed + 'T' + b.endTime + ':00'
57. if (before(end, r['$start'])) { return { error = 'the end is before the start' } }
58. r['$end'] = end
59. }
60. return { record = r }
61. }
63. // what the page shows of a stored event: first / last day (inclusive), times, texts
64. static viewOf = (e) => {
65. let allDay = e['$kind'] == 'allday'
66. let start = e['$start']
67. let end = e['$end']
68. let first = start.slice(0, 10)
69. let last = first
70. if (allDay) {
71. if (end != null) { last = prevDay(end) }
72. } else if (end != null) {
73. last = end.slice(0, 10)
74. }
75. let v = { id = e.id title = e['$title'] allDay = allDay first = first last = last
76. startDate = first startTime = allDay ? '' : start.slice(11, 16)
77. endDate = end == null ? '' : last endTime = allDay || end == null ? '' : end.slice(11, 16)
78. place = e['$location'] == null ? '' : e['$location'] notes = e['$description'] == null ? '' : e['$description']
79. start = start zone = e['$timezone'] == null ? '' : e['$timezone']
80. custom = e['$reminders'] != null rows = e['$reminders'] == null ? [] : toRows(e['$reminders']) }
81. return v
82. }
84. // an event made offline carries a temporary id `local-…` until the page reloads; the server keeps it as `ref`, so an edit
85. // (or delete) sent with that id reaches the same event instead of making a second one
86. static isLocalId = (id) => { return isText(id) && id.length > 6 && id.length <= 60 && id.slice(0, 6) == 'local-' }
88. // the window is two dates the page shows; anything else is refused
89. static validWindow = (first, last) => { return isDate(first) && isDate(last) }
91. // the views ordered by start (a hand-written selection sort)
92. static byStart = (views) => {
93. let m = views.length
94. let out = []
95. let used = []
96. let i = 0
97. while (i < m) { used.push(false) i = i + 1 }
98. let round = 0
99. while (round < m) {
100. let best = -1
101. let j = 0
102. while (j < m) {
103. if (!used[j] && (best < 0 || before(views[j].start, views[best].start))) { best = j }
104. j = j + 1
105. }
106. used[best] = true
107. out.push(views[best])
108. round = round + 1
109. }
110. return out
111. }