tracker

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