tracker

26.9 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. // GUESTS ARE NOT PERSON RECORDS (mission 062, memory: 160k people = +3.3 GB RSS at boot): a guest entry is
36. // { person (only when we have them already, else null), tmdbId, actor, character, profile (TMDB's profile_path), episodes,
37. // guest = true } — the page links it to `/person/tmdb/<tmdbId>?show=<show id>`, which creates the person on the first open
38. // (people.hl guestPersonId). The main cast and the crew are linked/created at once as before.
39. // crew [{ person, name, job, episodes }] job = creator (a series' `created_by`) | director (Director) | writer (Writer) |
40. // screenplay (Screenplay) | story (Story) | composer (Original Music Composer, Composer, Music) — one entry per person and
41. // job, a series' by that job's episode count (most first), a movie's in TMDB's order; at most `crewMax` per job.
42. // `creditsAt` (ms) = the credits are stored (by any path); `creditsCheck` = why the credits job gave up (TMDB 404, adult).
43. // Every person is linked (people.hl castPersonId: the one we have by TMDB id, else a NEW minimal person — slug, search entry,
44. // this one credit; their page fills on the first visit). WHO STORES THEM: the details step below (incomplete titles), the daily
45. // sync and the search import (tmdbsync.hl asks for the credits in the details request it makes anyway → `applyCredits`), and
46. // the CREDITS JOB (project.hl `creditsTick`, `creditsStep` here) for every other public title once — one request per title.
47. import { now } from 'hl:time'
48. import { env } from 'hl:proc'
49. import { showsTable, personsTable, kindOfTitle } from './shows.hl'
50. import { tmdbGet, textOr, adultOf, syncShowWith, syncShowPart, persistSync } from './tmdbsync.hl'
51. import { searchTitleChanged } from './search.hl'
52. import { refreshCatalogShow } from './catalog.hl'
53. import { castPersonId, castPeopleCount, genreIdsOfTmdb, personIdByTmdb } from './people.hl'
55. // how many of TMDB's cast a title keeps (see the top; TRACKER_CAST_MAX) and how many people per crew job
56. static castMax = env('TRACKER_CAST_MAX') != null ? toNumber(env('TRACKER_CAST_MAX')) : 300
57. static crewMax = 30
59. static listOr = (&v) => { return v == null ? [] : v }
61. // INCOMPLETE = a filmography title (`minimal`) or an import whose sync never finished (`imported`, no `tmdbSync`), not
62. // completed (`detailsAt`) and not given up on (`detailsCheck`)
63. static isIncomplete = (&s) => {
64. return s != null && s.tmdbId != null && s.detailsAt == null && s.detailsCheck == null && (s.minimal == true || (s.imported != null && s.tmdbSync == null))
65. }
66. // what the show page and the repair complete: an incomplete title that is not adult (mission 054/056: never public)
67. static needsDetails = (&s) => { return isIncomplete(s) && s.adult != true }
69. // 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)
70. static detailsRepairQueue = () => {
71. let out = []
72. for (s of showsTable.find(null, null)) { if (needsDetails(s)) { out.push(s.id) } }
73. return out
74. }
76. // a series' roles ([{ character, episode_count }]) as one text: "Mother / Lamia". tracker#28 (real data): TMDB's characters are
77. // themselves " / "-joined and repeat across seasons ("Data / Lore", "Data", "Yvette Picard (uncredited)") — split, " (uncredited)"
78. // dropped, each name once, at most `rolesMax` (a voice actor of The Simpsons has 30+), then " / …"
79. static rolesMax = 4
80. static rolesText = (&roles) => {
81. let names = []
82. let more = false
83. for (r of listOr(roles)) {
84. let c = r != null ? textOr(r.character) : null
85. if (c != null) {
86. for (part of c.split(' / ')) {
87. let n = part.replaceAll(' (uncredited)', '').trim()
88. if (n != '' && !names.includes(n)) { if (names.length < rolesMax) { names.push(n) } else { more = true } }
89. }
90. }
91. }
92. return names.join(' / ') + (more ? ' / …' : '')
93. }
95. // a series' episodes of one person: TMDB's total_episode_count, else the sum of the roles' / jobs' counts
96. static episodesOf = (&total, &parts) => {
97. if (total != null && hlTypeName(total) == 'Number') { return total }
98. let n = 0
99. for (r of listOr(parts)) { if (r != null && r.episode_count != null && hlTypeName(r.episode_count) == 'Number') { n = n + r.episode_count } }
100. return n
101. }
102. static personOk = (&c) => { return c != null && c.id != null && hlTypeName(c.id) == 'Number' && textOr(c.name) != null && c.adult != true }
104. // TMDB's cast → [{ tmdbId, name, character, gender, episodes }], TMDB's order, at most castMax, adult people left out
105. static castOf = (&d, &movie) => {
106. let src = movie ? (d.credits != null ? d.credits.cast : null) : (d.aggregate_credits != null ? d.aggregate_credits.cast : null)
107. let out = []
108. for (c of listOr(src)) {
109. if (out.length < castMax && personOk(c)) {
110. let role = movie ? textOr(c.character) : rolesText(c.roles)
111. 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) })
112. }
113. }
114. return out
115. }
117. // 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
118. static mainMinOf = (&d) => {
119. let n = d.number_of_episodes != null && hlTypeName(d.number_of_episodes) == 'Number' ? d.number_of_episodes : 0
120. let half = (n - n % 2) / 2 + n % 2
121. if (half > 10) { return 10 }
122. return half < 1 ? 1 : half
123. }
125. // the crew jobs we show: TMDB job → ours (the page's labels: components/show.hl crewLabels)
126. static crewJobOf = (&job) => {
127. if (job == 'Director') { return 'director' }
128. if (job == 'Writer') { return 'writer' }
129. if (job == 'Screenplay') { return 'screenplay' }
130. if (job == 'Story') { return 'story' }
131. if (job == 'Original Music Composer' || job == 'Composer' || job == 'Music') { return 'composer' }
132. return null
133. }
134. static crewJobs = ['creator', 'director', 'writer', 'screenplay', 'story', 'composer']
136. // keeps a job's list ordered by episodes (most first, equal ones in TMDB's order), at most crewMax (hand-written: no sort())
137. static insertByEpisodes = (&list, &item) => {
138. let out = []
139. let inserted = false
140. for (x of list) {
141. if (!inserted && item.episodes > x.episodes) { out.push(item) inserted = true }
142. if (out.length < crewMax) { out.push(x) }
143. }
144. if (!inserted && out.length < crewMax) { out.push(item) }
145. return out
146. }
148. // TMDB's crew (+ a series' created_by) → [{ tmdbId, name, job, gender, episodes }], grouped by job in `crewJobs` order, one
149. // entry per person and job
150. static crewOf = (&d, &movie) => {
151. let byJob = {}
152. let seen = {}
153. for (j of crewJobs) { byJob[j] = [] }
154. if (!movie) {
155. for (c of listOr(d.created_by)) {
156. if (personOk(c) && seen['creator:' + c.id] != true && byJob['creator'].length < crewMax) {
157. seen['creator:' + c.id] = true
158. let l = byJob['creator']
159. l.push({ tmdbId = c.id name = c.name job = 'creator' gender = c.gender episodes = 0 })
160. byJob['creator'] = l
161. }
162. }
163. }
164. let src = movie ? (d.credits != null ? d.credits.crew : null) : (d.aggregate_credits != null ? d.aggregate_credits.crew : null)
165. for (c of listOr(src)) {
166. if (personOk(c)) {
167. // a movie's crew entry has one `job`; a series' has `jobs` [{ job, episode_count }]
168. let jobs = movie ? [{ job = c.job episode_count = 0 }] : listOr(c.jobs)
169. for (jb of jobs) {
170. let ours = jb != null ? crewJobOf(jb.job) : null
171. if (ours != null && seen[ours + ':' + c.id] != true) {
172. seen[ours + ':' + c.id] = true
173. let n = movie ? 0 : episodesOf(jb.episode_count, null)
174. byJob[ours] = insertByEpisodes(byJob[ours], { tmdbId = c.id name = c.name job = ours gender = c.gender episodes = n })
175. }
176. }
177. }
178. }
179. let out = []
180. for (j of crewJobs) { for (c of byJob[j]) { out.push(c) } }
181. return out
182. }
184. // the title's cast: TMDB's (linked to our people, new ones added) first, then the entries we had that TMDB does not list.
185. // `mainMin` = a series' main-cast episode count (mainMinOf), 0 for a movie (no guests)
186. static mergedCast = (&show, &tmdbCast, &mainMin) => {
187. let out = []
188. let have = {}
189. let showKey = show.id
190. let seenTmdb = {}
191. for (c of tmdbCast) {
192. let guest = c.episodes != null && c.episodes < mainMin
193. // a guest: linked only when we have them, never created here (mission 062)
194. let pid = guest ? personIdByTmdb(c.tmdbId) : castPersonId(c, showKey)
195. if (pid != null && have[pid] != true) {
196. have[pid] = true
197. seenTmdb['' + c.tmdbId] = true
198. out.push({ person = pid tmdbId = c.tmdbId character = c.character actor = c.name profile = c.profile episodes = c.episodes guest = guest })
199. } else if (pid == null && guest && seenTmdb['' + c.tmdbId] != true) {
200. seenTmdb['' + c.tmdbId] = true
201. out.push({ person = null tmdbId = c.tmdbId character = c.character actor = c.name profile = c.profile episodes = c.episodes guest = true })
202. }
203. }
204. for (c of listOr(show.cast)) {
205. if (c != null && c.person != null && have[c.person] != true && (c.tmdbId == null || seenTmdb['' + c.tmdbId] != true)) {
206. have[c.person] = true
207. out.push(c)
208. }
209. }
210. return out
211. }
213. static crewRoleOf = (&job) => {
214. if (job == 'creator') { return 'Creator' }
215. if (job == 'director') { return 'Director' }
216. if (job == 'writer') { return 'Writer' }
217. if (job == 'screenplay') { return 'Screenplay' }
218. if (job == 'story') { return 'Story' }
219. return 'Music'
220. }
221. // 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
222. static linkedCrew = (&show, &tmdbCrew) => {
223. let out = []
224. let showKey = show.id
225. for (c of tmdbCrew) {
226. let pid = castPersonId({ tmdbId = c.tmdbId name = c.name character = crewRoleOf(c.job) gender = c.gender }, showKey)
227. if (pid != null) { out.push({ person = pid name = c.name job = c.job episodes = c.episodes }) }
228. }
229. return out
230. }
232. // the answer carries credits (a details request with `credits` / `aggregate_credits` appended)
233. static hasCredits = (&d, &movie) => { return d != null && (movie ? d.credits != null : d.aggregate_credits != null) }
235. // cast + crew of this record from a details answer → { show (the record with cast, crew, creditsAt), cast, crew, people (new) }
236. static withCredits = (show, &d, &movie) => {
237. let before = castPeopleCount()
238. let tmdbCast = castOf(d, movie)
239. let x = show
240. x.cast = mergedCast(show, tmdbCast, movie ? 0 : mainMinOf(d))
241. x.crew = linkedCrew(show, crewOf(d, movie))
242. x.creditsAt = now()
243. return { show = x cast = tmdbCast.length crew = x.crew.length people = castPeopleCount() - before }
244. }
246. // THE RECORD'S OWN FIELDS from a details answer (tracker#26 completion; tracker#18 the daily sync too — creator: "some shows changed
247. // descriptions and titles and that did not update"): title (a series' `name`, a movie's `title`), TMDB's overview → `tmdbSummary`,
248. // homepage, tagline, status, genres (by TMDB id), adult; type / release / year / language only when we have none. A TMDB value
249. // that is empty never overwrites ours. `summary` is the creator's OWN text — never written here (the page shows summary >
250. // tmdbSummary > tvmazeSummary, shows.hl summaryOf). The slug (`urlSegment`) never changes with the title.
251. // mission 070 (conductor): the sync never DESTROYS what the old tracker's migration brought — before TMDB's value replaces a
252. // migrated record's title / genres / homepage / tagline for the FIRST time, the old one is kept in `migratedTitle` /
253. // `migratedGenres` / `migratedHomepage` / `migratedTagline` (kept, shown nowhere; set once, a later rename leaves it). A record is
254. // migrated when its `oldId` is the old tracker's (not `tmdb-…`: search import, filmography fill). `status`, counts, ids and the
255. // poster are TMDB's state, written by the sync since #9 — not kept.
256. static isMigratedRecord = (&show) => { return show.oldId != null && ('' + show.oldId).slice(0, 5) != 'tmdb-' }
257. static sameIdList = (&a, &b) => {
258. let x = listOr(a)
259. let y = listOr(b)
260. if (x.length != y.length) { return false }
261. let i = 0
262. while (i < x.length) { if ('' + x[i] != '' + y[i]) { return false } i = i + 1 }
263. return true
264. }
265. static withDetailsFields = (show, &d, &movie) => {
266. let x = show
267. let migrated = isMigratedRecord(show)
268. let adult = adultOf(d)
269. if (adult != null) { x.adult = adult }
270. let title = textOr(movie ? d.title : d.name)
271. if (title != null) {
272. if (migrated && x.migratedTitle == null && textOr(x.title) != null && x.title != title) { x.migratedTitle = x.title }
273. x.title = title
274. }
275. if (textOr(d.overview) != null) { x.tmdbSummary = d.overview }
276. if (textOr(d.homepage) != null) {
277. if (migrated && x.migratedHomepage == null && textOr(x.homepage) != null && x.homepage != d.homepage) { x.migratedHomepage = x.homepage }
278. x.homepage = d.homepage
279. }
280. if (textOr(d.tagline) != null) {
281. if (migrated && x.migratedTagline == null && textOr(x.tagline) != null && x.tagline != d.tagline) { x.migratedTagline = x.tagline }
282. x.tagline = d.tagline
283. }
284. if (textOr(d.status) != null) { x.status = d.status }
285. let tmdbGenreIds = []
286. for (g of listOr(d.genres)) { if (g != null && g.id != null) { tmdbGenreIds.push(g.id) } }
287. let genres = genreIdsOfTmdb(tmdbGenreIds)
288. if (genres.length > 0) {
289. if (migrated && x.migratedGenres == null && listOr(x.genres).length > 0 && !sameIdList(x.genres, genres)) { x.migratedGenres = x.genres }
290. x.genres = genres
291. }
292. if (textOr(x.type) == null) { x.type = movie ? 'movie' : 'series' }
293. let release = textOr(movie ? d.release_date : d.first_air_date)
294. if (textOr(x.release) == null && release != null) {
295. x.release = release
296. if (release.length >= 4) { x.year = toNumber(release.slice(0, 4)) }
297. }
298. if (textOr(x.language) == null && textOr(d.original_language) != null) { x.language = d.original_language }
299. // tracker#21 (merge, mission 070): TMDB's TV type + the kind from the genres just stored (the delta's light step and the
300. // completion of #26 store it too, not only syncShow / the kind backfill)
301. if (!movie && textOr(d.type) != null) {
302. x.tmdbType = d.type
303. x.kind = kindOfTitle(d.type, x.genres)
304. }
305. return x
306. }
308. // THE DAILY SYNC (project.hl syncTick, tools/sync-tmdb.hl; tracker#18): after tmdbsync.hl `syncShow` (seasons, episodes, poster,
309. // ids, TVmaze) the record's own fields (withDetailsFields) and its cast + crew (#28) from the SAME details answer (`res.details`)
310. // — no extra request. Answers { renamed (the title changed: the search re-indexes it), cast, crew, people, ms, error }
311. static applySynced = (&showId, &d) => {
312. let out = { renamed = false cast = 0 crew = 0 people = 0 ms = 0 error = '' }
313. let t0 = now()
314. let show = showsTable.fetch(showId)
315. if (show == null || d == null) { return out }
316. let movie = show.type == 'movie'
317. let before = show.title
318. let x = withDetailsFields(show, d, movie)
319. out.renamed = x.title != before
320. if (x.adult != true && hasCredits(d, movie)) {
321. let w = withCredits(x, d, movie)
322. x = w.show
323. out.cast = w.cast
324. out.crew = w.crew
325. out.people = w.people
326. }
327. if (showsTable.update(x.id, x) == null) { out.error = x.title + ': record not stored: ' + showsTable.lastError() }
328. out.ms = now() - t0
329. return out
330. }
332. // the search import: its details answer (tmdbsync.hl `res.details`) → the title's cast + crew. Nothing
333. // for an adult title or an answer without credits. Answers { cast, crew, people, ms, error }
334. static applyCredits = (&showId, &d) => {
335. let out = { cast = 0 crew = 0 people = 0 ms = 0 error = '' }
336. let t0 = now()
337. let show = showsTable.fetch(showId)
338. if (show == null || show.adult == true || adultOf(d) == true || !hasCredits(d, show.type == 'movie')) { return out }
339. let w = withCredits(show, d, show.type == 'movie')
340. if (showsTable.update(show.id, w.show) == null) { out.error = show.title + ': credits not stored: ' + showsTable.lastError() return out }
341. out.cast = w.cast
342. out.crew = w.crew
343. out.people = w.people
344. out.ms = now() - t0
345. return out
346. }
348. // 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
349. // request at a time, every page waited): step 1 = the details request (fields + cast); then one step per PART of its seasons
350. // (≤ `partEpisodes` episodes, ≤ 20 seasons = one TMDB request — tmdbsync.hl syncShowPart); the last step = ids, TVmaze, poster,
351. // `detailsAt`. A movie is one step. Between two steps every other request is served.
352. // show id → { d (TMDB's answer of step 1), parts ([[season numbers]]), pos, sum } while a series is under way — in memory: a
353. // restart begins again with the details request; what is stored by then is matched by tmdbId, nothing is duplicated
354. static jobs = {}
355. // (TRACKER_DETAILS_PART_EPISODES: the gate sets 1 → one season per step)
356. static partEpisodes = env('TRACKER_DETAILS_PART_EPISODES') != null ? toNumber(env('TRACKER_DETAILS_PART_EPISODES')) : 300
358. 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 = '' } }
359. static addSum = (sum, &r, &ms) => {
360. let o = sum
361. o.steps = o.steps + 1
362. o.requests = o.requests + r.requests
363. o.tvmazeRequests = o.tvmazeRequests + r.tvmazeRequests
364. o.newSeasons = o.newSeasons + r.newSeasons + r.tvmazeSeasons
365. o.newEpisodes = o.newEpisodes + r.newEpisodes + r.tvmazeEpisodes
366. o.posters = o.posters + r.posters
367. o.ids = o.ids + r.ids
368. o.ms = o.ms + ms
369. if (r.error != '') { o.error = r.error }
370. return o
371. }
373. // TMDB's season list → parts of ≤ partEpisodes episodes (a bigger season is a part of its own), ≤ 20 seasons each; which of
374. // them are really synced (season 0, empty ones) syncShowPart decides
375. static seasonParts = (&d) => {
376. let parts = []
377. let cur = []
378. let n = 0
379. for (x of listOr(d.seasons)) {
380. if (x != null && x.season_number != null) {
381. let c = x.episode_count != null ? x.episode_count : 0
382. if (cur.length > 0 && (n + c > partEpisodes || cur.length == 20)) {
383. parts.push(cur)
384. cur = []
385. n = 0
386. }
387. cur.push(x.season_number)
388. n = n + c
389. }
390. }
391. if (cur.length > 0) { parts.push(cur) }
392. return parts
393. }
395. // a step's answer: { skipped (nothing to do), done, requests / tvmazeRequests (THIS step's — what the pause counts), adult,
396. // error ('' = none), retry (a passing failure: no answer, 429, 5xx), sum (the whole title's counts so far: steps, requests,
397. // cast, newSeasons, newEpisodes, posters, ids, ms) }
398. static stepOut = () => { return { skipped = false done = false requests = 0 tvmazeRequests = 0 adult = null error = '' retry = false sum = emptySum() } }
400. // the last step: the title is complete
401. static markComplete = (&showId, &sum) => {
402. let done = showsTable.fetch(showId)
403. done.detailsAt = now()
404. if (sum.error != '') { done.detailsError = sum.error }
405. let ok = showsTable.update(done.id, done) != null
406. refreshCatalogShow(done.id)
407. searchTitleChanged(done.id)
408. return ok
409. }
411. // step 1: the details request — the record's fields, the cast; a movie also its ids + poster (done); a series' parts are planned
412. static firstStep = (show) => {
413. let out = stepOut()
414. let t0 = now()
415. let movie = show.type == 'movie'
416. out.requests = 1
417. let d = tmdbGet((movie ? '/movie/' : '/tv/') + show.tmdbId + '?append_to_response=external_ids,' + (movie ? 'credits' : 'aggregate_credits'))
418. if (d.failed != null) {
419. out.error = show.title + ': ' + d.failed
420. if (d.status == 404) {
421. show.detailsCheck = 'TMDB 404'
422. showsTable.update(show.id, show)
423. out.done = true
424. } else { out.retry = true }
425. return out
426. }
427. out.adult = adultOf(d)
428. let x = withDetailsFields(show, d, movie)
429. if (out.adult == true) {
430. // never public: the flag, no poster, no seasons, no cast (mission 056)
431. x.detailsCheck = 'adult'
432. showsTable.update(x.id, x)
433. refreshCatalogShow(x.id)
434. searchTitleChanged(x.id)
435. out.done = true
436. return out
437. }
438. // tracker#28: the whole cast + the crew, from this same answer
439. let w = withCredits(x, d, movie)
440. x = w.show
441. if (showsTable.update(x.id, x) == null) {
442. out.error = show.title + ': not updated: ' + showsTable.lastError()
443. out.retry = true
444. return out
445. }
446. let sum = emptySum()
447. sum.cast = w.cast
448. sum.crew = w.crew
449. sum.people = w.people
450. if (movie) {
451. // one request was enough: ids + poster now (syncMovie with this answer)
452. let r = syncShowWith(x.id, d)
453. out.requests = r.requests
454. out.sum = addSum(sum, r, now() - t0)
455. if (r.error != '') { out.error = r.error }
456. markComplete(x.id, out.sum)
457. out.done = true
458. return out
459. }
460. sum.steps = 1
461. sum.requests = 1
462. sum.ms = now() - t0
463. // the next steps need the details, not the credits (a long series' aggregate_credits are ~1 MB, copied on every step)
464. let dd = d
465. dd.aggregate_credits = null
466. jobs[x.id] = { d = dd parts = seasonParts(d) pos = 0 sum = sum }
467. out.sum = sum
468. return out
469. }
471. // ONE step of completing this title (by our id) — called until `done` (the page's face, the repair job)
472. static completeStep = (&showId) => {
473. let show = showsTable.fetch(showId)
474. if (!needsDetails(show)) {
475. jobs[showId] = null
476. let out = stepOut()
477. out.skipped = true
478. out.done = true
479. return out
480. }
481. let job = jobs[showId]
482. if (job == null) { return firstStep(show) }
483. let t0 = now()
484. let out = stepOut()
485. let last = job.pos >= job.parts.length
486. let r = syncShowPart(showId, job.d, { seasons = last ? [] : job.parts[job.pos] finish = last })
487. out.requests = r.requests
488. out.tvmazeRequests = r.tvmazeRequests
489. if (r.error != '') { out.error = r.error }
490. let j = job
491. j.sum = addSum(j.sum, r, now() - t0)
492. j.pos = j.pos + 1
493. out.sum = j.sum
494. if (!last) {
495. jobs[showId] = j
496. return out
497. }
498. jobs[showId] = null
499. markComplete(showId, j.sum)
500. out.done = true
501. return out
502. }
504. // the line every completed title logs
505. static completeLine = (&title, &sum) => {
506. return '"' + title + '" steps=' + sum.steps + ' requests=' + sum.requests + ' tvmazeRequests=' + sum.tvmazeRequests + ' cast=' + sum.cast + ' newSeasons=' + sum.newSeasons
507. + ' newEpisodes=' + sum.newEpisodes + ' posters=' + sum.posters + ' ids=' + sum.ids + ' ms=' + sum.ms + ' crew=' + sum.crew + ' people=' + sum.people + (sum.error != '' ? ' error: ' + sum.error : '')
508. }
510. // flush shows/seasons/episodes + people (new cast members)
511. static persistDetails = () => {
512. persistSync()
513. personsTable.persist()
514. return true
515. }
516. // the credits job touches only shows + people: the episodes' index files (~16 MB on the live data) are not rewritten
517. static persistCredits = () => {
518. showsTable.persist()
519. personsTable.persist()
520. return true
521. }
523. // ---- THE CREDITS JOB (tracker#28, project.hl `creditsTick`): every public title that has no credits yet, once --------------
524. // (the incomplete ones get theirs from completeStep; adult and unknown-flag titles are never asked — not public)
525. static needsCredits = (&s) => { return s != null && s.tmdbId != null && s.adult == false && s.creditsAt == null && s.creditsCheck == null && !isIncomplete(s) }
526. // in table order, read once when the job starts (a restart goes on with what is left)
527. static creditsQueue = () => {
528. let out = []
529. for (s of showsTable.find(null, null)) { if (needsCredits(s)) { out.push(s.id) } }
530. return out
531. }
532. // ONE title: one request (details + credits / aggregate_credits) → its cast + crew. Answers { skipped, requests, cast, crew,
533. // people, ms, error, retry (no answer, 429, 5xx: ask again later) }. TMDB 404 / adult → `creditsCheck`, never asked again.
534. static creditsStep = (&showId) => {
535. let out = { skipped = false requests = 0 cast = 0 crew = 0 people = 0 ms = 0 error = '' retry = false }
536. let t0 = now()
537. let show = showsTable.fetch(showId)
538. if (!needsCredits(show)) { out.skipped = true return out }
539. let movie = show.type == 'movie'
540. out.requests = 1
541. let d = tmdbGet((movie ? '/movie/' : '/tv/') + show.tmdbId + '?append_to_response=' + (movie ? 'credits' : 'aggregate_credits'))
542. if (d.failed != null) {
543. out.error = show.title + ': ' + d.failed
544. if (d.status == 404) {
545. show.creditsCheck = 'TMDB 404'
546. showsTable.update(show.id, show)
547. } else { out.retry = true }
548. return out
549. }
550. if (adultOf(d) == true) {
551. show.creditsCheck = 'adult'
552. showsTable.update(show.id, show)
553. return out
554. }
555. let w = withCredits(show, d, movie)
556. if (showsTable.update(show.id, w.show) == null) {
557. out.error = show.title + ': credits not stored: ' + showsTable.lastError()
558. out.retry = true
559. return out
560. }
561. out.cast = w.cast
562. out.crew = w.crew
563. out.people = w.people
564. out.ms = now() - t0
565. return out
566. }