tracker

35.9 KB

1. // tmdbsync.hl — THE TMDB SYNC (tracker.worldapi.org#9): for every show SOMEONE follows, fetch the show's
2. // details, seasons and episodes from TMDB and bring storage/mpackdb/ up to date, plus the show's poster.
3. // Used by BOTH runners: the daily run inside the app (project.hl `syncTick`, one show per step) and the
4. // command-line tool (tools/sync-tmdb.hl). Reference for the API use: the old tracker's
5. // crates/sync/commands/sync.js (read-only).
6. //
7. // GET <TMDB_BASE_URL>/tv/<tmdbId>?append_to_response=external_ids,aggregate_credits the details (status,
8. // counts, overview, poster_path, seasons[])
9. // + external_ids (imdb_id, tvdb_id) + the cast/crew
10. // of every season (tracker#28: the answer goes back
11. // as `res.details`, the caller stores the credits —
12. // details.hl applyCredits; no extra request)
13. // GET <TMDB_BASE_URL>/tv/<tmdbId>?append_to_response=season/1,season/2… up to 20 seasons with their
14. // episodes in ONE request
15. // GET <TMDB_IMAGE_URL>/w342<poster_path> the poster → storage/mpackdb/posters/
16. // Authorization: Bearer $TMDB_READ_TOKEN
17. // GET <TVMAZE_BASE_URL>/lookup/shows?imdb=tt… (else ?thetvdb=<id>) the TVmaze id, ONLY when the show
18. // has none (301 → /shows/<id>, 404 = unknown)
19. // GET <TVMAZE_BASE_URL>/shows/<tvmzId>/episodes a SERIES' episodes on TVmaze (#15), see below
20. // A MOVIE (`type = 'movie'`, 7814 of the migrated rows, 1 followed): only
21. // GET <TMDB_BASE_URL>/movie/<tmdbId>?append_to_response=external_ids,credits its imdb id + poster (+ credits); no seasons,
22. // status, overview (it is no TV show)
23. //
24. // EXTERNAL IDS (tracker.worldapi.org#12, the show page's link icons): a MISSING imdbId/tvdbId is filled from TMDB's
25. // external_ids, a missing tvmzId from TVmaze's lookup — an id the show already has is NEVER overwritten.
26. // RULES (ticket): new seasons/episodes are ADDED, existing ones UPDATED (title, summary, release) —
27. // matched by tmdbId, never duplicated; NOTHING is deleted. An episode without a tmdbId (161 migrated ones)
28. // is matched by its S/E number instead and gets the tmdbId. A season (no tmdbId in the migrated data) is
29. // matched by (show, seasonNumber). A TMDB value that is empty/null never overwrites a stored one.
30. // Season 0 ("Specials") is only synced for a show that already has a season 0 (else every followed show
31. // would suddenly flood /my/unwatched with specials); a TMDB season with no episodes is not created.
32. //
33. // TVMAZE MERGE (tracker.worldapi.org#15): AFTER TMDB, a series with a tvmzId gets TVmaze's episode list (one request)
34. // and TVmaze FILLS GAPS only — matched by season/episode number: a missing episode (and its season) is ADDED, an empty
35. // title or air date of an existing one is FILLED; a value TMDB gave is never overwritten. A placeholder title
36. // ("Episode 4", "TBA") counts as empty — and TMDB's own placeholder never overwrites a real title either (else the
37. // two would flip it every day). When TMDB later lists the episode, the TMDB step adopts it by number (it has no tmdbId)
38. // and TMDB's values win. TVmaze specials (no episode number) are skipped, season 0 only if the show has one. SAFETY:
39. // when the two number a show differently (fewer than 80 % of the episodes both know air within a day of each other or
40. // share the title — `numberingAgrees`), TVmaze is ignored for that show (`tvmazeSkipped`). Summaries are not taken
41. // (TVmaze's are HTML; the ticket asks for episodes, air dates, titles).
42. //
43. // ADULT FLAG (mission 054): every details answer carries TMDB's `adult` — the sync, the import (search.hl) and the
44. // BACKFILL below store it as show.adult (true/false; null = not known yet, hidden from the public lists, shows.hl
45. // isPublicTitle). THE BACKFILL (`backfillTitle`, run one title per step by project.hl `backfillTick`, like the daily sync):
46. // GET <TMDB_BASE_URL>/movie|tv/<tmdbId>?append_to_response=external_ids ONE request: adult, poster_path, imdb/tvdb id
47. // GET <TMDB_IMAGE_URL>/w342<poster_path> the poster when its file is missing (not for
48. // an adult title — never shown, mission 056)
49. // for every title whose adult flag is unknown (no TVmaze, no seasons — the daily sync does those for followed shows). A
50. // title TMDB answers 404 for (or one without tmdbId) gets `adultCheck` = why, stays unknown (hidden) and is not asked again.
51. //
52. // IDS ARE SELF-ASSIGNED (randomBytes, like watches.hl): hl:mpackdb's own generated @id can repeat within
53. // one millisecond, which is what made update() lose rows (hybriel#113, fixed upstream, not in the vendored
54. // build) — a table holding only unique ids is safe to update().
55. //
56. // ONE PROCESS PER STORAGE: hl:mpackdb does not coordinate two processes (hybriel#21) — the in-app run uses
57. // the app's own open tables (imported from shows.hl); the tool only ever runs against a stopped app or a copy.
58. //
59. // Env: TMDB_READ_TOKEN (required unless TMDB_BASE_URL points at a fake), TMDB_BASE_URL
60. // (https://api.themoviedb.org/3), TMDB_IMAGE_URL (https://image.tmdb.org/t/p) — the gate points both at its
61. // fake TMDB (tests/browser.mjs).
62. import { fetch } from 'hl:fetch'
63. import { env } from 'hl:proc'
64. import { now } from 'hl:time'
65. import { randomBytes } from 'hl:crypto'
66. import { writeFile, mkDir, exists } from 'hl:fs'
67. import { showsTable, seasonsTable, episodesTable, storageDir } from './shows.hl'
69. static envOr = (name, fallback) => {
70. let v = env(name)
71. return v != null && v.trim() != '' ? v.trim() : fallback
72. }
73. static tmdbBase = envOr('TMDB_BASE_URL', 'https://api.themoviedb.org/3')
74. static tmdbImageBase = envOr('TMDB_IMAGE_URL', 'https://image.tmdb.org/t/p')
75. static tmdbToken = envOr('TMDB_READ_TOKEN', '')
76. static postersDir = storageDir + '/posters'
78. static tvmazeBase = envOr('TVMAZE_BASE_URL', 'https://api.tvmaze.com')
80. // the sync can run: a token is set (never printed) — the dev .env on Loreana has one, a gate sets its own
81. static syncEnabled = tmdbToken != ''
83. // TMDB allows 40 requests / 10 s: every runner waits this long per request it made before the next show
84. static msPerRequest = 260
85. // TVmaze allows 20 requests / 10 s (its API docs): 550 ms per lookup made
86. static msPerTvmazeRequest = 550
87. // how long a runner waits after a show before the next one (both runners: project.hl syncTick, tools/sync-tmdb.hl)
88. static pauseMsAfter = (r) => { return r.requests * msPerRequest + r.tvmazeRequests * msPerTvmazeRequest }
90. // one GET → the parsed JSON, or { failed = '<why>' }. A refused/timed-out fetch is an Error event (absorbed
91. // by the runner's `on Error`), the fetch then yields null.
92. static tmdbGet = (path) => {
93. let r = fetch(tmdbBase + path, { headers = { 'authorization' = 'Bearer ' + tmdbToken 'accept' = 'application/json' 'user-agent' = 'tracker.worldapi.org (tmdb sync)' } timeoutMs = 20000 })
94. if (r == null || r.status == null || r.status == 0) { return { failed = 'no answer for ' + path } }
95. if (r.status != 200) { return { failed = 'HTTP ' + r.status + ' for ' + path status = r.status } }
96. let j = r.json()
97. if (j == null) { return { failed = 'no JSON for ' + path } }
98. return j
99. }
101. static textOr = (v) => { return v != null && hlTypeName(v) == 'String' && v.trim() != '' ? v : null }
103. // ---- external ids (tracker.worldapi.org#12) -----------------------------------------------------
104. static hasId = (v) => { return v != null && ('' + v).trim() != '' }
105. // an IMDb id as TMDB gives it ('tt' + digits), else null
106. static imdbOr = (v) => {
107. let t = textOr(v)
108. if (t == null || t.length < 3 || t.slice(0, 2) != 'tt') { return null }
109. let i = 2
110. while (i < t.length) {
111. if (!'0123456789'.includes(t[i])) { return null }
112. i = i + 1
113. }
114. return t
115. }
116. // a positive numeric id (TMDB's tvdb_id, TVmaze's id), else null
117. static numIdOr = (v) => { return v != null && hlTypeName(v) == 'Number' && v > 0 ? v : null }
119. // TVmaze's lookup by one external id: { id } (null = TVmaze doesn't know it, 404) or { failed }. hl:fetch follows the
120. // 301 to /shows/<id> by itself, so a hit answers the show's own JSON.
121. static tvmazeLookup = (param, value) => {
122. let r = fetch(tvmazeBase + '/lookup/shows?' + param + '=' + value, { headers = { 'accept' = 'application/json' 'user-agent' = 'tracker.worldapi.org (tmdb sync)' } timeoutMs = 20000 })
123. if (r == null || r.status == null || r.status == 0) { return { failed = 'TVmaze: no answer for ' + param + '=' + value } }
124. if (r.status == 404) { return { id = null } }
125. if (r.status != 200) { return { failed = 'TVmaze: HTTP ' + r.status + ' for ' + param + '=' + value } }
126. let j = r.json()
127. if (j == null || numIdOr(j.id) == null) { return { failed = 'TVmaze: no id for ' + param + '=' + value } }
128. return { id = j.id }
129. }
131. // the ids to SET on a show from TMDB's external_ids (+ TVmaze for a series): { imdbId, tvdbId, tvmzId } — each the
132. // show's own value when it has one (never overwritten), else the found one, else null — plus { filled, tvmazeRequests,
133. // failed }. TVmaze is asked by imdb, then by thetvdb, only while the show (after TMDB) still has no tvmzId — and only
134. // when `askTvmaze` (the adult backfill does not: one request per title)
135. static externalIdsFor = (show, ext, isSeries, askTvmaze) => {
136. let out = { imdbId = show.imdbId tvdbId = show.tvdbId tvmzId = show.tvmzId filled = 0 tvmazeRequests = 0 failed = null }
137. let e = ext != null ? ext : {}
138. if (!hasId(out.imdbId) && imdbOr(e.imdb_id) != null) { out.imdbId = e.imdb_id out.filled = out.filled + 1 }
139. if (!isSeries) { return out }
140. if (!hasId(out.tvdbId) && numIdOr(e.tvdb_id) != null) { out.tvdbId = e.tvdb_id out.filled = out.filled + 1 }
141. if (hasId(out.tvmzId) || !askTvmaze) { return out }
142. let tries = []
143. if (imdbOr('' + out.imdbId) != null) { tries.push({ param = 'imdb' value = '' + out.imdbId }) }
144. if (numIdOr(out.tvdbId) != null) { tries.push({ param = 'thetvdb' value = '' + out.tvdbId }) }
145. for (t of tries) {
146. if (!hasId(out.tvmzId) && out.failed == null) {
147. out.tvmazeRequests = out.tvmazeRequests + 1
148. let found = tvmazeLookup(t.param, t.value)
149. if (found.failed != null) { out.failed = found.failed } else if (found.id != null) { out.tvmzId = found.id out.filled = out.filled + 1 }
150. }
151. }
152. return out
153. }
155. // ---- TVmaze merge (tracker.worldapi.org#15) ------------------------------------------------------
156. // a title that is none yet: empty, "TBA"/"TBD", or "Episode <n>" (what TMDB and TVmaze name an untitled episode; also
157. // French/German/Spanish: real data has TVmaze "Épisode 1" where TMDB says "Episode 1")
158. static placeholderWords = ['episode', 'épisode', 'Épisode', 'folge', 'episodio']
159. static isPlaceholderTitle = (v) => {
160. let t = textOr(v)
161. if (t == null) { return true }
162. let l = t.trim().toLowerCase()
163. if (l == 'tba' || l == 'tbd' || l == 'tba.' || l == 'to be announced') { return true }
164. let parts = l.split(' ')
165. if (parts.length != 2 || !placeholderWords.includes(parts[0]) || parts[1].length == 0) { return false }
166. let i = 0
167. while (i < parts[1].length) {
168. if (!'0123456789'.includes(parts[1][i])) { return false }
169. i = i + 1
170. }
171. return true
172. }
174. // 'YYYY-MM-DD' → a day number (only differences matter), null when it is no such date
175. static dayNumber = (v) => {
176. let t = textOr(v)
177. if (t == null || t.length < 10) { return null }
178. let y = toNumber(t.slice(0, 4))
179. let m = toNumber(t.slice(5, 7))
180. let d = toNumber(t.slice(8, 10))
181. if (y == null || m == null || d == null || m < 1 || m > 12) { return null }
182. let before = [0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334]
183. let py = m <= 2 ? y - 1 : y
184. let leaps = (py - py % 4) / 4 - (py - py % 100) / 100 + (py - py % 400) / 400
185. return y * 365 + leaps + before[m - 1] + d
186. }
187. static daysApart = (a, b) => {
188. let x = dayNumber(a)
189. let y = dayNumber(b)
190. if (x == null || y == null) { return null }
191. return x > y ? x - y : y - x
192. }
194. // TVmaze's episode list of one show: a list, or { failed }
195. static tvmazeEpisodes = (tvmzId) => {
196. let r = fetch(tvmazeBase + '/shows/' + tvmzId + '/episodes', { headers = { 'accept' = 'application/json' 'user-agent' = 'tracker.worldapi.org (tmdb sync)' } timeoutMs = 20000 })
197. if (r == null || r.status == null || r.status == 0) { return { failed = 'TVmaze: no answer for episodes of ' + tvmzId } }
198. if (r.status != 200) { return { failed = 'TVmaze: HTTP ' + r.status + ' for episodes of ' + tvmzId } }
199. let j = r.json()
200. if (j == null || j.length == null) { return { failed = 'TVmaze: no episode list for ' + tvmzId } }
201. return { list = j }
202. }
204. // do we and TVmaze number a show the same way? Of the episodes both know (same S/E), at least 80 % must air within a day
205. // of each other OR carry the same title (a streaming show TVmaze dates all on its release day, TMDB week by week, still
206. // agrees by title). A show we have episodes of but TVmaze numbers none of the same (e.g. seasons by year) never agrees.
207. // Answers { known, compared, agree, ok }.
208. static sameTitle = (a, b) => { return !isPlaceholderTitle(a) && !isPlaceholderTitle(b) && a.trim().toLowerCase() == b.trim().toLowerCase() }
209. static numberingAgrees = (epByNumber, list) => {
210. let out = { known = 0 compared = 0 agree = 0 ok = true }
211. let localCount = epByNumber.keys().length
212. for (te of list) {
213. let e = epByNumber[te.season + 'x' + te.number]
214. if (e != null) {
215. out.known = out.known + 1
216. let apart = daysApart(e.release, te.airdate)
217. let titled = !isPlaceholderTitle(e.title) && !isPlaceholderTitle(te.name)
218. if (apart != null || titled) {
219. out.compared = out.compared + 1
220. if ((apart != null && apart <= 1) || sameTitle(e.title, te.name)) { out.agree = out.agree + 1 }
221. }
222. }
223. }
224. out.ok = !((localCount > 0 && out.known == 0) || (out.compared > 0 && out.agree * 5 < out.compared * 4))
225. return out
226. }
228. // Merge TVmaze's episodes of a series into what we have AFTER the TMDB step (gaps only, rules at the top).
229. // `seasonsByNumber` / `epByNumber` = the show's seasons by number and episodes by '<s>x<e>', as the TMDB step left them.
230. // Answers { tvmazeRequests, newSeasons, newEpisodes, filledEpisodes, skipped, errors, error, showSeasons }.
231. static mergeTvmaze = (title, showKey, tvmzId, seasonsIn, episodesIn, showSeasonsIn) => {
232. let seasonsByNumber = seasonsIn
233. let epByNumber = episodesIn
234. let out = { tvmazeRequests = 1 newSeasons = 0 newEpisodes = 0 filledEpisodes = 0 skipped = 0 errors = 0 error = '' showSeasons = showSeasonsIn }
235. let got = tvmazeEpisodes(tvmzId)
236. if (got.failed != null) { out.errors = 1 out.error = title + ': ' + got.failed return out }
237. // the numbered episodes TVmaze has in seasons we take (no specials; season 0 only when the show has one)
238. let list = []
239. for (te of got.list) {
240. if (numIdOr(te.season) != null && numIdOr(te.number) != null) { list.push(te) }
241. else if (te.season == 0 && numIdOr(te.number) != null && seasonsByNumber['0'] != null) { list.push(te) }
242. }
243. if (!numberingAgrees(epByNumber, list).ok) { out.skipped = 1 return out }
245. let added = {}
246. let addedFirstDate = {}
247. for (te of list) {
248. let key = te.season + 'x' + te.number
249. let e = epByNumber[key]
250. if (e == null) {
251. let seasonKey = seasonsByNumber['' + te.season] != null ? seasonsByNumber['' + te.season].id : null
252. if (seasonKey == null) {
253. if (added['' + te.season] == null) { added['' + te.season] = [] addedFirstDate['' + te.season] = textOr(te.airdate) seasonsByNumber['' + te.season] = { id = newId() isNew = true } }
254. seasonKey = seasonsByNumber['' + te.season].id
255. }
256. let fresh = { id = newId() episodeNumber = te.number seasonNumber = te.season
257. title = textOr(te.name) summary = '' release = textOr(te.airdate)
258. show = showKey season = seasonKey tmdbId = null tvmzId = te.id oldId = 'tvmaze-episode:' + te.id }
259. if (episodesTable.put(fresh) == null) {
260. out.errors = out.errors + 1
261. out.error = title + ': TVmaze episode ' + te.id + ' not stored: ' + episodesTable.lastError()
262. } else {
263. if (added['' + te.season] == null) { added['' + te.season] = [] }
264. let l = added['' + te.season]
265. l.push(fresh.id)
266. added['' + te.season] = l
267. epByNumber[key] = fresh
268. out.newEpisodes = out.newEpisodes + 1
269. }
270. } else {
271. let changed = false
272. if (isPlaceholderTitle(e.title) && !isPlaceholderTitle(te.name)) { e.title = te.name changed = true }
273. if (textOr(e.release) == null && textOr(te.airdate) != null) { e.release = te.airdate changed = true }
274. if (changed) {
275. if (episodesTable.update(e.id, e) == null) {
276. out.errors = out.errors + 1
277. out.error = title + ': episode ' + e.id + ' not filled from TVmaze: ' + episodesTable.lastError()
278. } else {
279. epByNumber[key] = e
280. out.filledEpisodes = out.filledEpisodes + 1
281. }
282. }
283. }
284. }
285. // the seasons that got episodes: an existing one is updated, a new one stored and linked to the show
286. let showSeasons = []
287. for (sid of showSeasonsIn) { showSeasons.push(sid) }
288. for (n of added.keys()) {
289. let ids = added[n]
290. let s = seasonsByNumber[n]
291. if (ids.length > 0 && s.isNew == true) {
292. let season = { id = s.id seasonNumber = toNumber(n) title = 'Season ' + n release = addedFirstDate[n] summary = ''
293. show = showKey episodes = ids oldId = 'tvmaze-season:' + tvmzId + ':' + n }
294. if (seasonsTable.put(season) == null) {
295. out.errors = out.errors + 1
296. out.error = title + ': TVmaze season ' + n + ' not stored: ' + seasonsTable.lastError()
297. } else {
298. showSeasons.push(season.id)
299. out.newSeasons = out.newSeasons + 1
300. }
301. } else if (ids.length > 0) {
302. let season = seasonsTable.fetch(s.id)
303. let eps = []
304. for (eid of season.episodes) { eps.push(eid) }
305. for (eid of ids) { eps.push(eid) }
306. season.episodes = eps
307. if (seasonsTable.update(season.id, season) == null) {
308. out.errors = out.errors + 1
309. out.error = title + ': season ' + season.id + ' not updated: ' + seasonsTable.lastError()
310. }
311. }
312. }
313. out.showSeasons = showSeasons
314. return out
315. }
317. // ---- posters ----------------------------------------------------------------------------------
318. // the extension of a TMDB poster_path ('/abc.jpg' → 'jpg'); only the ones the poster route knows
319. static posterExt = (posterPath) => {
320. let parts = posterPath.split('.')
321. let ext = parts[parts.length - 1].toLowerCase()
322. if (ext == 'jpg' || ext == 'jpeg' || ext == 'png' || ext == 'webp') { return ext }
323. return null
324. }
326. // downloads the w342 poster when the file is missing or TMDB has a new one; answers { requests, saved, failed }
327. // and sets show.image / show.tmdbPoster on the (caller's) record — the file is <oldId>.<ext>, the name
328. // shows.hl posterName() already builds, served by project.hl's /posters/:name route
329. static syncPoster = (show, posterPath) => {
330. let out = { requests = 0 saved = 0 failed = null image = show.image tmdbPoster = show.tmdbPoster }
331. if (textOr(posterPath) == null || show.oldId == null) { return out }
332. let ext = posterExt(posterPath)
333. if (ext == null) { return out }
334. let file = postersDir + '/' + show.oldId + '.' + ext
335. if (exists(file) && show.tmdbPoster == posterPath && show.image == ext) { return out }
336. out.requests = 1
337. let r = fetch(tmdbImageBase + '/w342' + posterPath, { headers = { 'user-agent' = 'tracker.worldapi.org (tmdb sync)' } timeoutMs = 20000 })
338. if (r == null || r.status != 200 || r.body == null || r.body.length == 0) {
339. out.failed = 'poster ' + posterPath + ': ' + (r == null ? 'no answer' : 'HTTP ' + r.status)
340. return out
341. }
342. mkDir(postersDir)
343. writeFile(file, toBytes(r.body), 420)
344. out.saved = 1
345. out.image = ext
346. out.tmdbPoster = posterPath
347. return out
348. }
350. // ---- one show -----------------------------------------------------------------------------------
351. static newId = () => { return randomBytes(8, 'hex') }
353. // TMDB's adult flag of a details/search answer: true / false, null when it has none (mission 054)
354. static adultOf = (j) => {
355. if (j == null) { return null }
356. if (j.adult == true) { return true }
357. if (j.adult == false) { return false }
358. return null
359. }
361. // which TMDB seasons to sync: every numbered one with episodes; 0 only when the show has a season 0 already
362. static wantedSeasonNumbers = (details, localByNumber) => {
363. let out = []
364. if (details.seasons == null) { return out }
365. for (s of details.seasons) {
366. let n = s.season_number
367. if (n != null && (n > 0 || localByNumber['' + n] != null) && (s.episode_count == null || s.episode_count > 0 || localByNumber['' + n] != null)) { out.push(n) }
368. }
369. return out
370. }
372. // the seasons in batches of 20 (TMDB's append_to_response limit)
373. static batchesOf = (list, size) => {
374. let out = []
375. let cur = []
376. for (x of list) {
377. cur.push(x)
378. if (cur.length == size) { out.push(cur) cur = [] }
379. }
380. if (cur.length > 0) { out.push(cur) }
381. return out
382. }
384. // fields of an episode/season from TMDB that differ from the stored record (null/empty never overwrites)
385. static changedText = (stored, fresh) => { return fresh != null && fresh != stored }
387. // a MOVIE: one request — its imdb id (if missing) and its poster; nothing else of the record is touched. `pre` = that
388. // request's answer when the caller already made it (details.hl firstStep, tracker#26), else null
389. static syncMovie = (show, res, pre) => {
390. let out = res
391. out.requests = 1
392. let details = pre != null ? pre : tmdbGet('/movie/' + show.tmdbId + '?append_to_response=external_ids,credits')
393. if (details.failed != null) { out.errors = 1 out.error = show.title + ': ' + details.failed return out }
394. if (pre == null) { out.details = details }
395. let ids = externalIdsFor(show, details.external_ids, false, false)
396. out.ids = ids.filled
397. let poster = syncPoster(show, details.poster_path)
398. out.requests = out.requests + poster.requests
399. out.posters = poster.saved
400. if (poster.failed != null) { out.errors = out.errors + 1 out.error = show.title + ': ' + poster.failed }
401. let m = show
402. m.imdbId = ids.imdbId
403. m.image = poster.image
404. m.tmdbPoster = poster.tmdbPoster
405. if (adultOf(details) != null) { m.adult = adultOf(details) }
406. m.tmdbSync = now()
407. if (showsTable.update(m.id, m) == null) { out.errors = out.errors + 1 out.error = show.title + ': movie not updated: ' + showsTable.lastError() }
408. return out
409. }
411. // Sync ONE show (by our id). Answers counts: { requests, tvmazeRequests, newSeasons, newEpisodes, updatedEpisodes,
412. // updatedSeasons, posters, ids, tvmazeEpisodes, tvmazeSeasons, tvmazeFilled, tvmazeSkipped, errors, error } + `details` (the
413. // details answer with its credits when this call asked for it, else null — tracker#28: the caller stores the credits). Never throws for a TMDB failure — it is counted and the show left as is.
414. static syncShow = (showId) => { return syncShowPart(showId, null, null) }
415. // the same with the details request (`/tv|movie/<id>?append_to_response=external_ids…`) already answered — `pre`, counted as
416. // this show's first request — so details.hl (tracker#26) asks TMDB once for details, ids AND the cast
417. static syncShowWith = (showId, pre) => { return syncShowPart(showId, pre, null) }
418. // ONE PART of a series' sync (tracker#26: a talk show with 4,000 episodes took 10 s in one step, blocking every request):
419. // `only` = { seasons (the TMDB season numbers of this part), finish (false: only those seasons — new ones linked to the show,
420. // nothing else; true: the ids, TVmaze, poster and the show record) }; null = everything at once. `pre` is required with
421. // `only` (its request is the caller's: a part counts only its own requests).
422. static syncShowPart = (showId, pre, only) => {
423. let res = { requests = 0 tvmazeRequests = 0 newSeasons = 0 newEpisodes = 0 updatedEpisodes = 0 updatedSeasons = 0 posters = 0 ids = 0 tvmazeEpisodes = 0 tvmazeSeasons = 0 tvmazeFilled = 0 tvmazeSkipped = 0 errors = 0 error = '' details = null }
424. let show = showsTable.fetch(showId)
425. if (show == null) { res.errors = 1 res.error = 'no show ' + showId return res }
426. if (show.tmdbId == null) { res.errors = 1 res.error = show.title + ': no tmdbId' return res }
427. if (show.type == 'movie') { return syncMovie(show, res, pre) }
429. res.requests = only != null ? 0 : 1
430. let details = pre != null ? pre : tmdbGet('/tv/' + show.tmdbId + '?append_to_response=external_ids,aggregate_credits')
431. if (details.failed != null) { res.errors = 1 res.error = show.title + ': ' + details.failed return res }
432. if (pre == null) { res.details = details }
434. // what we have: seasons by number, episodes by tmdbId and by S/E number
435. let seasonsByNumber = {}
436. let epByTmdb = {}
437. let epByNumber = {}
438. for (sid of show.seasons) {
439. let s = seasonsTable.fetch(sid)
440. if (s != null) {
441. seasonsByNumber['' + s.seasonNumber] = s
442. for (eid of s.episodes) {
443. let e = episodesTable.fetch(eid)
444. if (e != null) {
445. if (e.tmdbId != null) { epByTmdb['' + e.tmdbId] = e }
446. epByNumber[e.seasonNumber + 'x' + e.episodeNumber] = e
447. }
448. }
449. }
450. }
452. // plain locals for the record literals below: inside a literal, an entry named `show`/`season` would shadow
453. // the variable for every later entry (SPEC "A literal's entries are evaluated in order")
454. let showKey = show.id
455. let showTmdb = show.tmdbId
456. let showSeasons = []
457. for (sid of show.seasons) { showSeasons.push(sid) }
458. let showChanged = false
460. let wanted = wantedSeasonNumbers(details, seasonsByNumber)
461. if (only != null) {
462. let part = []
463. for (n of wanted) { if (only.seasons.includes(n)) { part.push(n) } }
464. wanted = part
465. }
466. for (batch of batchesOf(wanted, 20)) {
467. let names = []
468. for (n of batch) { names.push('season/' + n) }
469. res.requests = res.requests + 1
470. let withSeasons = tmdbGet('/tv/' + show.tmdbId + '?append_to_response=' + names.join(','))
471. if (withSeasons.failed != null) {
472. res.errors = res.errors + 1
473. res.error = show.title + ': ' + withSeasons.failed
474. } else {
475. for (n of batch) {
476. let ts = withSeasons['season/' + n]
477. if (ts != null && ts.episodes != null) {
478. let season = seasonsByNumber['' + n]
479. let seasonIsNew = season == null
480. let seasonChanged = false
481. if (seasonIsNew) {
482. season = { id = newId() seasonNumber = n title = textOr(ts.name) != null ? ts.name : 'Season ' + n
483. release = textOr(ts.air_date) summary = textOr(ts.overview) != null ? ts.overview : ''
484. show = showKey episodes = [] oldId = 'tmdb-season:' + showTmdb + ':' + n }
485. } else {
486. if (changedText(season.title, textOr(ts.name))) { season.title = ts.name seasonChanged = true }
487. if (changedText(season.summary, textOr(ts.overview))) { season.summary = ts.overview seasonChanged = true }
488. if (changedText(season.release, textOr(ts.air_date))) { season.release = ts.air_date seasonChanged = true }
489. }
490. let seasonKey = season.id
491. let seasonEpisodes = []
492. for (eid of season.episodes) { seasonEpisodes.push(eid) }
493. for (te of ts.episodes) {
494. if (te.id != null && te.episode_number != null) {
495. let e = epByTmdb['' + te.id]
496. if (e == null) {
497. let byNum = epByNumber[n + 'x' + te.episode_number]
498. if (byNum != null && byNum.tmdbId == null) { e = byNum }
499. }
500. if (e == null) {
501. let fresh = { id = newId() episodeNumber = te.episode_number seasonNumber = n
502. title = textOr(te.name) summary = textOr(te.overview) != null ? te.overview : '' release = textOr(te.air_date)
503. show = showKey season = seasonKey tmdbId = te.id oldId = 'tmdb-episode:' + te.id }
504. let putId = episodesTable.put(fresh)
505. if (putId == null) {
506. res.errors = res.errors + 1
507. res.error = show.title + ': episode ' + te.id + ' not stored: ' + episodesTable.lastError()
508. } else {
509. seasonEpisodes.push(fresh.id)
510. epByTmdb['' + te.id] = fresh
511. epByNumber[n + 'x' + te.episode_number] = fresh
512. res.newEpisodes = res.newEpisodes + 1
513. seasonChanged = true
514. }
515. } else {
516. let changed = false
517. if (e.tmdbId == null) { e.tmdbId = te.id changed = true }
518. // #15: TMDB's "Episode 4" never replaces a real title (one TVmaze filled, or the migrated one)
519. if (changedText(e.title, textOr(te.name)) && !(isPlaceholderTitle(te.name) && !isPlaceholderTitle(e.title))) { e.title = te.name changed = true }
520. if (changedText(e.summary, textOr(te.overview))) { e.summary = te.overview changed = true }
521. if (changedText(e.release, textOr(te.air_date))) { e.release = te.air_date changed = true }
522. if (changed) {
523. if (episodesTable.update(e.id, e) == null) {
524. res.errors = res.errors + 1
525. res.error = show.title + ': episode ' + e.id + ' not updated: ' + episodesTable.lastError()
526. } else {
527. epByTmdb['' + e.tmdbId] = e
528. epByNumber[e.seasonNumber + 'x' + e.episodeNumber] = e
529. res.updatedEpisodes = res.updatedEpisodes + 1
530. }
531. }
532. }
533. }
534. }
535. season.episodes = seasonEpisodes
536. if (seasonIsNew) {
537. if (seasonsTable.put(season) == null) {
538. res.errors = res.errors + 1
539. res.error = show.title + ': season ' + n + ' not stored: ' + seasonsTable.lastError()
540. } else {
541. seasonsByNumber['' + n] = season
542. showSeasons.push(season.id)
543. showChanged = true
544. res.newSeasons = res.newSeasons + 1
545. }
546. } else if (seasonChanged) {
547. if (seasonsTable.update(season.id, season) == null) {
548. res.errors = res.errors + 1
549. res.error = show.title + ': season ' + season.id + ' not updated: ' + seasonsTable.lastError()
550. } else {
551. res.updatedSeasons = res.updatedSeasons + 1
552. }
553. }
554. }
555. }
556. }
557. }
559. // a part that is not the last: only the new seasons are linked to the show (the next part reads them)
560. if (only != null && !only.finish) {
561. if (showChanged) {
562. show.seasons = showSeasons
563. if (showsTable.update(show.id, show) == null) { res.errors = res.errors + 1 res.error = show.title + ': show not updated: ' + showsTable.lastError() }
564. }
565. return res
566. }
568. // the external ids (tracker.worldapi.org#12): missing ones from TMDB's external_ids, a missing TVmaze id from TVmaze
569. let ids = externalIdsFor(show, details.external_ids, true, true)
570. res.ids = ids.filled
571. res.tvmazeRequests = ids.tvmazeRequests
572. if (ids.failed != null) { res.errors = res.errors + 1 res.error = show.title + ': ' + ids.failed }
574. // tracker.worldapi.org#15: what TVmaze has and TMDB not yet (new episodes/seasons, empty titles and air dates)
575. if (numIdOr(ids.tvmzId) != null) {
576. let tvm = mergeTvmaze(show.title, showKey, ids.tvmzId, seasonsByNumber, epByNumber, showSeasons)
577. res.tvmazeRequests = res.tvmazeRequests + tvm.tvmazeRequests
578. res.tvmazeEpisodes = tvm.newEpisodes
579. res.tvmazeSeasons = tvm.newSeasons
580. res.tvmazeFilled = tvm.filledEpisodes
581. res.tvmazeSkipped = tvm.skipped
582. if (tvm.errors > 0) { res.errors = res.errors + tvm.errors res.error = tvm.error }
583. showSeasons = tvm.showSeasons
584. }
586. // the show itself: status, counts, TMDB's overview, the poster, when it was synced
587. let poster = syncPoster(show, details.poster_path)
588. res.requests = res.requests + poster.requests
589. res.posters = poster.saved
590. if (poster.failed != null) { res.errors = res.errors + 1 res.error = show.title + ': ' + poster.failed }
591. show.seasons = showSeasons
592. if (textOr(details.status) != null) { show.status = details.status }
593. if (details.number_of_seasons != null) { show.seasonsCount = details.number_of_seasons }
594. if (details.number_of_episodes != null) { show.episodesCount = details.number_of_episodes }
595. if (textOr(details.overview) != null) { show.tmdbSummary = details.overview }
596. show.image = poster.image
597. show.tmdbPoster = poster.tmdbPoster
598. show.imdbId = ids.imdbId
599. show.tvdbId = ids.tvdbId
600. show.tvmzId = ids.tvmzId
601. if (adultOf(details) != null) { show.adult = adultOf(details) }
602. show.tmdbSync = now()
603. if (showsTable.update(show.id, show) == null) { res.errors = res.errors + 1 res.error = show.title + ': show not updated: ' + showsTable.lastError() }
604. return res
605. }
607. // ---- the adult backfill (mission 054) ------------------------------------------------------------
608. // a title still to ask: its adult flag unknown, it has a tmdbId and TMDB never answered "no such title" for it
609. static needsAdultFlag = (show) => { return show.adult != true && show.adult != false && show.adultCheck == null && show.tmdbId != null }
611. // the ids of every title the backfill still has to ask, in table order (read once when the backfill starts — so after a
612. // restart it goes on with what is left)
613. static adultBackfillQueue = () => {
614. let out = []
615. for (s of showsTable.find(null, null)) { if (needsAdultFlag(s)) { out.push(s.id) } }
616. return out
617. }
619. // ONE title: one TMDB details request (adult, poster_path, external ids) + its poster when the file is missing. Answers
620. // { requests (TMDB API requests: what the pause counts), posters, adult (true / false / null), ids, errors, error, retry
621. // (a passing failure: no answer, 429, 5xx — ask again later) }. A 404 marks the title `adultCheck` (never asked again).
622. static backfillTitle = (showId) => {
623. let out = { requests = 0 posters = 0 adult = null ids = 0 errors = 0 error = '' retry = false }
624. let show = showsTable.fetch(showId)
625. if (show == null || !needsAdultFlag(show)) { return out }
626. let movie = show.type == 'movie'
627. out.requests = 1
628. let details = tmdbGet((movie ? '/movie/' : '/tv/') + show.tmdbId + '?append_to_response=external_ids')
629. if (details.failed != null) {
630. out.errors = 1
631. out.error = show.title + ': ' + details.failed
632. if (details.status == 404) {
633. show.adultCheck = 'TMDB 404'
634. showsTable.update(show.id, show)
635. } else { out.retry = true }
636. return out
637. }
638. let ids = externalIdsFor(show, details.external_ids, !movie, false)
639. out.ids = ids.filled
640. out.adult = adultOf(details)
641. // an ADULT title's poster is never shown publicly → not downloaded (mission 056: ~170 MB of the live data); its flag and
642. // ids are stored as for any other title
643. let poster = { saved = 0 failed = null image = show.image tmdbPoster = show.tmdbPoster }
644. if (out.adult != true) { poster = syncPoster(show, details.poster_path) }
645. out.posters = poster.saved
646. if (poster.failed != null) { out.errors = out.errors + 1 out.error = show.title + ': ' + poster.failed }
647. if (out.adult == null) { show.adultCheck = 'TMDB gave no adult flag' } else { show.adult = out.adult }
648. show.imdbId = ids.imdbId
649. show.tvdbId = ids.tvdbId
650. show.image = poster.image
651. show.tmdbPoster = poster.tmdbPoster
652. if (showsTable.update(show.id, show) == null) { out.errors = out.errors + 1 out.error = show.title + ': not updated: ' + showsTable.lastError() }
653. return out
654. }
656. // flush the three tables' index/meta state to disk (after a run, and every few shows)
657. static persistSync = () => {
658. showsTable.persist()
659. seasonsTable.persist()
660. episodesTable.persist()
661. return true
662. }
664. // totals of a run: the per-show counts added up
665. static emptyTotals = () => { return { shows = 0 requests = 0 tvmazeRequests = 0 newSeasons = 0 newEpisodes = 0 updatedEpisodes = 0 updatedSeasons = 0 posters = 0 ids = 0 tvmazeEpisodes = 0 tvmazeSeasons = 0 tvmazeFilled = 0 tvmazeSkipped = 0 errors = 0 } }
666. static addTotals = (t, r) => {
667. let o = t
668. o.shows = o.shows + 1
669. o.requests = o.requests + r.requests
670. o.tvmazeRequests = o.tvmazeRequests + r.tvmazeRequests
671. o.ids = o.ids + r.ids
672. o.newSeasons = o.newSeasons + r.newSeasons
673. o.newEpisodes = o.newEpisodes + r.newEpisodes
674. o.updatedEpisodes = o.updatedEpisodes + r.updatedEpisodes
675. o.updatedSeasons = o.updatedSeasons + r.updatedSeasons
676. o.posters = o.posters + r.posters
677. o.tvmazeEpisodes = o.tvmazeEpisodes + r.tvmazeEpisodes
678. o.tvmazeSeasons = o.tvmazeSeasons + r.tvmazeSeasons
679. o.tvmazeFilled = o.tvmazeFilled + r.tvmazeFilled
680. o.tvmazeSkipped = o.tvmazeSkipped + r.tvmazeSkipped
681. o.errors = o.errors + r.errors
682. return o
683. }
684. static totalsLine = (t) => {
685. return 'shows=' + t.shows + ' newSeasons=' + t.newSeasons + ' newEpisodes=' + t.newEpisodes + ' updatedEpisodes=' + t.updatedEpisodes
686. + ' updatedSeasons=' + t.updatedSeasons + ' posters=' + t.posters + ' ids=' + t.ids + ' requests=' + t.requests + ' tvmazeRequests=' + t.tvmazeRequests + ' errors=' + t.errors
687. + ' tvmazeEpisodes=' + t.tvmazeEpisodes + ' tvmazeSeasons=' + t.tvmazeSeasons + ' tvmazeFilled=' + t.tvmazeFilled + ' tvmazeSkipped=' + t.tvmazeSkipped
688. }