tracker

29.5 KB

1. // project.hl — tracker.worldapi.org: STEP 1 (tracker.worldapi.org#1), an empty shell. Login copied unchanged from
2. // calendar.worldapi.org (rejected once for a centered sign-in and no header selector — architect, 2026-09-27):
3. // ident only, no own passwords (README "How apps use ident" of ident.worldapi.org), the identity selector in the
4. // header (components/main.hl). No shows, no data yet — later steps come from the creator (CONCEPT.md).
5. //
6. // the header's ident-selector / "Log in with ident" -> <ident>/login?key=&return=<this app>/login/callback
7. // /login/callback?ident_code=<code> the app's server exchanges the code for the identity's short id
8. // (POST <ident>/api/exchange) and signs this app's OWN session in
9. // (session.user = { id = <users @id> }, users.hl)
10. // the header's "Log out" button signs this app's session out via the face trackerLogOut (components/main.hl)
11. // — ident's own session, and the browser's ident cookie, are untouched
12. //
13. // Config (env; no committed secret — the first deploy registers this app in ident and sets these, done by the
14. // architect, as with ident's own .env for SMTP):
15. // TRACKER_PORT (45008), TRACKER_URL (this app's own public address, for the return URL),
16. // IDENT_URL (https://ident.worldapi.org), TRACKER_KEY (pk_…), TRACKER_SECRET (sk_…)
17. import WebFramework from 'hl:web'
18. import { Response } from 'hl:http1'
19. import { randomBytes } from 'hl:crypto'
20. import { env } from 'hl:proc'
21. import { readBytes, exists } from 'hl:fs'
22. import { now, timestamp, every } from 'hl:time'
24. import Styles from './styles.hl'
25. import { exchangeCode, ensureUser } from './users.hl'
26. import Home from './components/home.hl'
27. import LoginFailed from './components/loginfailed.hl'
28. import Show from './components/show.hl'
29. import Unwatched from './components/unwatched.hl'
30. import Schedule from './components/schedule.hl'
31. import MyShows from './components/myshows.hl'
32. import MyMovies from './components/mymovies.hl'
33. import Movies from './components/movies.hl'
34. import AllShows from './components/allshows.hl'
35. import AllSeries from './components/allseries.hl'
36. import Search from './components/search.hl'
37. import Person from './components/person.hl'
38. import Genre from './components/genre.hl'
39. import { ensureIndex, searchTitleChanged } from './search.hl'
40. import { syncEnabled, syncShow, persistSync, emptyTotals, addTotals, totalsLine, pauseMsAfter, msPerRequest, adultBackfillQueue, backfillTitle, kindBackfillQueue, kindTitle } from './tmdbsync.hl'
41. import { showBySlug, titleKind, titlePath } from './shows.hl'
42. import { allFollowedShowIds } from './follows.hl'
43. import { refreshCatalogShow } from './catalog.hl'
44. import { ensureShortIds, shortIdStep, shortIdPath, shortIdsLeft, shortIdStats, persistShortIds } from './shortids.hl'
45. import { dark, darker } from './shared/tokens.hl'
47. static appTitle = "tracker"
49. // ---- THE INSTALLABLE APP (tracker.worldapi.org#10), the same way calendar.worldapi.org does it: hl:web's own web app
50. // manifest (/__hl/manifest.webmanifest, linked from every head with the apple-touch-icon and theme-color) and service
51. // worker (/__hl/sw.js) from these settings — no JavaScript of ours. Icons in icons/ (icon.svg is the source, the PNGs
52. // are rendered from it with rsvg-convert, README "Icons"). The theme colour is the header's background (darker), the
53. // splash background the page's (dark) — both off the tokens, not written out again.
54. appThemeColor = darker.value
55. appBackgroundColor = dark.value
56. appIcons = [
57. { src = '/icons/icon-192.png' sizes = '192x192' purpose = 'any' }
58. { src = '/icons/icon-512.png' sizes = '512x512' purpose = 'any' }
59. { src = '/icons/icon-192.png' sizes = '192x192' purpose = 'maskable' }
60. { src = '/icons/icon-512.png' sizes = '512x512' purpose = 'maskable' }
61. ]
62. appTouchIcon = '/icons/apple-touch-icon.png'
63. appFavicon = '/icons/favicon.svg'
64. // OFFLINE: only the shell — the header and `/` (components/main.hl says "You are offline" while the browser has no
65. // network). The data pages are not kept: without a network they get hl:web's "Unavailable offline" page.
66. offline = [ Home ]
68. styles = Styles
70. port = env('TRACKER_PORT') != null ? toNumber(env('TRACKER_PORT')) : 45008
71. watching = env('TRACKER_WATCH') != '0'
72. // read by hl:web's own manifest config (WebFramework.hl `cfg.sessionDir`), not the constructor call below
73. sessionDir = env('TRACKER_SESSIONS') != null ? env('TRACKER_SESSIONS') : null
75. // ---- THE LOGIN BUTTON'S RETURN (ident README "How apps use ident"), copied from calendar.worldapi.org's project.hl
76. // BACK TO THE PAGE: /login.js puts `?next=` into the button's return URL at the click. Only a same-origin PATH
77. // goes (one `/`, URL-safe characters, ≤ 500). Anything else → `/`.
78. nextChars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~/?&=%+,;@!$()*:'
79. safePath = (want) => {
80. if (want == null || hlTypeName(want) != 'String' || want == '' || want.length > 500) { return '/' }
81. if (want.slice(0, 1) != '/' || want.slice(0, 2) == '//' || want.slice(0, 7) == '/login/') { return '/' }
82. let i = 0
83. while (i < want.length) {
84. if (!nextChars.includes(want[i])) { return '/' }
85. i = i + 1
86. }
87. return want
88. }
90. // A FAILED LOGIN is a page (components/loginfailed.hl): the reason is parked in the session, then → /login/failed
91. failed = (req, why) => {
92. let s = req.session
93. let fresh = s == null
94. if (fresh) { s = server.sessions.mint() }
95. s.data.loginError = why
96. server.sessions.save(s)
97. let res = new Response('login failed: ' + why, { status = 302 headers = { 'Location' = '/login/failed' 'Cache-Control' = 'no-store' 'Content-Type' = 'text/plain; charset=utf-8' } })
98. if (fresh) { res.headers['Set-Cookie'] = server.sessions.cookieHeader(s.id) }
99. return res
100. }
102. // the function route gets the cookie's session as req.session (hybriel #11); none yet → minted here
103. loginCallback = (route, req) => {
104. if (req.method != 'GET') { return failed(req, 'GET only') }
105. let q = req.query != null ? req.query : {}
106. let code = q.ident_code
107. if (code == null || code == '') { return failed(req, 'ident sent no login code') }
108. let x = exchangeCode(code)
109. if (x.error != null) { return failed(req, x.error) }
110. let u = ensureUser(x.identity)
111. if (u == null) { return failed(req, 'could not store the user') }
112. let s = req.session
113. let fresh = s == null
114. if (fresh) { s = server.sessions.mint() }
115. s.user = { id = u.id }
116. s.data.tag = randomBytes(16)
117. s.data.loginError = null
118. server.sessions.save(s)
119. let res = new Response('logged in', { status = 302 headers = { 'Location' = safePath(q.next) 'Cache-Control' = 'no-store' 'Content-Type' = 'text/plain; charset=utf-8' } })
120. if (fresh) { res.headers['Set-Cookie'] = server.sessions.cookieHeader(s.id) }
121. return res
122. }
124. // ---- /posters/<name> (tracker.worldapi.org#4): a show's poster image, served dynamically from
125. // storage/mpackdb/posters/ (the poster's file name is the show's oldId + its migrated extension,
126. // shows.hl posterName) — falls back to a placeholder svg when the real file isn't there yet (the
127. // mongo export never included the actual poster bytes, see the report's `open`).
128. postersDir = (env('TRACKER_STORAGE') != null ? env('TRACKER_STORAGE') : './storage/mpackdb') + '/posters'
129. placeholderPoster = './assets/poster-placeholder.svg'
130. posterNameChars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789.-_'
131. isSafePosterName = (name) => {
132. if (name == null || hlTypeName(name) != 'String' || name == '' || name.length > 100) { return false }
133. let i = 0
134. while (i < name.length) {
135. if (!posterNameChars.includes(name[i])) { return false }
136. i = i + 1
137. }
138. return true
139. }
140. endsWithStr = (s, suffix) => { return s.length >= suffix.length && s.slice(s.length - suffix.length) == suffix }
141. mimeOfPoster = (name) => {
142. if (endsWithStr(name, '.png')) { return 'image/png' }
143. if (endsWithStr(name, '.webp')) { return 'image/webp' }
144. if (endsWithStr(name, '.svg')) { return 'image/svg+xml' }
145. return 'image/jpeg'
146. }
147. posterRoute = (route, req) => {
148. let name = route.params != null ? route.params.name : null
149. if (!isSafePosterName(name)) { return new Response('bad poster name', { status = 400 headers = { 'Content-Type' = 'text/plain; charset=utf-8' } }) }
150. let path = postersDir + '/' + name
151. if (exists(path)) { return new Response(readBytes(path), { headers = { 'Content-Type' = mimeOfPoster(name) 'Cache-Control' = 'public, max-age=86400' } }) }
152. return new Response(readBytes(placeholderPoster), { headers = { 'Content-Type' = 'image/svg+xml' 'Cache-Control' = 'public, max-age=3600' } })
153. }
155. // ---- /profiles/<name> (tracker.worldapi.org#16): a person's photo, from storage/mpackdb/profiles/ (people.hl syncProfile
156. // downloads it on the first visit of the person page) — the same checks and placeholder as /posters/<name>
157. profilesDir = (env('TRACKER_STORAGE') != null ? env('TRACKER_STORAGE') : './storage/mpackdb') + '/profiles'
158. profileRoute = (route, req) => {
159. let name = route.params != null ? route.params.name : null
160. if (!isSafePosterName(name)) { return new Response('bad photo name', { status = 400 headers = { 'Content-Type' = 'text/plain; charset=utf-8' } }) }
161. let path = profilesDir + '/' + name
162. if (exists(path)) { return new Response(readBytes(path), { headers = { 'Content-Type' = mimeOfPoster(name) 'Cache-Control' = 'public, max-age=86400' } }) }
163. return new Response(readBytes(placeholderPoster), { headers = { 'Content-Type' = 'image/svg+xml' 'Cache-Control' = 'public, max-age=3600' } })
164. }
166. // ---- the old addresses of the personal lists (tracker.worldapi.org#8): they all live under /my/ now —
167. // a permanent redirect so old links keep working (architect's decision)
168. movedTo = (path) => { return new Response('moved to ' + path, { status = 301 headers = { 'Location' = path 'Content-Type' = 'text/plain; charset=utf-8' } }) }
169. unwatchedMoved = (route, req) => { return movedTo('/my/unwatched') }
170. scheduleMoved = (route, req) => { return movedTo('/my/schedule') }
171. // mission 058: the show page's genre pills linked `/genre/<x>` (no page there) — the genre pages are `/genres/<x>`
172. genreMoved = (route, req) => {
173. let g = route.params != null ? route.params.genre : null
174. return movedTo(isSafePosterName(g) ? '/genres/' + g : '/')
175. }
176. // mission 060 (tracker.worldapi.org#27): `/<shortId>` → 301 to the title's or person's page (shortids.hl); upper case is
177. // read as lower case; anything else is a 404
178. shortIdRoute = (route, req) => {
179. let sid = route.params != null ? route.params.sid : null
180. let path = sid != null && hlTypeName(sid) == 'String' ? shortIdPath(sid.toLowerCase()) : null
181. if (path == null) { return new Response('not found', { status = 404 headers = { 'Content-Type' = 'text/plain; charset=utf-8' } }) }
182. return movedTo(path)
183. }
185. // ---- /shows/<slug> (tracker.worldapi.org#21, mission 068): since the split only the game / reality / talk / news SHOWS live
186. // here; a series answers 301 to /series/<slug>, a movie to /movies/<slug> (old links and bookmarks keep working). hl:web has no
187. // way for a component route to answer a redirect, so this is a FUNCTION route, and for a show (or an unknown slug: the page's own
188. // "Not found") it renders the title page the way hl:web renders a component route (WebFramework.hl `on http.request`, the
189. // `component` branch): the Show component matched at /series/<slug> — same component, same params — with the cookie's session,
190. // a new one (and its cookie) when the browser brought none. In the browser a link to /shows/<slug> is then a full page load
191. // (the client router only navigates component routes itself); every other title page stays a client-side navigation.
192. showsRoute = (route, req) => {
193. let slug = route.params != null ? route.params.slug : null
194. let show = showBySlug(slug)
195. if (show != null && titleKind(show) != 'show') { return movedTo(titlePath(show)) }
196. let m = server.router.match('/series/' + slug)
197. let s = req.session
198. let fresh = s == null
199. if (fresh) { s = server.sessions.mint() }
200. let res = server.page(m, s, server.hostOf(req.headers['host']), server.requestHeaders(req.headers))
201. if (fresh) { res.headers['Set-Cookie'] = server.sessions.cookieHeader(s.id) }
202. return res
203. }
205. routes = [
206. { pattern = "/favicon.ico" file = "./icons/favicon.ico" headers = { 'Cache-Control' = 'no-cache' } }
207. // the installable app (tracker.worldapi.org#10): the icons (manifest and service worker are hl:web's own, from appIcons / offline)
208. { pattern = "/icons/icon-192.png" file = "./icons/icon-192.png" headers = { 'Cache-Control' = 'no-cache' } }
209. { pattern = "/icons/icon-512.png" file = "./icons/icon-512.png" headers = { 'Cache-Control' = 'no-cache' } }
210. { pattern = "/icons/apple-touch-icon.png" file = "./icons/apple-touch-icon.png" headers = { 'Cache-Control' = 'no-cache' } }
211. { pattern = "/icons/favicon.svg" file = "./icons/favicon.svg" headers = { 'Cache-Control' = 'no-cache' } }
212. { pattern = "/login/callback" function = loginCallback }
213. { pattern = "/login/failed" component = LoginFailed }
214. { pattern = "/login.js" file = "./login.js" headers = { 'Cache-Control' = 'no-cache' } }
215. { pattern = "/posters/:name" function = posterRoute }
216. // tracker.worldapi.org#13: every movie / every series, 24 per page — the page is a PATH segment (`/movies/page/2`), a
217. // page component cannot read `?page=` (hybriel#11) — and the movies the user follows
218. { pattern = "/movies" component = Movies }
219. { pattern = "/movies/page/:page" component = Movies }
220. // tracker.worldapi.org#21 (mission 068): series and shows split — /series lists the series, /shows the shows; a title's page
221. // is /movies/<slug>, /series/<slug> or /shows/<slug> (one component; /shows/<slug> is showsRoute above)
222. { pattern = "/movies/:slug" component = Show }
223. { pattern = "/series" component = AllSeries }
224. { pattern = "/series/page/:page" component = AllSeries }
225. { pattern = "/series/:slug" component = Show }
226. { pattern = "/shows" component = AllShows }
227. { pattern = "/shows/page/:page" component = AllShows }
228. { pattern = "/shows/:slug" function = showsRoute }
229. { pattern = "/my/movies" component = MyMovies }
230. { pattern = "/my/unwatched" component = Unwatched }
231. { pattern = "/my/schedule" component = Schedule }
232. // #21: /my/series and /my/shows (one component, components/myshows.hl; any other word there is its "Not found")
233. { pattern = "/my/:tv" component = MyShows }
234. { pattern = "/unwatched" function = unwatchedMoved }
235. { pattern = "/schedule" function = scheduleMoved }
236. // tracker.worldapi.org#14: the search — `/search/<text>` (hl:web gives a page no query string, so not `?q=`)
237. { pattern = "/search/:q?" component = Search }
238. // tracker.worldapi.org#16: a person's page (the show page's cast and the search link here) and their photo
239. { pattern = "/person/:slug" component = Person }
240. { pattern = "/profiles/:name" function = profileRoute }
241. // mission 058 (tracker.worldapi.org#25): a genre's movies and series, like /movies (the page in the path)
242. { pattern = "/genres/:genre" component = Genre }
243. { pattern = "/genres/:genre/page/:page" component = Genre }
244. { pattern = "/genre/:genre" function = genreMoved }
245. { pattern = "/" component = Home }
246. // mission 060 (tracker.worldapi.org#27): a short id → its page (LAST: every named one-segment route above wins)
247. { pattern = "/:sid" function = shortIdRoute }
248. ]
250. // WHO GETS THE PUSH: the login state reaches the tabs of one session (components/main.hl trackerSignedIn/Out).
251. tagOf = (session) => { return session != null && session.data != null ? session.data.tag : null }
252. audience = {
253. trackerSignedIn = (tag, session) => { return tag != null && tagOf(session) == tag }
254. trackerSignedOut = (tag, session) => { return tag != null && tagOf(session) == tag }
255. }
257. // cookies are per host, not per port: an own name keeps this app's session apart from
258. // ident's own (and from any other worldapi app sharing a dev host), see ident README "Design
259. // tokens" / hybriel#10 hybriel#17.
260. sessionCookie = 'trackersid'
261. // tracker.worldapi.org#14: the search index (search.hl) is built once here at boot (~0.6 s on the real data), not by the
262. // first search
263. searchIndexReady = ensureIndex()
264. // mission 060: every short id in use (one map over shows AND persons) and the records still without one, before the first request
265. shortIdsReady = ensureShortIds()
266. server =new WebFramework(routes = routes, styles = styles, port = port, sessionCookie = sessionCookie, watchMode = watching)
268. // ---- THE DAILY TMDB SYNC (tracker.worldapi.org#9, tmdbsync.hl) --------------------------------------
269. // Once a day at TRACKER_SYNC_HOUR (UTC, default 4 — hl:time has no time zones; the container runs UTC) every
270. // followed show is synced from TMDB. hl:web serves ONE request at a time, so the run never takes the server
271. // for itself: a 1-second clock does ONE show per tick (1–3 TMDB requests + maybe its poster) and returns — the
272. // requests that queued meanwhile are served between two ticks, and a tick never starts inside a page render.
273. // After a show that made n requests the next waits n × 260 ms (TMDB: ≤ 40 requests / 10 s) + 550 ms per TVmaze lookup
274. // (≤ 20 / 10 s, tracker.worldapi.org#12).
275. // TRACKER_SYNC=0 switches it off; without TMDB_READ_TOKEN it is off too (logged once).
276. syncHour = env('TRACKER_SYNC_HOUR') != null ? toNumber(env('TRACKER_SYNC_HOUR')) : 4
277. syncOn = env('TRACKER_SYNC') != '0' && syncEnabled
278. syncQueue = []
279. syncAt = 0
280. syncDay = ''
281. syncNextAt = 0
282. syncTotals = emptyTotals()
283. syncTick = () => {
284. let t = now()
285. if (syncQueue.length == 0) {
286. let stamp = timestamp(t)
287. let day = stamp.slice(0, 10)
288. if (toNumber(stamp.slice(11, 13)) != syncHour || day == syncDay) { return null }
289. syncDay = day
290. syncQueue = allFollowedShowIds()
291. syncAt = t
292. syncNextAt = 0
293. syncTotals = emptyTotals()
294. console.log('tmdb sync: start, ' + syncQueue.length + ' followed shows')
295. return null
296. }
297. if (t < syncNextAt) { return null }
298. let id = syncQueue[0]
299. let rest = []
300. let i = 1
301. while (i < syncQueue.length) { rest.push(syncQueue[i]) i = i + 1 }
302. syncQueue = rest
303. let r = syncShow(id)
304. // the public lists (catalog.hl, tracker.worldapi.org#13): this show's place by its newest released episode; the sync
305. // also brings TMDB's adult flag (mission 054) → the search's view of it too
306. refreshCatalogShow(id)
307. searchTitleChanged(id)
308. let took = now() - t
309. syncTotals = addTotals(syncTotals, r)
310. if (r.error != '') { console.log('tmdb sync: ' + r.error) }
311. // a step blocks every request meanwhile (Saturday Night Live, 53 seasons, 4 requests: ~1.7 s) — say so in the log
312. if (took > 1500) { console.log('tmdb sync: slow step, show ' + id + ', ' + r.requests + ' requests, ' + took + ' ms') }
313. syncNextAt = now() + pauseMsAfter(r)
314. if (syncQueue.length == 0 || syncTotals.shows % 10 == 0) { persistSync() }
315. if (syncQueue.length == 0) { console.log('tmdb sync done: ' + totalsLine(syncTotals) + ' seconds=' + ((now() - syncAt) / 1000)) }
316. return null
317. }
319. // ---- THE ADULT-FLAG BACKFILL (mission 054, tmdbsync.hl backfillTitle) -----------------------------------
320. // The public lists and the search show only titles TMDB says are not adult (shows.hl isPublicTitle; unknown = hidden). At
321. // start the app collects every title whose flag is still unknown and asks TMDB for ONE title per step — like the daily
322. // sync, on the same clock, so requests queued meanwhile are served between two steps: one details request (adult,
323. // poster_path, external ids) + the poster file when missing, then a pause of 260 ms per TMDB API request (≤ 40 / 10 s;
324. // the poster comes from TMDB's image host, not the API, and is not counted). Each answered title goes into the lists
325. // (catalog.hl refreshCatalogShow) and the search at once. RESUMES after a restart: the queue is built from what is
326. // still unknown. Stops when the queue is empty; titles TMDB answers 404 for are marked (`adultCheck`) and stay hidden; a
327. // passing failure (no answer, 429, 5xx) goes to the back of the queue, at most 2 more tries per start.
328. // While the daily sync runs, the backfill waits. Log: start, every TRACKER_BACKFILL_LOG_EVERY (500) titles, done.
329. // TRACKER_BACKFILL=0 switches it off; without TMDB_READ_TOKEN it is off too.
330. backfillOn = env('TRACKER_BACKFILL') != '0' && syncEnabled
331. backfillLogEvery = env('TRACKER_BACKFILL_LOG_EVERY') != null ? toNumber(env('TRACKER_BACKFILL_LOG_EVERY')) : 500
332. backfillQueue = null
333. backfillPos = 0
334. backfillDone = false
335. backfillAt = 0
336. backfillNextAt = 0
337. backfillTries = {}
338. backfillTotals = { titles = 0 adult = 0 notAdult = 0 unknown = 0 posters = 0 ids = 0 requests = 0 errors = 0 retries = 0 }
339. backfillLine = () => {
340. let b = backfillTotals
341. return b.titles + '/' + backfillQueue.length + ' titles, adult=' + b.adult + ' notAdult=' + b.notAdult + ' unknown=' + b.unknown + ' posters=' + b.posters
342. + ' ids=' + b.ids + ' requests=' + b.requests + ' errors=' + b.errors + ' retries=' + b.retries + ' seconds=' + ((now() - backfillAt) / 1000)
343. }
344. backfillTick = () => {
345. if (backfillDone) { return null }
346. let t = now()
347. if (backfillQueue == null) {
348. backfillQueue = adultBackfillQueue()
349. backfillAt = t
350. console.log('adult backfill: start, ' + backfillQueue.length + ' titles without an adult flag (' + (now() - t) + ' ms to find them)')
351. if (backfillQueue.length == 0) { backfillDone = true console.log('adult backfill: nothing to do') }
352. return null
353. }
354. if (t < backfillNextAt) { return null }
355. let id = backfillQueue[backfillPos]
356. backfillPos = backfillPos + 1
357. let r = backfillTitle(id)
358. if (r.retry && (backfillTries[id] == null || backfillTries[id] < 2)) {
359. backfillTries[id] = backfillTries[id] == null ? 1 : backfillTries[id] + 1
360. let q = backfillQueue
361. q.push(id)
362. backfillQueue = q
363. backfillTotals.retries = backfillTotals.retries + 1
364. } else {
365. backfillTotals.titles = backfillTotals.titles + 1
366. if (r.adult == true) { backfillTotals.adult = backfillTotals.adult + 1 } else if (r.adult == false) { backfillTotals.notAdult = backfillTotals.notAdult + 1 } else { backfillTotals.unknown = backfillTotals.unknown + 1 }
367. }
368. backfillTotals.posters = backfillTotals.posters + r.posters
369. backfillTotals.ids = backfillTotals.ids + r.ids
370. backfillTotals.requests = backfillTotals.requests + r.requests
371. backfillTotals.errors = backfillTotals.errors + r.errors
372. if (r.error != '') { console.log('adult backfill: ' + r.error) }
373. if (r.adult != null) {
374. refreshCatalogShow(id)
375. searchTitleChanged(id)
376. }
377. let took = now() - t
378. if (took > 1500) { console.log('adult backfill: slow step, show ' + id + ', ' + took + ' ms') }
379. backfillNextAt = now() + r.requests * msPerRequest
380. let finished = backfillPos >= backfillQueue.length
381. if (finished || backfillPos % 25 == 0) { persistSync() }
382. if (!finished && backfillTotals.titles > 0 && backfillTotals.titles % backfillLogEvery == 0 && !r.retry) { console.log('adult backfill: ' + backfillLine()) }
383. if (finished) {
384. backfillDone = true
385. console.log('adult backfill done: ' + backfillLine())
386. }
387. return null
388. }
390. // ---- THE KIND BACKFILL (tracker.worldapi.org#21, mission 068, tmdbsync.hl kindTitle) ----------------------------------
391. // Every TV title without a stored kind gets one: a title with a show genre (Reality / Talk / News) from the stored data (no
392. // request), any other from TMDB's TV type (ONE request: GET /tv/<id>, then 260 ms pause). Starts once the adult backfill is
393. // done (or off), waits while the daily sync runs, ONE title per step on the same clock. A title that becomes a SHOW moves from
394. // /series to /shows at once (catalog.hl refreshCatalogShow). RESUMES after a restart (the queue = every TV title still without
395. // a kind); a 404 stores the genres' answer + `kindCheck`; a passing failure goes to the back of the queue, at most 2 more tries
396. // per start. Log: start, every TRACKER_KINDS_LOG_EVERY (500) titles, done. TRACKER_KINDS=0 switches it off; without
397. // TMDB_READ_TOKEN it is off too (the lists still split by genre: shows.hl titleKind).
398. kindsOn = env('TRACKER_KINDS') != '0' && syncEnabled
399. kindsLogEvery = env('TRACKER_KINDS_LOG_EVERY') != null ? toNumber(env('TRACKER_KINDS_LOG_EVERY')) : 500
400. kindQueue = null
401. kindPos = 0
402. kindDone = false
403. kindAt = 0
404. kindNextAt = 0
405. kindTries = {}
406. kindTotals = { titles = 0 series = 0 shows = 0 fromGenre = 0 moved = 0 requests = 0 errors = 0 retries = 0 }
407. kindLine = () => {
408. let k = kindTotals
409. return k.titles + '/' + kindQueue.length + ' titles, series=' + k.series + ' shows=' + k.shows + ' fromGenre=' + k.fromGenre + ' moved=' + k.moved
410. + ' requests=' + k.requests + ' errors=' + k.errors + ' retries=' + k.retries + ' seconds=' + ((now() - kindAt) / 1000)
411. }
412. kindTick = () => {
413. if (kindDone) { return null }
414. let t = now()
415. if (kindQueue == null) {
416. kindQueue = kindBackfillQueue()
417. kindAt = t
418. console.log('kind backfill: start, ' + kindQueue.length + ' TV titles without a kind (' + (now() - t) + ' ms to find them)')
419. if (kindQueue.length == 0) { kindDone = true console.log('kind backfill: nothing to do') }
420. return null
421. }
422. if (t < kindNextAt) { return null }
423. let id = kindQueue[kindPos]
424. kindPos = kindPos + 1
425. let r = kindTitle(id)
426. if (r.retry && (kindTries[id] == null || kindTries[id] < 2)) {
427. kindTries[id] = kindTries[id] == null ? 1 : kindTries[id] + 1
428. let q = kindQueue
429. q.push(id)
430. kindQueue = q
431. kindTotals.retries = kindTotals.retries + 1
432. } else {
433. kindTotals.titles = kindTotals.titles + 1
434. if (r.kind == 'show') { kindTotals.shows = kindTotals.shows + 1 } else if (r.kind == 'series') { kindTotals.series = kindTotals.series + 1 }
435. if (r.fromGenre) { kindTotals.fromGenre = kindTotals.fromGenre + 1 }
436. }
437. kindTotals.requests = kindTotals.requests + r.requests
438. kindTotals.errors = kindTotals.errors + r.errors
439. if (r.error != '') { console.log('kind backfill: ' + r.error) }
440. // until now the genres decided (no show genre = series): only a title TMDB's type makes a SHOW changes its list
441. if (r.kind == 'show' && !r.fromGenre) {
442. refreshCatalogShow(id)
443. kindTotals.moved = kindTotals.moved + 1
444. }
445. let took = now() - t
446. if (took > 1500) { console.log('kind backfill: slow step, show ' + id + ', ' + took + ' ms') }
447. kindNextAt = now() + r.requests * msPerRequest
448. let finished = kindPos >= kindQueue.length
449. if (finished || kindPos % 25 == 0) { persistSync() }
450. if (!finished && kindTotals.titles > 0 && kindTotals.titles % kindsLogEvery == 0 && !r.retry) { console.log('kind backfill: ' + kindLine()) }
451. if (finished) {
452. kindDone = true
453. console.log('kind backfill done: ' + kindLine())
454. }
455. return null
456. }
458. // ONE clock for all three (a tick every 0.1 s): the daily sync's step once a second as before; the backfills' steps in between,
459. // only while no daily run is going on — the adult backfill first, then the kind backfill
460. clockOn = syncOn || backfillOn || kindsOn
461. clockTicks = 0
462. if (syncOn) { console.log('tmdb sync: daily at ' + syncHour + ':00 UTC') } else { console.log('tmdb sync: off (' + (syncEnabled ? 'TRACKER_SYNC=0' : 'no TMDB_READ_TOKEN') + ')') }
463. if (!backfillOn) { console.log('adult backfill: off (' + (syncEnabled ? 'TRACKER_BACKFILL=0' : 'no TMDB_READ_TOKEN') + ')') }
464. if (!kindsOn) { console.log('kind backfill: off (' + (syncEnabled ? 'TRACKER_KINDS=0' : 'no TMDB_READ_TOKEN') + ')') }
465. if (clockOn) {
466. syncClock = every(0.1)
467. on syncClock.tick(x) {
468. clockTicks = clockTicks + 1
469. let busy = syncQueue.length > 0
470. if (syncOn && clockTicks % 10 == 0) { syncTick() }
471. if (backfillOn && !busy && syncQueue.length == 0) { backfillTick() }
472. if (kindsOn && !busy && syncQueue.length == 0 && (!backfillOn || backfillDone)) { kindTick() }
473. return null
474. }
475. }
477. // ---- THE SHORT-ID BACKFILL (mission 060, tracker.worldapi.org#27, shortids.hl shortIdStep) ----------------------------
478. // Every show and person without a short id gets one in the background: on its own clock (every 0.1 s) ONE batch per tick,
479. // as many records as fit into TRACKER_SHORTID_BUDGET_MS (default 40 ms) — no TMDB, only the tables — so a page waits at
480. // most one batch. The queue is built at start (`ensureShortIds`) from what is still missing = it resumes after a restart.
481. // Persisted every 20 batches and at the end. Log: start, every TRACKER_SHORTID_LOG_EVERY (5000) records, done; with nothing
482. // to do one line. TRACKER_SHORTIDS=0 switches it off (the gate's resume check).
483. shortIdOn = env('TRACKER_SHORTIDS') != '0'
484. shortIdBudget = env('TRACKER_SHORTID_BUDGET_MS') != null ? toNumber(env('TRACKER_SHORTID_BUDGET_MS')) : 40
485. shortIdLogEvery = env('TRACKER_SHORTID_LOG_EVERY') != null ? toNumber(env('TRACKER_SHORTID_LOG_EVERY')) : 5000
486. shortIdRun = { at = 0 batches = 0 assigned = 0 nextLog = 0 slowest = 0 slowestPersist = 0 done = false }
487. shortIdTick = () => {
488. if (shortIdRun.done) { return null }
489. let t = now()
490. let r = shortIdStep(shortIdBudget)
491. let took = now() - t
492. shortIdRun.batches = shortIdRun.batches + 1
493. shortIdRun.assigned = shortIdRun.assigned + r.assigned
494. if (took > shortIdRun.slowest) { shortIdRun.slowest = took }
495. if (r.done || shortIdRun.batches % 20 == 0) {
496. let tp = now()
497. persistShortIds()
498. if (now() - tp > shortIdRun.slowestPersist) { shortIdRun.slowestPersist = now() - tp }
499. }
500. if (!r.done && shortIdRun.assigned >= shortIdRun.nextLog) {
501. console.log('short ids: ' + shortIdRun.assigned + ' assigned, ' + r.left + ' left, ' + ((now() - shortIdRun.at) / 1000) + ' s')
502. shortIdRun.nextLog = shortIdRun.nextLog + shortIdLogEvery
503. }
504. if (r.done) {
505. shortIdRun.done = true
506. let s = shortIdStats()
507. console.log('short ids done: assigned=' + shortIdRun.assigned + ' oldKept=' + s.oldKept + ' batches=' + shortIdRun.batches + ' slowestBatchMs=' + shortIdRun.slowest + ' slowestPersistMs=' + shortIdRun.slowestPersist + ' seconds=' + ((now() - shortIdRun.at) / 1000))
508. }
509. return null
510. }
511. if (!shortIdOn) { console.log('short ids: backfill off (TRACKER_SHORTIDS=0), ' + shortIdsLeft() + ' records without one') }
512. else if (shortIdsLeft() == 0) { console.log('short ids: nothing to do') }
513. else {
514. shortIdRun.at = now()
515. shortIdRun.nextLog = shortIdLogEvery
516. console.log('short ids: backfill start, ' + shortIdsLeft() + ' records, ' + shortIdBudget + ' ms per batch')
517. shortIdClock = every(0.1)
518. on shortIdClock.tick(x) {
519. shortIdTick()
520. return null
521. }
522. }
524. on Error(e) { console.log('error absorbed: ' + e.message) }