tracker

25.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. // 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 } 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. static withDetailsFields = (show, d, movie) => {
252. let x = show
253. let adult = adultOf(d)
254. if (adult != null) { x.adult = adult }
255. let title = textOr(movie ? d.title : d.name)
256. if (title != null) { x.title = title }
257. if (textOr(d.overview) != null) { x.tmdbSummary = d.overview }
258. if (textOr(d.homepage) != null) { x.homepage = d.homepage }
259. if (textOr(d.tagline) != null) { x.tagline = d.tagline }
260. if (textOr(d.status) != null) { x.status = d.status }
261. let tmdbGenreIds = []
262. for (g of listOr(d.genres)) { if (g != null && g.id != null) { tmdbGenreIds.push(g.id) } }
263. let genres = genreIdsOfTmdb(tmdbGenreIds)
264. if (genres.length > 0) { x.genres = genres }
265. if (textOr(x.type) == null) { x.type = movie ? 'movie' : 'series' }
266. let release = textOr(movie ? d.release_date : d.first_air_date)
267. if (textOr(x.release) == null && release != null) {
268. x.release = release
269. if (release.length >= 4) { x.year = toNumber(release.slice(0, 4)) }
270. }
271. if (textOr(x.language) == null && textOr(d.original_language) != null) { x.language = d.original_language }
272. return x
273. }
275. // THE DAILY SYNC (project.hl syncTick, tools/sync-tmdb.hl; tracker#18): after tmdbsync.hl `syncShow` (seasons, episodes, poster,
276. // ids, TVmaze) the record's own fields (withDetailsFields) and its cast + crew (#28) from the SAME details answer (`res.details`)
277. // — no extra request. Answers { renamed (the title changed: the search re-indexes it), cast, crew, people, ms, error }
278. static applySynced = (showId, d) => {
279. let out = { renamed = false cast = 0 crew = 0 people = 0 ms = 0 error = '' }
280. let t0 = now()
281. let show = showsTable.fetch(showId)
282. if (show == null || d == null) { return out }
283. let movie = show.type == 'movie'
284. let before = show.title
285. let x = withDetailsFields(show, d, movie)
286. out.renamed = x.title != before
287. if (x.adult != true && hasCredits(d, movie)) {
288. let w = withCredits(x, d, movie)
289. x = w.show
290. out.cast = w.cast
291. out.crew = w.crew
292. out.people = w.people
293. }
294. if (showsTable.update(x.id, x) == null) { out.error = x.title + ': record not stored: ' + showsTable.lastError() }
295. out.ms = now() - t0
296. return out
297. }
299. // the search import: its details answer (tmdbsync.hl `res.details`) → the title's cast + crew. Nothing
300. // for an adult title or an answer without credits. Answers { cast, crew, people, ms, error }
301. static applyCredits = (showId, d) => {
302. let out = { cast = 0 crew = 0 people = 0 ms = 0 error = '' }
303. let t0 = now()
304. let show = showsTable.fetch(showId)
305. if (show == null || show.adult == true || adultOf(d) == true || !hasCredits(d, show.type == 'movie')) { return out }
306. let w = withCredits(show, d, show.type == 'movie')
307. if (showsTable.update(show.id, w.show) == null) { out.error = show.title + ': credits not stored: ' + showsTable.lastError() return out }
308. out.cast = w.cast
309. out.crew = w.crew
310. out.people = w.people
311. out.ms = now() - t0
312. return out
313. }
315. // 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
316. // request at a time, every page waited): step 1 = the details request (fields + cast); then one step per PART of its seasons
317. // (≤ `partEpisodes` episodes, ≤ 20 seasons = one TMDB request — tmdbsync.hl syncShowPart); the last step = ids, TVmaze, poster,
318. // `detailsAt`. A movie is one step. Between two steps every other request is served.
319. // show id → { d (TMDB's answer of step 1), parts ([[season numbers]]), pos, sum } while a series is under way — in memory: a
320. // restart begins again with the details request; what is stored by then is matched by tmdbId, nothing is duplicated
321. static jobs = {}
322. // (TRACKER_DETAILS_PART_EPISODES: the gate sets 1 → one season per step)
323. static partEpisodes = env('TRACKER_DETAILS_PART_EPISODES') != null ? toNumber(env('TRACKER_DETAILS_PART_EPISODES')) : 300
325. 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 = '' } }
326. static addSum = (sum, r, ms) => {
327. let o = sum
328. o.steps = o.steps + 1
329. o.requests = o.requests + r.requests
330. o.tvmazeRequests = o.tvmazeRequests + r.tvmazeRequests
331. o.newSeasons = o.newSeasons + r.newSeasons + r.tvmazeSeasons
332. o.newEpisodes = o.newEpisodes + r.newEpisodes + r.tvmazeEpisodes
333. o.posters = o.posters + r.posters
334. o.ids = o.ids + r.ids
335. o.ms = o.ms + ms
336. if (r.error != '') { o.error = r.error }
337. return o
338. }
340. // TMDB's season list → parts of ≤ partEpisodes episodes (a bigger season is a part of its own), ≤ 20 seasons each; which of
341. // them are really synced (season 0, empty ones) syncShowPart decides
342. static seasonParts = (d) => {
343. let parts = []
344. let cur = []
345. let n = 0
346. for (x of listOr(d.seasons)) {
347. if (x != null && x.season_number != null) {
348. let c = x.episode_count != null ? x.episode_count : 0
349. if (cur.length > 0 && (n + c > partEpisodes || cur.length == 20)) {
350. parts.push(cur)
351. cur = []
352. n = 0
353. }
354. cur.push(x.season_number)
355. n = n + c
356. }
357. }
358. if (cur.length > 0) { parts.push(cur) }
359. return parts
360. }
362. // a step's answer: { skipped (nothing to do), done, requests / tvmazeRequests (THIS step's — what the pause counts), adult,
363. // error ('' = none), retry (a passing failure: no answer, 429, 5xx), sum (the whole title's counts so far: steps, requests,
364. // cast, newSeasons, newEpisodes, posters, ids, ms) }
365. static stepOut = () => { return { skipped = false done = false requests = 0 tvmazeRequests = 0 adult = null error = '' retry = false sum = emptySum() } }
367. // the last step: the title is complete
368. static markComplete = (showId, sum) => {
369. let done = showsTable.fetch(showId)
370. done.detailsAt = now()
371. if (sum.error != '') { done.detailsError = sum.error }
372. let ok = showsTable.update(done.id, done) != null
373. refreshCatalogShow(done.id)
374. searchTitleChanged(done.id)
375. return ok
376. }
378. // step 1: the details request — the record's fields, the cast; a movie also its ids + poster (done); a series' parts are planned
379. static firstStep = (show) => {
380. let out = stepOut()
381. let t0 = now()
382. let movie = show.type == 'movie'
383. out.requests = 1
384. let d = tmdbGet((movie ? '/movie/' : '/tv/') + show.tmdbId + '?append_to_response=external_ids,' + (movie ? 'credits' : 'aggregate_credits'))
385. if (d.failed != null) {
386. out.error = show.title + ': ' + d.failed
387. if (d.status == 404) {
388. show.detailsCheck = 'TMDB 404'
389. showsTable.update(show.id, show)
390. out.done = true
391. } else { out.retry = true }
392. return out
393. }
394. out.adult = adultOf(d)
395. let x = withDetailsFields(show, d, movie)
396. if (out.adult == true) {
397. // never public: the flag, no poster, no seasons, no cast (mission 056)
398. x.detailsCheck = 'adult'
399. showsTable.update(x.id, x)
400. refreshCatalogShow(x.id)
401. searchTitleChanged(x.id)
402. out.done = true
403. return out
404. }
405. // tracker#28: the whole cast + the crew, from this same answer
406. let w = withCredits(x, d, movie)
407. x = w.show
408. if (showsTable.update(x.id, x) == null) {
409. out.error = show.title + ': not updated: ' + showsTable.lastError()
410. out.retry = true
411. return out
412. }
413. let sum = emptySum()
414. sum.cast = w.cast
415. sum.crew = w.crew
416. sum.people = w.people
417. if (movie) {
418. // one request was enough: ids + poster now (syncMovie with this answer)
419. let r = syncShowWith(x.id, d)
420. out.requests = r.requests
421. out.sum = addSum(sum, r, now() - t0)
422. if (r.error != '') { out.error = r.error }
423. markComplete(x.id, out.sum)
424. out.done = true
425. return out
426. }
427. sum.steps = 1
428. sum.requests = 1
429. sum.ms = now() - t0
430. // the next steps need the details, not the credits (a long series' aggregate_credits are ~1 MB, copied on every step)
431. let dd = d
432. dd.aggregate_credits = null
433. jobs[x.id] = { d = dd parts = seasonParts(d) pos = 0 sum = sum }
434. out.sum = sum
435. return out
436. }
438. // ONE step of completing this title (by our id) — called until `done` (the page's face, the repair job)
439. static completeStep = (showId) => {
440. let show = showsTable.fetch(showId)
441. if (!needsDetails(show)) {
442. jobs[showId] = null
443. let out = stepOut()
444. out.skipped = true
445. out.done = true
446. return out
447. }
448. let job = jobs[showId]
449. if (job == null) { return firstStep(show) }
450. let t0 = now()
451. let out = stepOut()
452. let last = job.pos >= job.parts.length
453. let r = syncShowPart(showId, job.d, { seasons = last ? [] : job.parts[job.pos] finish = last })
454. out.requests = r.requests
455. out.tvmazeRequests = r.tvmazeRequests
456. if (r.error != '') { out.error = r.error }
457. let j = job
458. j.sum = addSum(j.sum, r, now() - t0)
459. j.pos = j.pos + 1
460. out.sum = j.sum
461. if (!last) {
462. jobs[showId] = j
463. return out
464. }
465. jobs[showId] = null
466. markComplete(showId, j.sum)
467. out.done = true
468. return out
469. }
471. // the line every completed title logs
472. static completeLine = (title, sum) => {
473. return '"' + title + '" steps=' + sum.steps + ' requests=' + sum.requests + ' tvmazeRequests=' + sum.tvmazeRequests + ' cast=' + sum.cast + ' newSeasons=' + sum.newSeasons
474. + ' newEpisodes=' + sum.newEpisodes + ' posters=' + sum.posters + ' ids=' + sum.ids + ' ms=' + sum.ms + ' crew=' + sum.crew + ' people=' + sum.people + (sum.error != '' ? ' error: ' + sum.error : '')
475. }
477. // flush shows/seasons/episodes + people (new cast members)
478. static persistDetails = () => {
479. persistSync()
480. personsTable.persist()
481. return true
482. }
483. // the credits job touches only shows + people: the episodes' index files (~16 MB on the live data) are not rewritten
484. static persistCredits = () => {
485. showsTable.persist()
486. personsTable.persist()
487. return true
488. }
490. // ---- THE CREDITS JOB (tracker#28, project.hl `creditsTick`): every public title that has no credits yet, once --------------
491. // (the incomplete ones get theirs from completeStep; adult and unknown-flag titles are never asked — not public)
492. static needsCredits = (s) => { return s != null && s.tmdbId != null && s.adult == false && s.creditsAt == null && s.creditsCheck == null && !isIncomplete(s) }
493. // in table order, read once when the job starts (a restart goes on with what is left)
494. static creditsQueue = () => {
495. let out = []
496. for (s of showsTable.find(null, null)) { if (needsCredits(s)) { out.push(s.id) } }
497. return out
498. }
499. // ONE title: one request (details + credits / aggregate_credits) → its cast + crew. Answers { skipped, requests, cast, crew,
500. // people, ms, error, retry (no answer, 429, 5xx: ask again later) }. TMDB 404 / adult → `creditsCheck`, never asked again.
501. static creditsStep = (showId) => {
502. let out = { skipped = false requests = 0 cast = 0 crew = 0 people = 0 ms = 0 error = '' retry = false }
503. let t0 = now()
504. let show = showsTable.fetch(showId)
505. if (!needsCredits(show)) { out.skipped = true return out }
506. let movie = show.type == 'movie'
507. out.requests = 1
508. let d = tmdbGet((movie ? '/movie/' : '/tv/') + show.tmdbId + '?append_to_response=' + (movie ? 'credits' : 'aggregate_credits'))
509. if (d.failed != null) {
510. out.error = show.title + ': ' + d.failed
511. if (d.status == 404) {
512. show.creditsCheck = 'TMDB 404'
513. showsTable.update(show.id, show)
514. } else { out.retry = true }
515. return out
516. }
517. if (adultOf(d) == true) {
518. show.creditsCheck = 'adult'
519. showsTable.update(show.id, show)
520. return out
521. }
522. let w = withCredits(show, d, movie)
523. if (showsTable.update(show.id, w.show) == null) {
524. out.error = show.title + ': credits not stored: ' + showsTable.lastError()
525. out.retry = true
526. return out
527. }
528. out.cast = w.cast
529. out.crew = w.crew
530. out.people = w.people
531. out.ms = now() - t0
532. return out
533. }