tracker

11.8 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. tracker#28: by a slug → id map (one scan, at the first call) — the old scan of
26. // every record per call (twice per show page) decoded every title's cast + crew: 82 ms per call on the live copy before the
27. // credits, growing with them. A slug the map does not know (a title added since: import, filmography) costs one scan as before
28. // and is remembered; slugs never change. (Flat static written key by key, like people.hl's maps.)
29. static slugIds = {}
30. static slugIdsBuilt = { yes = false }
31. static showBySlug = (&slug) => {
32. if (slug == null || hlTypeName(slug) != 'String' || slug == '') { return null }
33. if (!slugIdsBuilt.yes) {
34. for (s of showsTable.find(null, null)) { if (s.urlSegment != null) { slugIds[s.urlSegment] = s.id } }
35. slugIdsBuilt.yes = true
36. }
37. let id = slugIds[slug]
38. if (id != null) {
39. let hit = showsTable.fetch(id)
40. if (hit != null && hit.urlSegment == slug) { return hit }
41. }
42. for (s of showsTable.find(null, null)) {
43. if (s.urlSegment == slug) {
44. slugIds[slug] = s.id
45. return s
46. }
47. }
48. return null
49. }
51. static genreById = (&id) => { return id == null ? null : genresTable.fetch(id) }
52. // /genres/<genre> (mission 058): the genre with this urlSegment ('Action', 'Sci-Fi-Fantasy'), exact first, else ignoring case
53. // — a scan of the genres table (27 rows)
54. static genreBySlug = (&slug) => {
55. if (slug == null || hlTypeName(slug) != 'String' || slug == '') { return null }
56. let lower = slug.toLowerCase()
57. let loose = null
58. for (g of genresTable.find(null, null)) {
59. if (g.urlSegment == slug) { return g }
60. if (loose == null && g.urlSegment != null && ('' + g.urlSegment).toLowerCase() == lower) { loose = g }
61. }
62. return loose
63. }
64. static personById = (&id) => { return id == null ? null : personsTable.fetch(id) }
65. static seasonById = (&id) => { return id == null ? null : seasonsTable.fetch(id) }
66. static showById = (&id) => { return id == null ? null : showsTable.fetch(id) }
67. static episodeById = (&id) => { return id == null ? null : episodesTable.fetch(id) }
69. // EVERY show / episode (tracker.worldapi.org#13, catalog.hl): read ONCE when the app starts, to build the public lists —
70. // never per request
71. static allShows = () => { return showsTable.find(null, null) }
72. static allEpisodes = () => { return episodesTable.find(null, null) }
74. // insertion sort, hand-written (no list sort(), hybriel#1) — a show has a handful of seasons at most
75. static insertDesc = (&sorted, &s) => {
76. let out = []
77. let inserted = false
78. for (x of sorted) {
79. if (!inserted && s.seasonNumber >= x.seasonNumber) { out.push(s) inserted = true }
80. out.push(x)
81. }
82. if (!inserted) { out.push(s) }
83. return out
84. }
85. static insertAsc = (&sorted, &e) => {
86. let out = []
87. let inserted = false
88. for (x of sorted) {
89. if (!inserted && e.episodeNumber <= x.episodeNumber) { out.push(e) inserted = true }
90. out.push(x)
91. }
92. if (!inserted) { out.push(e) }
93. return out
94. }
96. // a show's seasons, latest (highest seasonNumber) first — creator: "all seasons in reverse order,
97. // latest on top"
98. static seasonsOfShow = (&show) => {
99. let sorted = []
100. for (id of show.seasons) {
101. let s = seasonsTable.fetch(id)
102. if (s != null) { sorted = insertDesc(sorted, s) }
103. }
104. return sorted
105. }
107. // a season's episodes, in episode-number order
108. static episodesOfSeason = (&season) => {
109. let sorted = []
110. for (id of season.episodes) {
111. let e = episodesTable.fetch(id)
112. if (e != null) { sorted = insertAsc(sorted, e) }
113. }
114. return sorted
115. }
117. // ---- labels shared by every list (tracker.worldapi.org#8) -------------------------------------
118. static pad2 = (&n) => {
119. let s = '' + n
120. while (s.length < 2) { s = '0' + s }
121. return s
122. }
124. // an episode as `S01E01` (creator: "write it like that: S01E01") — /my/shows, /my/unwatched, /my/schedule
125. static episodeCode = (&seasonNumber, &episodeNumber) => { return 'S' + pad2(seasonNumber) + 'E' + pad2(episodeNumber) }
127. // the show's year: `year`, else the first 4 characters of `release` ('YYYY-MM-DD'; 197 migrated shows have
128. // no year, a few of those an empty release) — null when neither gives one
129. static showYear = (&show) => {
130. if (show.year != null) { return '' + show.year }
131. if (show.release != null && hlTypeName(show.release) == 'String' && show.release.length >= 4) { return show.release.slice(0, 4) }
132. return null
133. }
135. // a show's title as every list shows it: `Doctor Who (2005)` (creator: so same-named shows can be told apart)
136. static titleWithYear = (&show) => {
137. let y = showYear(show)
138. return y != null ? show.title + ' (' + y + ')' : show.title
139. }
141. // ---- the description (tracker#18) ---------------------------------------------------------------
142. // creator: "i put the summary in an own field for tmdb because some summaries i wanted to rewrite ... in that case the summary
143. // has priority over maze or tmdb" — `summary` (the creator's own text, never written by the sync), else TMDB's `tmdbSummary`,
144. // else TVmaze's `tvmazeSummary` (HTML stripped); '' when none
145. static hasText = (&v) => { return v != null && hlTypeName(v) == 'String' && v.trim() != '' }
146. static summaryOf = (&show) => {
147. if (show == null) { return '' }
148. if (hasText(show.summary)) { return show.summary }
149. if (hasText(show.tmdbSummary)) { return show.tmdbSummary }
150. if (hasText(show.tvmazeSummary)) { return show.tvmazeSummary }
151. return ''
152. }
154. // ---- adult titles (mission 054) -----------------------------------------------------------------
155. // `adult` on every title: true / false from TMDB, null = not known yet (the migrated rows; the app's backfill, tmdbsync.hl
156. // `backfillTitle`, asks TMDB). The PUBLIC lists (catalog.hl: homepage rows, /movies, /shows) and the search (search.hl) show
157. // ONLY a title TMDB says is not adult — unknown counts as hidden. A title the user follows stays on /my/* and its page.
158. static isPublicTitle = (&show) => { return show != null && show.adult == false }
160. // ---- the kind of a title (tracker.worldapi.org#21, mission 068) ----------------------------------------------
161. // A TV title (`type = 'series'`) is either a SERIES (TMDB's TV type Scripted, Miniseries, Documentary) or a SHOW (Reality,
162. // Talk Show, News, Video — or one of our genres Reality / Talk / News, whatever the type). Stored on the title as `kind`
163. // ('series' | 'show') and TMDB's type as `tmdbType`: by the kind backfill (tmdbsync.hl `kindTitle`, one TMDB request per
164. // title without a show genre), the daily sync and the search import. Until a title has `kind`, its genres decide (no
165. // type known yet = series). Movies are `type = 'movie'` and have no kind.
166. static showTmdbTypes = ['Reality', 'Talk Show', 'News', 'Video']
167. static showGenreNames = ['Reality', 'Talk', 'News']
168. static showGenreIdsOf = () => {
169. let out = {}
170. for (g of genresTable.find(null, null)) { if (g.name != null && showGenreNames.includes('' + g.name)) { out[g.id] = true } }
171. return out
172. }
173. // the genre ids that make a title a show — read once (the genres table never changes while the app runs)
174. static showGenreIds = showGenreIdsOf()
175. static hasShowGenre = (&genres) => {
176. if (genres == null) { return false }
177. for (g of genres) { if (showGenreIds[g] == true) { return true } }
178. return false
179. }
180. // 'show' | 'series' from TMDB's type (null = not known) and the title's genre ids
181. static kindOfTitle = (&tmdbType, &genres) => {
182. if (hasShowGenre(genres)) { return 'show' }
183. if (tmdbType != null && showTmdbTypes.includes('' + tmdbType)) { return 'show' }
184. return 'series'
185. }
186. // 'movie' | 'series' | 'show' of a stored title
187. static titleKind = (&show) => {
188. if (show.type == 'movie') { return 'movie' }
189. if (show.kind == 'show' || show.kind == 'series') { return show.kind }
190. return kindOfTitle(show.tmdbType, show.genres)
191. }
192. // a title's own page: /movies/<slug>, /series/<slug>, /shows/<slug> (the old /shows/<slug> of a movie or series answers 301,
193. // project.hl showsRoute)
194. static titlePath = (&show) => {
195. let k = titleKind(show)
196. return (k == 'movie' ? '/movies/' : (k == 'show' ? '/shows/' : '/series/')) + show.urlSegment
197. }
198. // tracker.worldapi.org#20: the type word of a page heading / list label and its colour class (styles.hl `type-*`)
199. static kindWord = (&kind) => { return kind == 'movie' ? 'Movie' : (kind == 'show' ? 'Show' : 'Series') }
200. static typeWordOf = (&show) => { return kindWord(titleKind(show)) }
201. static typeClassOf = (&show) => { return 'type-word type-' + titleKind(show) }
203. // the poster file name (oldId + the migrated extension) — null when either is missing; served at
204. // /posters/<name> (project.hl), which falls back to a placeholder when the file itself isn't there
205. // yet (the real poster files are not part of the mongo export, see the report's `open`)
206. static posterName = (&show) => {
207. if (show.oldId == null || show.image == null || show.image == '') { return null }
208. return show.oldId + '.' + show.image
209. }
211. // the poster's URL for a LIST (/my/shows, tracker.worldapi.org#8): `/posters/<name>` only when the file really
212. // is in storage/mpackdb/posters/ (project.hl posterRoute reads the same folder), else the ONE placeholder URL
213. // `/posters/none` — the real data has no poster files yet, and 128 different URLs all answering the same
214. // placeholder were 128 requests per page load (the browser can't cache them as one)
215. static posterUrlOf = (&show) => {
216. let name = posterName(show)
217. return name != null && exists(storageDir + '/posters/' + name) ? '/posters/' + name : '/posters/none'
218. }
220. // ---- the show on other sites (tracker.worldapi.org#12) ------------------------------------------
221. // the header's link icons: TMDB, IMDb, TheTVDB, TVmaze — ONLY for the ids the show has; a movie (`type = 'movie'`)
222. // gets TMDB + IMDb. TheTVDB's id form is `/dereferrer/series/<id>` (checked 2026-10-01: it and the old
223. // `?tab=series&id=` both 301 to the slug page); the others are the sites' own id URLs (they too 301 to a slug).
224. static hasExternalId = (&v) => { return v != null && ('' + v).trim() != '' }
225. static externalLinksOf = (&show) => {
226. let out = []
227. let movie = show.type == 'movie'
228. if (hasExternalId(show.tmdbId)) { out.push({ site = 'tmdb' label = 'TMDB' title = 'On TMDB' href = 'https://www.themoviedb.org/' + (movie ? 'movie/' : 'tv/') + show.tmdbId }) }
229. if (hasExternalId(show.imdbId)) { out.push({ site = 'imdb' label = 'IMDb' title = 'On IMDb' href = 'https://www.imdb.com/title/' + show.imdbId + '/' }) }
230. if (!movie && hasExternalId(show.tvdbId)) { out.push({ site = 'tvdb' label = 'TVDB' title = 'On TheTVDB' href = 'https://thetvdb.com/dereferrer/series/' + show.tvdbId }) }
231. if (!movie && hasExternalId(show.tvmzId)) { out.push({ site = 'tvmaze' label = 'TVmaze' title = 'On TVmaze' href = 'https://www.tvmaze.com/shows/' + show.tvmzId }) }
232. return out
233. }