tracker

24.1 KB

1. // details.hl — A TITLE'S FULL DETAILS (tracker.worldapi.org#26). Creator: "when i go to an artist and it loads the bibliography
2. // those loaded movies and series miss most information and it stays that way when i click on them".
3. //
4. // The person page's fill (people.hl, #16) adds every title we don't have as a MINIMAL record — title, year, overview, genres,
5. // type, tmdbId, adult, this one person as cast; no poster, no seasons, no external ids, no homepage/tagline/status
6. // (`minimal = true`). A search import (search.hl importTitle) is full except for the cast. Here a minimal title gets what a
7. // full import has, plus its cast:
8. //
9. // GET <TMDB>/movie/<tmdbId>?append_to_response=external_ids,credits a movie
10. // GET <TMDB>/tv/<tmdbId>?append_to_response=external_ids,aggregate_credits a series (cast of ALL seasons, roles merged)
11. // then tmdbsync.hl `syncShowPart(id, <that answer>, …)` — the daily sync's work, without asking for the details again, IN
12. // STEPS (see `jobs` below): a series' seasons + episodes (`season/1,…`), then the poster (w342), missing imdb/tvdb ids,
13. // TVmaze lookup + its episode merge (#15); a movie its imdb id + poster
14. //
15. // Stored (`withDetailsFields`, shared with the daily sync since tracker#18): title, overview → `tmdbSummary` (`summary` is the
16. // creator's own text, never written), homepage, tagline, status, genres (by TMDB id, when
17. // TMDB gives any), release/year/language when we have none, `adult`, the CAST (TMDB's first `castLimit`, in TMDB's order;
18. // a person we have by TMDB id is linked, a new one is added — people.hl castPersonId; cast entries we had and TMDB does not
19. // list are kept after them). Then `detailsAt` (ms) = COMPLETE, never asked again (the daily sync keeps a FOLLOWED title fresh).
20. // TMDB 404 → `detailsCheck = 'TMDB 404'` (never asked again; the page shows what it has). TMDB says ADULT → the flag is
21. // stored, `detailsCheck = 'adult'`, no poster/seasons (mission 056: an adult title is never public, its poster not kept).
22. //
23. // WHO CALLS IT (`completeStep`, again and again until `done`): the show page when an incomplete title is opened
24. // (components/show.hl face `showComplete`, skeleton meanwhile) and the repair job in project.hl (`repairTick`, one step per tick
25. // on the app's clock, like the adult backfill) for every incomplete title that exists when the app starts. Adult titles are
26. // left alone by both.
27. //
28. // CAST AND CREW (tracker.worldapi.org#28; creator: "you show quite few people, usually there are more especially at picard, and
29. // directors and so"). From the SAME details answer (`credits` of a movie, `aggregate_credits` of a series = every season):
30. // cast [{ person, character, actor, episodes, guest }] — a movie: TMDB's order (billing); a series: TMDB's aggregate order
31. // (by episode count, most first; `character` = all roles " / "), `episodes` = the person's episodes, `guest` = fewer than
32. // `mainMinOf` (half the series' episodes, at most 10, at least 1) → the page puts them after "Guest stars". At most
33. // `castMax` (300: a talk show/soap lists 3,000+ one-episode guests — Grey's Anatomy 3,243, SNL 2,771 — each would be a
34. // new person); adult people left out; entries we had and TMDB does not list are kept after them.
35. // crew [{ person, name, job, episodes }] job = creator (a series' `created_by`) | director (Director) | writer (Writer) |
36. // screenplay (Screenplay) | story (Story) | composer (Original Music Composer, Composer, Music) — one entry per person and
37. // job, a series' by that job's episode count (most first), a movie's in TMDB's order; at most `crewMax` per job.
38. // `creditsAt` (ms) = the credits are stored (by any path); `creditsCheck` = why the credits job gave up (TMDB 404, adult).
39. // Every person is linked (people.hl castPersonId: the one we have by TMDB id, else a NEW minimal person — slug, search entry,
40. // this one credit; their page fills on the first visit). WHO STORES THEM: the details step below (incomplete titles), the daily
41. // sync and the search import (tmdbsync.hl asks for the credits in the details request it makes anyway → `applyCredits`), and
42. // the CREDITS JOB (project.hl `creditsTick`, `creditsStep` here) for every other public title once — one request per title.
43. import { now } from 'hl:time'
44. import { env } from 'hl:proc'
45. import { showsTable, personsTable } from './shows.hl'
46. import { tmdbGet, textOr, adultOf, syncShowWith, syncShowPart, persistSync } from './tmdbsync.hl'
47. import { searchTitleChanged } from './search.hl'
48. import { refreshCatalogShow } from './catalog.hl'
49. import { castPersonId, castPeopleCount, genreIdsOfTmdb } from './people.hl'
51. // how many of TMDB's cast a title keeps (see the top; TRACKER_CAST_MAX) and how many people per crew job
52. static castMax = env('TRACKER_CAST_MAX') != null ? toNumber(env('TRACKER_CAST_MAX')) : 300
53. static crewMax = 30
55. static listOr = (v) => { return v == null ? [] : v }
57. // INCOMPLETE = a filmography title (`minimal`) or an import whose sync never finished (`imported`, no `tmdbSync`), not
58. // completed (`detailsAt`) and not given up on (`detailsCheck`)
59. static isIncomplete = (s) => {
60. return s != null && s.tmdbId != null && s.detailsAt == null && s.detailsCheck == null && (s.minimal == true || (s.imported != null && s.tmdbSync == null))
61. }
62. // what the show page and the repair complete: an incomplete title that is not adult (mission 054/056: never public)
63. static needsDetails = (s) => { return isIncomplete(s) && s.adult != true }
65. // every title the repair job has to do, in table order (read once when it starts — so a restart goes on with what is left)
66. static detailsRepairQueue = () => {
67. let out = []
68. for (s of showsTable.find(null, null)) { if (needsDetails(s)) { out.push(s.id) } }
69. return out
70. }
72. // a series' roles ([{ character, episode_count }]) as one text: "Mother / Lamia". tracker#28 (real data): TMDB's characters are
73. // themselves " / "-joined and repeat across seasons ("Data / Lore", "Data", "Yvette Picard (uncredited)") — split, " (uncredited)"
74. // dropped, each name once, at most `rolesMax` (a voice actor of The Simpsons has 30+), then " / …"
75. static rolesMax = 4
76. static rolesText = (roles) => {
77. let names = []
78. let more = false
79. for (r of listOr(roles)) {
80. let c = r != null ? textOr(r.character) : null
81. if (c != null) {
82. for (part of c.split(' / ')) {
83. let n = part.replaceAll(' (uncredited)', '').trim()
84. if (n != '' && !names.includes(n)) { if (names.length < rolesMax) { names.push(n) } else { more = true } }
85. }
86. }
87. }
88. return names.join(' / ') + (more ? ' / …' : '')
89. }
91. // a series' episodes of one person: TMDB's total_episode_count, else the sum of the roles' / jobs' counts
92. static episodesOf = (total, parts) => {
93. if (total != null && hlTypeName(total) == 'Number') { return total }
94. let n = 0
95. for (r of listOr(parts)) { if (r != null && r.episode_count != null && hlTypeName(r.episode_count) == 'Number') { n = n + r.episode_count } }
96. return n
97. }
98. static personOk = (c) => { return c != null && c.id != null && hlTypeName(c.id) == 'Number' && textOr(c.name) != null && c.adult != true }
100. // TMDB's cast → [{ tmdbId, name, character, gender, episodes }], TMDB's order, at most castMax, adult people left out
101. static castOf = (d, movie) => {
102. let src = movie ? (d.credits != null ? d.credits.cast : null) : (d.aggregate_credits != null ? d.aggregate_credits.cast : null)
103. let out = []
104. for (c of listOr(src)) {
105. if (out.length < castMax && personOk(c)) {
106. let role = movie ? textOr(c.character) : rolesText(c.roles)
107. out.push({ tmdbId = c.id name = c.name character = role != null ? role : '' gender = c.gender episodes = movie ? null : episodesOf(c.total_episode_count, c.roles) })
108. }
109. }
110. return out
111. }
113. // a series' main cast is in at least this many episodes: half of the series' (rounded up), at most 10 (a season), at least 1
114. static mainMinOf = (d) => {
115. let n = d.number_of_episodes != null && hlTypeName(d.number_of_episodes) == 'Number' ? d.number_of_episodes : 0
116. let half = (n - n % 2) / 2 + n % 2
117. if (half > 10) { return 10 }
118. return half < 1 ? 1 : half
119. }
121. // the crew jobs we show: TMDB job → ours (the page's labels: components/show.hl crewLabels)
122. static crewJobOf = (job) => {
123. if (job == 'Director') { return 'director' }
124. if (job == 'Writer') { return 'writer' }
125. if (job == 'Screenplay') { return 'screenplay' }
126. if (job == 'Story') { return 'story' }
127. if (job == 'Original Music Composer' || job == 'Composer' || job == 'Music') { return 'composer' }
128. return null
129. }
130. static crewJobs = ['creator', 'director', 'writer', 'screenplay', 'story', 'composer']
132. // keeps a job's list ordered by episodes (most first, equal ones in TMDB's order), at most crewMax (hand-written: no sort())
133. static insertByEpisodes = (list, item) => {
134. let out = []
135. let inserted = false
136. for (x of list) {
137. if (!inserted && item.episodes > x.episodes) { out.push(item) inserted = true }
138. if (out.length < crewMax) { out.push(x) }
139. }
140. if (!inserted && out.length < crewMax) { out.push(item) }
141. return out
142. }
144. // TMDB's crew (+ a series' created_by) → [{ tmdbId, name, job, gender, episodes }], grouped by job in `crewJobs` order, one
145. // entry per person and job
146. static crewOf = (d, movie) => {
147. let byJob = {}
148. let seen = {}
149. for (j of crewJobs) { byJob[j] = [] }
150. if (!movie) {
151. for (c of listOr(d.created_by)) {
152. if (personOk(c) && seen['creator:' + c.id] != true && byJob['creator'].length < crewMax) {
153. seen['creator:' + c.id] = true
154. let l = byJob['creator']
155. l.push({ tmdbId = c.id name = c.name job = 'creator' gender = c.gender episodes = 0 })
156. byJob['creator'] = l
157. }
158. }
159. }
160. let src = movie ? (d.credits != null ? d.credits.crew : null) : (d.aggregate_credits != null ? d.aggregate_credits.crew : null)
161. for (c of listOr(src)) {
162. if (personOk(c)) {
163. // a movie's crew entry has one `job`; a series' has `jobs` [{ job, episode_count }]
164. let jobs = movie ? [{ job = c.job episode_count = 0 }] : listOr(c.jobs)
165. for (jb of jobs) {
166. let ours = jb != null ? crewJobOf(jb.job) : null
167. if (ours != null && seen[ours + ':' + c.id] != true) {
168. seen[ours + ':' + c.id] = true
169. let n = movie ? 0 : episodesOf(jb.episode_count, null)
170. byJob[ours] = insertByEpisodes(byJob[ours], { tmdbId = c.id name = c.name job = ours gender = c.gender episodes = n })
171. }
172. }
173. }
174. }
175. let out = []
176. for (j of crewJobs) { for (c of byJob[j]) { out.push(c) } }
177. return out
178. }
180. // the title's cast: TMDB's (linked to our people, new ones added) first, then the entries we had that TMDB does not list.
181. // `mainMin` = a series' main-cast episode count (mainMinOf), 0 for a movie (no guests)
182. static mergedCast = (show, tmdbCast, mainMin) => {
183. let out = []
184. let have = {}
185. let showKey = show.id
186. for (c of tmdbCast) {
187. let pid = castPersonId(c, showKey)
188. if (pid != null && have[pid] != true) {
189. have[pid] = true
190. out.push({ person = pid character = c.character actor = c.name episodes = c.episodes guest = c.episodes != null && c.episodes < mainMin })
191. }
192. }
193. for (c of listOr(show.cast)) {
194. if (c != null && c.person != null && have[c.person] != true) {
195. have[c.person] = true
196. out.push(c)
197. }
198. }
199. return out
200. }
202. static crewRoleOf = (job) => {
203. if (job == 'creator') { return 'Creator' }
204. if (job == 'director') { return 'Director' }
205. if (job == 'writer') { return 'Writer' }
206. if (job == 'screenplay') { return 'Screenplay' }
207. if (job == 'story') { return 'Story' }
208. return 'Music'
209. }
210. // the title's crew: TMDB's, linked to our people (a crew person new to us gets the job as their role) — replaces what we had
211. static linkedCrew = (show, tmdbCrew) => {
212. let out = []
213. let showKey = show.id
214. for (c of tmdbCrew) {
215. let pid = castPersonId({ tmdbId = c.tmdbId name = c.name character = crewRoleOf(c.job) gender = c.gender }, showKey)
216. if (pid != null) { out.push({ person = pid name = c.name job = c.job episodes = c.episodes }) }
217. }
218. return out
219. }
221. // the answer carries credits (a details request with `credits` / `aggregate_credits` appended)
222. static hasCredits = (d, movie) => { return d != null && (movie ? d.credits != null : d.aggregate_credits != null) }
224. // cast + crew of this record from a details answer → { show (the record with cast, crew, creditsAt), cast, crew, people (new) }
225. static withCredits = (show, d, movie) => {
226. let before = castPeopleCount()
227. let tmdbCast = castOf(d, movie)
228. let x = show
229. x.cast = mergedCast(show, tmdbCast, movie ? 0 : mainMinOf(d))
230. x.crew = linkedCrew(show, crewOf(d, movie))
231. x.creditsAt = now()
232. return { show = x cast = tmdbCast.length crew = x.crew.length people = castPeopleCount() - before }
233. }
235. // THE RECORD'S OWN FIELDS from a details answer (tracker#26 completion; tracker#18 the daily sync too — creator: "some shows changed
236. // descriptions and titles and that did not update"): title (a series' `name`, a movie's `title`), TMDB's overview → `tmdbSummary`,
237. // homepage, tagline, status, genres (by TMDB id), adult; type / release / year / language only when we have none. A TMDB value
238. // that is empty never overwrites ours. `summary` is the creator's OWN text — never written here (the page shows summary >
239. // tmdbSummary > tvmazeSummary, shows.hl summaryOf). The slug (`urlSegment`) never changes with the title.
240. static withDetailsFields = (show, d, movie) => {
241. let x = show
242. let adult = adultOf(d)
243. if (adult != null) { x.adult = adult }
244. let title = textOr(movie ? d.title : d.name)
245. if (title != null) { x.title = title }
246. if (textOr(d.overview) != null) { x.tmdbSummary = d.overview }
247. if (textOr(d.homepage) != null) { x.homepage = d.homepage }
248. if (textOr(d.tagline) != null) { x.tagline = d.tagline }
249. if (textOr(d.status) != null) { x.status = d.status }
250. let tmdbGenreIds = []
251. for (g of listOr(d.genres)) { if (g != null && g.id != null) { tmdbGenreIds.push(g.id) } }
252. let genres = genreIdsOfTmdb(tmdbGenreIds)
253. if (genres.length > 0) { x.genres = genres }
254. if (textOr(x.type) == null) { x.type = movie ? 'movie' : 'series' }
255. let release = textOr(movie ? d.release_date : d.first_air_date)
256. if (textOr(x.release) == null && release != null) {
257. x.release = release
258. if (release.length >= 4) { x.year = toNumber(release.slice(0, 4)) }
259. }
260. if (textOr(x.language) == null && textOr(d.original_language) != null) { x.language = d.original_language }
261. return x
262. }
264. // THE DAILY SYNC (project.hl syncTick, tools/sync-tmdb.hl; tracker#18): after tmdbsync.hl `syncShow` (seasons, episodes, poster,
265. // ids, TVmaze) the record's own fields (withDetailsFields) and its cast + crew (#28) from the SAME details answer (`res.details`)
266. // — no extra request. Answers { renamed (the title changed: the search re-indexes it), cast, crew, people, ms, error }
267. static applySynced = (showId, d) => {
268. let out = { renamed = false cast = 0 crew = 0 people = 0 ms = 0 error = '' }
269. let t0 = now()
270. let show = showsTable.fetch(showId)
271. if (show == null || d == null) { return out }
272. let movie = show.type == 'movie'
273. let before = show.title
274. let x = withDetailsFields(show, d, movie)
275. out.renamed = x.title != before
276. if (x.adult != true && hasCredits(d, movie)) {
277. let w = withCredits(x, d, movie)
278. x = w.show
279. out.cast = w.cast
280. out.crew = w.crew
281. out.people = w.people
282. }
283. if (showsTable.update(x.id, x) == null) { out.error = x.title + ': record not stored: ' + showsTable.lastError() }
284. out.ms = now() - t0
285. return out
286. }
288. // the search import: its details answer (tmdbsync.hl `res.details`) → the title's cast + crew. Nothing
289. // for an adult title or an answer without credits. Answers { cast, crew, people, ms, error }
290. static applyCredits = (showId, d) => {
291. let out = { cast = 0 crew = 0 people = 0 ms = 0 error = '' }
292. let t0 = now()
293. let show = showsTable.fetch(showId)
294. if (show == null || show.adult == true || adultOf(d) == true || !hasCredits(d, show.type == 'movie')) { return out }
295. let w = withCredits(show, d, show.type == 'movie')
296. if (showsTable.update(show.id, w.show) == null) { out.error = show.title + ': credits not stored: ' + showsTable.lastError() return out }
297. out.cast = w.cast
298. out.crew = w.crew
299. out.people = w.people
300. out.ms = now() - t0
301. return out
302. }
304. // A SERIES IS DONE IN STEPS (real data: The Late Show, 22 seasons / 4,252 episodes, took 10.7 s as one step — hl:web serves one
305. // request at a time, every page waited): step 1 = the details request (fields + cast); then one step per PART of its seasons
306. // (≤ `partEpisodes` episodes, ≤ 20 seasons = one TMDB request — tmdbsync.hl syncShowPart); the last step = ids, TVmaze, poster,
307. // `detailsAt`. A movie is one step. Between two steps every other request is served.
308. // show id → { d (TMDB's answer of step 1), parts ([[season numbers]]), pos, sum } while a series is under way — in memory: a
309. // restart begins again with the details request; what is stored by then is matched by tmdbId, nothing is duplicated
310. static jobs = {}
311. // (TRACKER_DETAILS_PART_EPISODES: the gate sets 1 → one season per step)
312. static partEpisodes = env('TRACKER_DETAILS_PART_EPISODES') != null ? toNumber(env('TRACKER_DETAILS_PART_EPISODES')) : 300
314. static emptySum = () => { return { steps = 0 requests = 0 tvmazeRequests = 0 cast = 0 crew = 0 people = 0 newSeasons = 0 newEpisodes = 0 posters = 0 ids = 0 ms = 0 error = '' } }
315. static addSum = (sum, r, ms) => {
316. let o = sum
317. o.steps = o.steps + 1
318. o.requests = o.requests + r.requests
319. o.tvmazeRequests = o.tvmazeRequests + r.tvmazeRequests
320. o.newSeasons = o.newSeasons + r.newSeasons + r.tvmazeSeasons
321. o.newEpisodes = o.newEpisodes + r.newEpisodes + r.tvmazeEpisodes
322. o.posters = o.posters + r.posters
323. o.ids = o.ids + r.ids
324. o.ms = o.ms + ms
325. if (r.error != '') { o.error = r.error }
326. return o
327. }
329. // TMDB's season list → parts of ≤ partEpisodes episodes (a bigger season is a part of its own), ≤ 20 seasons each; which of
330. // them are really synced (season 0, empty ones) syncShowPart decides
331. static seasonParts = (d) => {
332. let parts = []
333. let cur = []
334. let n = 0
335. for (x of listOr(d.seasons)) {
336. if (x != null && x.season_number != null) {
337. let c = x.episode_count != null ? x.episode_count : 0
338. if (cur.length > 0 && (n + c > partEpisodes || cur.length == 20)) {
339. parts.push(cur)
340. cur = []
341. n = 0
342. }
343. cur.push(x.season_number)
344. n = n + c
345. }
346. }
347. if (cur.length > 0) { parts.push(cur) }
348. return parts
349. }
351. // a step's answer: { skipped (nothing to do), done, requests / tvmazeRequests (THIS step's — what the pause counts), adult,
352. // error ('' = none), retry (a passing failure: no answer, 429, 5xx), sum (the whole title's counts so far: steps, requests,
353. // cast, newSeasons, newEpisodes, posters, ids, ms) }
354. static stepOut = () => { return { skipped = false done = false requests = 0 tvmazeRequests = 0 adult = null error = '' retry = false sum = emptySum() } }
356. // the last step: the title is complete
357. static markComplete = (showId, sum) => {
358. let done = showsTable.fetch(showId)
359. done.detailsAt = now()
360. if (sum.error != '') { done.detailsError = sum.error }
361. let ok = showsTable.update(done.id, done) != null
362. refreshCatalogShow(done.id)
363. searchTitleChanged(done.id)
364. return ok
365. }
367. // step 1: the details request — the record's fields, the cast; a movie also its ids + poster (done); a series' parts are planned
368. static firstStep = (show) => {
369. let out = stepOut()
370. let t0 = now()
371. let movie = show.type == 'movie'
372. out.requests = 1
373. let d = tmdbGet((movie ? '/movie/' : '/tv/') + show.tmdbId + '?append_to_response=external_ids,' + (movie ? 'credits' : 'aggregate_credits'))
374. if (d.failed != null) {
375. out.error = show.title + ': ' + d.failed
376. if (d.status == 404) {
377. show.detailsCheck = 'TMDB 404'
378. showsTable.update(show.id, show)
379. out.done = true
380. } else { out.retry = true }
381. return out
382. }
383. out.adult = adultOf(d)
384. let x = withDetailsFields(show, d, movie)
385. if (out.adult == true) {
386. // never public: the flag, no poster, no seasons, no cast (mission 056)
387. x.detailsCheck = 'adult'
388. showsTable.update(x.id, x)
389. refreshCatalogShow(x.id)
390. searchTitleChanged(x.id)
391. out.done = true
392. return out
393. }
394. // tracker#28: the whole cast + the crew, from this same answer
395. let w = withCredits(x, d, movie)
396. x = w.show
397. if (showsTable.update(x.id, x) == null) {
398. out.error = show.title + ': not updated: ' + showsTable.lastError()
399. out.retry = true
400. return out
401. }
402. let sum = emptySum()
403. sum.cast = w.cast
404. sum.crew = w.crew
405. sum.people = w.people
406. if (movie) {
407. // one request was enough: ids + poster now (syncMovie with this answer)
408. let r = syncShowWith(x.id, d)
409. out.requests = r.requests
410. out.sum = addSum(sum, r, now() - t0)
411. if (r.error != '') { out.error = r.error }
412. markComplete(x.id, out.sum)
413. out.done = true
414. return out
415. }
416. sum.steps = 1
417. sum.requests = 1
418. sum.ms = now() - t0
419. // the next steps need the details, not the credits (a long series' aggregate_credits are ~1 MB, copied on every step)
420. let dd = d
421. dd.aggregate_credits = null
422. jobs[x.id] = { d = dd parts = seasonParts(d) pos = 0 sum = sum }
423. out.sum = sum
424. return out
425. }
427. // ONE step of completing this title (by our id) — called until `done` (the page's face, the repair job)
428. static completeStep = (showId) => {
429. let show = showsTable.fetch(showId)
430. if (!needsDetails(show)) {
431. jobs[showId] = null
432. let out = stepOut()
433. out.skipped = true
434. out.done = true
435. return out
436. }
437. let job = jobs[showId]
438. if (job == null) { return firstStep(show) }
439. let t0 = now()
440. let out = stepOut()
441. let last = job.pos >= job.parts.length
442. let r = syncShowPart(showId, job.d, { seasons = last ? [] : job.parts[job.pos] finish = last })
443. out.requests = r.requests
444. out.tvmazeRequests = r.tvmazeRequests
445. if (r.error != '') { out.error = r.error }
446. let j = job
447. j.sum = addSum(j.sum, r, now() - t0)
448. j.pos = j.pos + 1
449. out.sum = j.sum
450. if (!last) {
451. jobs[showId] = j
452. return out
453. }
454. jobs[showId] = null
455. markComplete(showId, j.sum)
456. out.done = true
457. return out
458. }
460. // the line every completed title logs
461. static completeLine = (title, sum) => {
462. return '"' + title + '" steps=' + sum.steps + ' requests=' + sum.requests + ' tvmazeRequests=' + sum.tvmazeRequests + ' cast=' + sum.cast + ' newSeasons=' + sum.newSeasons
463. + ' newEpisodes=' + sum.newEpisodes + ' posters=' + sum.posters + ' ids=' + sum.ids + ' ms=' + sum.ms + ' crew=' + sum.crew + ' people=' + sum.people + (sum.error != '' ? ' error: ' + sum.error : '')
464. }
466. // flush shows/seasons/episodes + people (new cast members)
467. static persistDetails = () => {
468. persistSync()
469. personsTable.persist()
470. return true
471. }
472. // the credits job touches only shows + people: the episodes' index files (~16 MB on the live data) are not rewritten
473. static persistCredits = () => {
474. showsTable.persist()
475. personsTable.persist()
476. return true
477. }
479. // ---- THE CREDITS JOB (tracker#28, project.hl `creditsTick`): every public title that has no credits yet, once --------------
480. // (the incomplete ones get theirs from completeStep; adult and unknown-flag titles are never asked — not public)
481. static needsCredits = (s) => { return s != null && s.tmdbId != null && s.adult == false && s.creditsAt == null && s.creditsCheck == null && !isIncomplete(s) }
482. // in table order, read once when the job starts (a restart goes on with what is left)
483. static creditsQueue = () => {
484. let out = []
485. for (s of showsTable.find(null, null)) { if (needsCredits(s)) { out.push(s.id) } }
486. return out
487. }
488. // ONE title: one request (details + credits / aggregate_credits) → its cast + crew. Answers { skipped, requests, cast, crew,
489. // people, ms, error, retry (no answer, 429, 5xx: ask again later) }. TMDB 404 / adult → `creditsCheck`, never asked again.
490. static creditsStep = (showId) => {
491. let out = { skipped = false requests = 0 cast = 0 crew = 0 people = 0 ms = 0 error = '' retry = false }
492. let t0 = now()
493. let show = showsTable.fetch(showId)
494. if (!needsCredits(show)) { out.skipped = true return out }
495. let movie = show.type == 'movie'
496. out.requests = 1
497. let d = tmdbGet((movie ? '/movie/' : '/tv/') + show.tmdbId + '?append_to_response=' + (movie ? 'credits' : 'aggregate_credits'))
498. if (d.failed != null) {
499. out.error = show.title + ': ' + d.failed
500. if (d.status == 404) {
501. show.creditsCheck = 'TMDB 404'
502. showsTable.update(show.id, show)
503. } else { out.retry = true }
504. return out
505. }
506. if (adultOf(d) == true) {
507. show.creditsCheck = 'adult'
508. showsTable.update(show.id, show)
509. return out
510. }
511. let w = withCredits(show, d, movie)
512. if (showsTable.update(show.id, w.show) == null) {
513. out.error = show.title + ': credits not stored: ' + showsTable.lastError()
514. out.retry = true
515. return out
516. }
517. out.cast = w.cast
518. out.crew = w.crew
519. out.people = w.people
520. out.ms = now() - t0
521. return out
522. }