tracker

17.4 KB

1. // people.hl — THE PERSON PAGE's data (tracker.worldapi.org#16, components/person.hl `/person/<slug>`): a person by slug,
2. // their facts and filmography, and the ONE-TIME fetch of their whole filmography from TMDB on the first visit. Creator:
3. // "the movies come from artist scrolls. when one clicks on an artist that has no dataset yet the old version fetched that
4. // artist and its entire bibilogrqphy so its profile was complete".
5. //
6. // personBySlug(slug) the person (slug = `urlSegment`) — a slug → id map built once (15k people, one scan)
7. // personInfoOf(p) name, photo URL, born/died lines, bio
8. // filmographyOf(p) their credits (`p.shows`): poster, title, year, role, kind — newest first, adult titles hidden
9. // personFillStep(id) ONE step of the fetch, called again and again by the page until it answers `done`:
10. // 1st call: GET <TMDB>/person/<tmdbId>?append_to_response=combined_credits (ONE request: details +
11. // every cast/crew credit) + the photo (w185, like the posters); the person's facts are updated;
12. // every next call stores the next `fillBatch` titles; the last one links the credits and marks
13. // the person complete (`filmographyAt`, ms). hl:web serves one request at a time — between two
14. // steps every other request is served, so a person with 300 credits never holds the server.
15. //
16. // COMPLETE = `filmographyAt` set: never fetched again (the daily sync may refresh followed people later — not built).
17. // Migrated people are NOT complete (153 of them carry the old tracker's credits — kept, the fetch adds the rest).
18. // A title we don't have → a MINIMAL show record (title, year, type, tmdbId, `adult`, overview, genres by TMDB id, language;
19. // no seasons, no poster file; `minimal = true` — details.hl completes it when it is opened or by the repair job, tracker#26), shaped like search.hl importTitle's
20. // (`oldId tmdb-<tv|movie>-<id>`, a free slug), indexed for the search and put into the public lists (catalog.hl).
21. // The person's credits (`shows`, the migrated field): [{ show, character, posterPath, adult }] — `character` is the role
22. // text (the characters, then crew jobs like "Director", " / " between them); `posterPath` = TMDB's, so the page can show
23. // TMDB's small poster (w92, like search's web rows) until we have the file. ADULT (TMDB's flag, mission 054): a row is
24. // shown only for a PUBLIC title (shows.hl `isPublicTitle`: `adult == false`, unknown hidden like the public lists) whose
25. // credit is not adult either (mission 056 merge).
26. // ONE PROCESS PER STORAGE (hybriel#21); new rows get self-assigned 16-hex ids (hybriel#113), like tmdbsync.hl.
27. import { now } from 'hl:time'
28. import { fetch } from 'hl:fetch'
29. import { randomBytes } from 'hl:crypto'
30. import { writeFile, mkDir, exists } from 'hl:fs'
31. import { personsTable, showsTable, genresTable, storageDir, showById, showYear, posterUrlOf, isPublicTitle } from './shows.hl'
32. import { tmdbGet, tmdbImageBase, textOr } from './tmdbsync.hl'
33. import { titleIdByTmdb, indexShow, slugOf, slugBaseOf, indexPerson } from './search.hl'
34. import { refreshCatalogShow, sortDesc } from './catalog.hl'
36. static profilesDir = storageDir + '/profiles'
37. // titles stored per step (real data: see STATUS.md ticket #16 for the per-step time)
38. static fillBatch = 40
40. static listOr = (v) => { return v == null ? [] : v }
42. // ---- the person -------------------------------------------------------------------------------------------------
43. static slugIndex = { built = false ids = {} }
44. static ensureSlugIndex = () => {
45. if (!slugIndex.built) {
46. let m = {}
47. for (p of personsTable.find(null, null)) { if (p.urlSegment != null) { m[p.urlSegment] = p.id } }
48. slugIndex.ids = m
49. slugIndex.built = true
50. }
51. return true
52. }
53. static personBySlug = (slug) => {
54. if (slug == null || hlTypeName(slug) != 'String' || slug == '') { return null }
55. ensureSlugIndex()
56. let id = slugIndex.ids[slug]
57. return id == null ? null : personsTable.fetch(id)
58. }
60. static isComplete = (p) => { return p.filmographyAt != null }
61. // the page asks TMDB for this person: not complete yet, and TMDB knows them
62. static needsFill = (p) => { return !isComplete(p) && p.tmdbId != null }
64. // the photo: /profiles/<oldId>.<ext> (project.hl profileRoute) — only when the file is there (the migrated `image` = 'jpg'
65. // of 129 people never came with a file)
66. static profileName = (p) => {
67. if (p.oldId == null || p.image == null || p.image == '') { return null }
68. return p.oldId + '.' + p.image
69. }
70. static photoUrlOf = (p) => {
71. let name = profileName(p)
72. return name != null && exists(profilesDir + '/' + name) ? '/profiles/' + name : ''
73. }
75. static monthNames = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']
76. // '1986-03-04' → '4 March 1986'; a bare year or anything else as it is
77. static dateText = (d) => {
78. let t = textOr(d)
79. if (t == null) { return null }
80. if (t.length < 10) { return t }
81. let m = toNumber(t.slice(5, 7))
82. let day = toNumber(t.slice(8, 10))
83. if (m == null || day == null || m < 1 || m > 12) { return t }
84. return day + ' ' + monthNames[m - 1] + ' ' + t.slice(0, 4)
85. }
87. // { name, photoUrl, born, died, bio } — every field a plain string ('' = none)
88. static personInfoOf = (p) => {
89. let born = dateText(p.birthDate)
90. let place = textOr(p.birthPlace)
91. let bornText = ''
92. if (born != null && place != null) { bornText = 'Born ' + born + ' in ' + place } else if (born != null) { bornText = 'Born ' + born } else if (place != null) { bornText = 'Born in ' + place }
93. let died = dateText(p.deathDate)
94. return { name = p.name != null ? p.name : '' photoUrl = photoUrlOf(p) born = bornText died = died != null ? 'Died ' + died : ''
95. bio = textOr(p.biography) != null ? p.biography : '' }
96. }
98. // ---- the filmography --------------------------------------------------------------------------------------------
99. // the credits, one row per title (a title twice — the migrated credit and TMDB's — is ONE row, roles merged), newest
100. // first by the title's release ('YYYY-MM-DD', else its year), undated last; only public titles (no adult/unknown)
101. static filmographyOf = (p) => {
102. let byShow = {}
103. let order = []
104. for (c of listOr(p.shows)) {
105. if (c != null && c.show != null) {
106. let role = textOr(c.character)
107. let prev = byShow[c.show]
108. if (prev == null) {
109. byShow[c.show] = { role = role != null ? role : '' posterPath = textOr(c.posterPath) adult = c.adult == true }
110. order.push(c.show)
111. } else {
112. let x = prev
113. if (role != null && !(' / ' + x.role + ' / ').includes(' / ' + role + ' / ')) { x.role = x.role == '' ? role : x.role + ' / ' + role }
114. if (x.posterPath == null) { x.posterPath = textOr(c.posterPath) }
115. if (c.adult == true) { x.adult = true }
116. byShow[c.show] = x
117. }
118. }
119. }
120. let list = []
121. for (sid of order) {
122. let c = byShow[sid]
123. let s = showById(sid)
124. if (isPublicTitle(s) && !c.adult) {
125. let y = showYear(s)
126. let release = textOr(s.release)
127. let key = release != null && release.length >= 4 ? release : (y != null ? y : '')
128. let poster = posterUrlOf(s)
129. if (poster == '/posters/none' && c.posterPath != null) { poster = tmdbImageBase + '/w92' + c.posterPath }
130. list.push({ key = key id = s.id title = s.title year = y != null ? y : '' href = '/shows/' + s.urlSegment posterUrl = poster
131. role = c.role typeLabel = s.type == 'movie' ? 'Movie' : 'Series' })
132. }
133. }
134. let out = []
135. let undated = []
136. for (r of sortDesc(list)) { if (r.key == '') { undated.push(r) } else { out.push(r) } }
137. for (r of undated) { out.push(r) }
138. return out
139. }
141. // ---- the fetch ------------------------------------------------------------------------------------------------
142. // person id → { items, pos, credits, added, requests, started, steps } while a fetch is under way (in memory: a restart
143. // loses it — the titles stored so far are found again by TMDB id, nothing is duplicated)
144. static jobs = {}
146. // TMDB genre id → ours (our genres carry TMDB's id)
147. static genreMap = { built = false ids = {} }
148. static genreIdsOfTmdb = (tmdbIds) => {
149. if (!genreMap.built) {
150. let m = {}
151. for (g of genresTable.find(null, null)) { if (g.tmdbId != null) { m['' + g.tmdbId] = g.id } }
152. genreMap.ids = m
153. genreMap.built = true
154. }
155. let out = []
156. for (t of listOr(tmdbIds)) {
157. let id = genreMap.ids['' + t]
158. if (id != null && !out.includes(id)) { out.push(id) }
159. }
160. return out
161. }
163. // TMDB's combined_credits → one item per title (cast AND crew of the same title merged), TV + movies only
164. static creditItems = (cc) => {
165. let byKey = {}
166. let order = []
167. let all = []
168. if (cc != null) {
169. for (c of listOr(cc.cast)) { all.push({ credit = c role = textOr(c.character) }) }
170. for (c of listOr(cc.crew)) { all.push({ credit = c role = textOr(c.job) }) }
171. }
172. for (a of all) {
173. let c = a.credit
174. let kind = c.media_type
175. if ((kind == 'tv' || kind == 'movie') && c.id != null && hlTypeName(c.id) == 'Number') {
176. let k = kind + ':' + c.id
177. let known = byKey[k]
178. if (known == null) {
179. let name = kind == 'tv' ? textOr(c.name) : textOr(c.title)
180. if (name != null) {
181. byKey[k] = { kind = kind tmdbId = c.id title = name release = textOr(kind == 'tv' ? c.first_air_date : c.release_date)
182. overview = textOr(c.overview) language = textOr(c.original_language) genreIds = listOr(c.genre_ids)
183. posterPath = textOr(c.poster_path) adult = c.adult == true role = a.role != null ? a.role : '' }
184. order.push(k)
185. }
186. } else if (a.role != null && !(' / ' + known.role + ' / ').includes(' / ' + a.role + ' / ')) {
187. let x = known
188. x.role = x.role == '' ? a.role : x.role + ' / ' + a.role
189. byKey[k] = x
190. }
191. }
192. }
193. let out = []
194. for (k of order) { out.push(byKey[k]) }
195. return out
196. }
198. // the photo: w185 → storage/mpackdb/profiles/<oldId>.<ext> — { requests, image, tmdbProfile, failed }
199. static syncProfile = (p, profilePath) => {
200. let out = { requests = 0 image = p.image tmdbProfile = p.tmdbProfile failed = null }
201. if (textOr(profilePath) == null || p.oldId == null) { return out }
202. let parts = profilePath.split('.')
203. let ext = parts[parts.length - 1].toLowerCase()
204. if (ext != 'jpg' && ext != 'jpeg' && ext != 'png' && ext != 'webp') { return out }
205. let file = profilesDir + '/' + p.oldId + '.' + ext
206. if (exists(file) && p.tmdbProfile == profilePath && p.image == ext) { return out }
207. out.requests = 1
208. let r = fetch(tmdbImageBase + '/w185' + profilePath, { headers = { 'user-agent' = 'tracker.worldapi.org (person page)' } timeoutMs = 20000 })
209. if (r == null || r.status != 200 || r.body == null || r.body.length == 0) {
210. out.failed = 'photo ' + profilePath + ': ' + (r == null ? 'no answer' : 'HTTP ' + r.status)
211. return out
212. }
213. mkDir(profilesDir)
214. writeFile(file, toBytes(r.body), 420)
215. out.image = ext
216. out.tmdbProfile = profilePath
217. return out
218. }
220. // step 1: TMDB's person + credits; the facts (a TMDB value that is empty never overwrites ours) and the photo
221. static startFill = (p) => {
222. let t0 = now()
223. let d = tmdbGet('/person/' + p.tmdbId + '?append_to_response=combined_credits')
224. if (d.failed != null) { return { error = 'TMDB: ' + d.failed } }
225. let items = creditItems(d.combined_credits)
226. let photo = syncProfile(p, d.profile_path)
227. let x = p
228. if (textOr(d.biography) != null) { x.biography = d.biography }
229. if (textOr(d.birthday) != null) { x.birthDate = d.birthday }
230. if (textOr(d.deathday) != null) { x.deathDate = d.deathday }
231. if (textOr(d.place_of_birth) != null) { x.birthPlace = d.place_of_birth }
232. if (textOr(x.imdbId) == null && textOr(d.imdb_id) != null) { x.imdbId = d.imdb_id }
233. if (d.adult != null) { x.adult = d.adult == true }
234. x.image = photo.image
235. x.tmdbProfile = photo.tmdbProfile
236. if (personsTable.update(x.id, x) == null) { return { error = 'could not store the person: ' + personsTable.lastError() } }
237. if (photo.failed != null) { console.log('person fill: ' + p.name + ': ' + photo.failed) }
238. jobs[p.id] = { items = items pos = 0 credits = [] added = 0 requests = 1 + photo.requests started = t0 steps = 1 tmdbMs = now() - t0 }
239. return { done = false pos = 0 total = items.length }
240. }
242. // a title we don't have: the minimal record (shape: search.hl importTitle) → its id, or null
243. static addMinimalTitle = (cr, pid, pname) => {
244. let kindType = cr.kind == 'tv' ? 'series' : 'movie'
245. let rel = cr.release
246. let yr = rel != null && rel.length >= 4 ? toNumber(rel.slice(0, 4)) : null
247. let slug = slugOf(cr.title, cr.tmdbId)
248. let record = {
249. id = randomBytes(8, 'hex') title = cr.title summary = null tmdbSummary = cr.overview tmdbId = cr.tmdbId
250. language = cr.language type = kindType release = rel year = yr image = null
251. urlSegment = slug episodesCount = null homepage = null imdbId = null seasonsCount = null
252. status = null tagline = null tvdbId = null tvmzId = null genres = genreIdsOfTmdb(cr.genreIds)
253. cast = [{ person = pid character = cr.role actor = pname }] seasons = [] oldId = 'tmdb-' + cr.kind + '-' + cr.tmdbId
254. adult = cr.adult imported = now() minimal = true
255. }
256. if (showsTable.put(record) == null) {
257. console.log('person fill: "' + cr.title + '" not stored: ' + showsTable.lastError())
258. return null
259. }
260. indexShow(record)
261. refreshCatalogShow(record.id)
262. return record.id
263. }
265. // every next step: the next `fillBatch` titles; the last one links the credits and marks the person complete
266. static fillStep = (p, jobIn) => {
267. let job = jobIn
268. let total = job.items.length
269. let end = job.pos + fillBatch
270. if (end > total) { end = total }
271. let credits = job.credits
272. let added = job.added
273. let pid = p.id
274. let pname = p.name
275. let i = job.pos
276. while (i < end) {
277. let item = job.items[i]
278. let sid = titleIdByTmdb(item.kind == 'tv' ? 'series' : 'movie', item.tmdbId)
279. if (sid == null) {
280. sid = addMinimalTitle(item, pid, pname)
281. if (sid != null) { added = added + 1 }
282. }
283. if (sid != null) { credits.push({ show = sid character = item.role posterPath = item.posterPath adult = item.adult }) }
284. i = i + 1
285. }
286. job.pos = end
287. job.credits = credits
288. job.added = added
289. job.steps = job.steps + 1
290. jobs[pid] = job
291. if (end < total) { return { done = false pos = end total = total } }
293. // done: the credits (+ the migrated ones TMDB no longer lists), complete
294. let have = {}
295. let all = []
296. for (c of credits) { have[c.show] = true all.push(c) }
297. for (c of listOr(p.shows)) { if (c != null && c.show != null && have[c.show] != true) { all.push(c) } }
298. let x = p
299. x.shows = all
300. x.filmographyAt = now()
301. if (personsTable.update(x.id, x) == null) { return { error = 'could not store the filmography: ' + personsTable.lastError() } }
302. personsTable.persist()
303. showsTable.persist()
304. jobs[pid] = null
305. console.log('person fill: ' + pname + ' (tmdb ' + p.tmdbId + ') credits=' + total + ' added=' + added + ' requests=' + job.requests + ' steps=' + job.steps + ' tmdbMs=' + job.tmdbMs + ' ms=' + (now() - job.started))
306. return { done = true pos = total total = total added = added }
307. }
309. // one step for the person with this id: { done, pos, total } or { error }
310. static personFillStep = (personId) => {
311. let p = personsTable.fetch(personId)
312. if (p == null) { return { error = 'no such person' } }
313. if (isComplete(p)) { return { done = true } }
314. if (p.tmdbId == null) { return { error = 'TMDB does not know this person' } }
315. let job = jobs[personId]
316. if (job == null) { return startFill(p) }
317. return fillStep(p, job)
318. }
320. // ---- people from a title's cast (tracker#26, details.hl completeStep) ------------------------------------------
321. // TMDB person id → our person id, built once (15k people, one scan), kept up to date by castPersonId
322. // (flat statics, written key by key like search.hl's haveTmdb: `let m = …ids` would copy the whole map — plain data
323. // deep-copies on assignment)
324. static personTmdbBuilt = { yes = false }
325. static personTmdbIds = {}
326. static personIdByTmdb = (tmdbId) => {
327. if (!personTmdbBuilt.yes) {
328. for (p of personsTable.find(null, null)) { if (p.tmdbId != null) { personTmdbIds['' + p.tmdbId] = p.id } }
329. personTmdbBuilt.yes = true
330. }
331. return personTmdbIds['' + tmdbId]
332. }
333. // a free person slug: "Maya-Rudolph", taken → "-2", … (the migrated people's form)
334. static personSlugOf = (name, tmdbId) => {
335. ensureSlugIndex()
336. let base = slugBaseOf(name, 'person-' + tmdbId)
337. if (slugIndex.ids[base] == null) { return base }
338. let n = 2
339. while (slugIndex.ids[base + '-' + n] != null) { n = n + 1 }
340. return base + '-' + n
341. }
342. // how many people castPersonId added since the start (details.hl counts a title's new people by the difference, tracker#28)
343. static castPeopleAdded = { n = 0 }
344. static castPeopleCount = () => { return castPeopleAdded.n }
345. // our person for one cast entry of TMDB ({ tmdbId, name, character, gender }) — the one we have by TMDB id, else a NEW
346. // person (name, tmdbId, a free slug, this one credit; not complete: their page fetches the rest on the first visit like any
347. // migrated person). Answers the id, or null when it could not be stored. Also a CREW person (tracker#28: `character` = the
348. // job, "Director").
349. static castPersonId = (c, showId) => {
350. let have = personIdByTmdb(c.tmdbId)
351. if (have != null) { return have }
352. let record = { id = randomBytes(8, 'hex') name = c.name tmdbId = c.tmdbId urlSegment = personSlugOf(c.name, c.tmdbId) oldId = 'tmdb-person-' + c.tmdbId
353. gender = c.gender image = null tmdbProfile = null adult = false birthDate = null birthPlace = null deathDate = null imdbId = null
354. shows = [{ show = showId character = c.character }] added = now() }
355. if (personsTable.put(record) == null) {
356. console.log('details: person "' + c.name + '" not stored: ' + personsTable.lastError())
357. return null
358. }
359. personTmdbIds['' + c.tmdbId] = record.id
360. slugIndex.ids[record.urlSegment] = record.id
361. indexPerson(record)
362. castPeopleAdded.n = castPeopleAdded.n + 1
363. return record.id
364. }