tracker

5.2 KB

1. // shows.hl — READ-ONLY data access for a show's page (tracker.worldapi.org#4): shows, seasons,
2. // episodes, persons, genres (storage/mpackdb/, migrated by tools/migrate.hl, tracker.worldapi.org#2).
3. // Kept apart from watches.hl (the per-user watch state) and from components/show.hl (the page itself)
4. // so /unwatched and /schedule (tickets #5/#6, "reuse, don't copy") can import the same functions.
5. //
6. // No declared index beyond the migration's own ['!oldId'] (opening a table with indexes it wasn't
7. // created with is untested territory, hybriel#21 "opening a table rewrites its files") — a slug
8. // lookup is a linear scan of ~9500 shows, cheap for one page load.
9. import { MPackDB } from 'hl:mpackdb'
10. import { env } from 'hl:proc'
11. import { exists } from 'hl:fs'
13. static envOr = (name, fallback) => {
14. let v = env(name)
15. return v != null && v.trim() != '' ? v.trim() : fallback
16. }
17. static storageDir = envOr('TRACKER_STORAGE', './storage/mpackdb')
19. static genresTable = new MPackDB(file = storageDir + '/genres.db', primaryKey = '@id', indexes = ['!oldId'])
20. static personsTable = new MPackDB(file = storageDir + '/persons.db', primaryKey = '@id', indexes = ['!oldId'])
21. static showsTable = new MPackDB(file = storageDir + '/shows.db', primaryKey = '@id', indexes = ['!oldId'])
22. static seasonsTable = new MPackDB(file = storageDir + '/seasons.db', primaryKey = '@id', indexes = ['!oldId'])
23. static episodesTable = new MPackDB(file = storageDir + '/episodes.db', primaryKey = '@id', indexes = ['!oldId'])
25. // the show with this urlSegment (slug), or null
26. static showBySlug = (slug) => {
27. if (slug == null || hlTypeName(slug) != 'String' || slug == '') { return null }
28. for (s of showsTable.find(null, null)) { if (s.urlSegment == slug) { return s } }
29. return null
30. }
32. static genreById = (id) => { return id == null ? null : genresTable.fetch(id) }
33. static personById = (id) => { return id == null ? null : personsTable.fetch(id) }
34. static seasonById = (id) => { return id == null ? null : seasonsTable.fetch(id) }
35. static showById = (id) => { return id == null ? null : showsTable.fetch(id) }
36. static episodeById = (id) => { return id == null ? null : episodesTable.fetch(id) }
38. // insertion sort, hand-written (no list sort(), hybriel#1) — a show has a handful of seasons at most
39. static insertDesc = (sorted, s) => {
40. let out = []
41. let inserted = false
42. for (x of sorted) {
43. if (!inserted && s.seasonNumber >= x.seasonNumber) { out.push(s) inserted = true }
44. out.push(x)
45. }
46. if (!inserted) { out.push(s) }
47. return out
48. }
49. static insertAsc = (sorted, e) => {
50. let out = []
51. let inserted = false
52. for (x of sorted) {
53. if (!inserted && e.episodeNumber <= x.episodeNumber) { out.push(e) inserted = true }
54. out.push(x)
55. }
56. if (!inserted) { out.push(e) }
57. return out
58. }
60. // a show's seasons, latest (highest seasonNumber) first — creator: "all seasons in reverse order,
61. // latest on top"
62. static seasonsOfShow = (show) => {
63. let sorted = []
64. for (id of show.seasons) {
65. let s = seasonsTable.fetch(id)
66. if (s != null) { sorted = insertDesc(sorted, s) }
67. }
68. return sorted
69. }
71. // a season's episodes, in episode-number order
72. static episodesOfSeason = (season) => {
73. let sorted = []
74. for (id of season.episodes) {
75. let e = episodesTable.fetch(id)
76. if (e != null) { sorted = insertAsc(sorted, e) }
77. }
78. return sorted
79. }
81. // ---- labels shared by every list (tracker.worldapi.org#8) -------------------------------------
82. static pad2 = (n) => {
83. let s = '' + n
84. while (s.length < 2) { s = '0' + s }
85. return s
86. }
88. // an episode as `S01E01` (creator: "write it like that: S01E01") — /my/shows, /my/unwatched, /my/schedule
89. static episodeCode = (seasonNumber, episodeNumber) => { return 'S' + pad2(seasonNumber) + 'E' + pad2(episodeNumber) }
91. // the show's year: `year`, else the first 4 characters of `release` ('YYYY-MM-DD'; 197 migrated shows have
92. // no year, a few of those an empty release) — null when neither gives one
93. static showYear = (show) => {
94. if (show.year != null) { return '' + show.year }
95. if (show.release != null && hlTypeName(show.release) == 'String' && show.release.length >= 4) { return show.release.slice(0, 4) }
96. return null
97. }
99. // a show's title as every list shows it: `Doctor Who (2005)` (creator: so same-named shows can be told apart)
100. static titleWithYear = (show) => {
101. let y = showYear(show)
102. return y != null ? show.title + ' (' + y + ')' : show.title
103. }
105. // the poster file name (oldId + the migrated extension) — null when either is missing; served at
106. // /posters/<name> (project.hl), which falls back to a placeholder when the file itself isn't there
107. // yet (the real poster files are not part of the mongo export, see the report's `open`)
108. static posterName = (show) => {
109. if (show.oldId == null || show.image == null || show.image == '') { return null }
110. return show.oldId + '.' + show.image
111. }
113. // the poster's URL for a LIST (/my/shows, tracker.worldapi.org#8): `/posters/<name>` only when the file really
114. // is in storage/mpackdb/posters/ (project.hl posterRoute reads the same folder), else the ONE placeholder URL
115. // `/posters/none` — the real data has no poster files yet, and 128 different URLs all answering the same
116. // placeholder were 128 requests per page load (the browser can't cache them as one)
117. static posterUrlOf = (show) => {
118. let name = posterName(show)
119. return name != null && exists(storageDir + '/posters/' + name) ? '/posters/' + name : '/posters/none'
120. }