holo-evicted-publish: player +6 object(s)

b/677b4ff637d9ccf19033203c850a0b0303c2c2356f775ce1a11eb3bef575bd32

@@ -0,0 +1,101 @@
+// holo-tmdb.mjs — the metadata provider: TMDb → the ONE Holo Player item shape, κ-cached.
+//
+// This is Jellyfin's built-in metadata providers + Jellyseerr's discovery, done once and content-addressed.
+// It auto-populates Holo Player with every popular movie + series (titles, posters, backdrops, overviews,
+// genres, cast, ratings, trailers, and "where to watch") — and because every response goes THROUGH
+// holo-media-cache (a κ-object keyed by the request), a warm open is memory-speed and works offline.
+//
+// Dependency-injected (fetch + cache) so Node witnesses it with a fake TMDb and a Map cache — no network,
+// no key. The browser binding (window.HoloTmdb) wires real fetch + the persistent κ-cache.
+
+import { normalizeMovie, normalizeSeries, normalizeEpisode, normalizeWatchProviders, normalizeAny } from "./holo-media-item.mjs";
+
+const API = "https://api.themoviedb.org/3";
+
+// createTmdb({ apiKey, fetch, cache, region, lang }) — fetch/cache injectable. apiKey: v3 key (query) or v4
+// bearer token (auto-detected by the dot in a JWT). cache: a holo-media-cache instance (or null = no cache).
+export function createTmdb({ apiKey = "", fetch: f, cache = null, region = "US", lang = "en-US" } = {}) {
+  const doFetch = f || (typeof fetch !== "undefined" ? fetch.bind(globalThis) : null);
+  if (!doFetch) throw new Error("holo-tmdb: a fetch implementation is required");
+  const bearer = apiKey.includes("."); // v4 tokens are JWTs
+
+  function url(path, params = {}) {
+    const u = new URL(API + path);
+    u.searchParams.set("language", lang);
+    if (!bearer && apiKey) u.searchParams.set("api_key", apiKey);
+    for (const [k, v] of Object.entries(params)) if (v != null) u.searchParams.set(k, String(v));
+    return u.toString();
+  }
+  async function raw(path, params) {
+    const res = await doFetch(url(path, params), bearer ? { headers: { Authorization: "Bearer " + apiKey } } : undefined);
+    if (!res.ok) throw new Error("tmdb " + res.status + " " + path);
+    return res.json();
+  }
+  // every network call goes through the κ-cache: same request → same κ → O(1) warm/offline read.
+  // bucket:"day" stamps the key with today — discovery rails self-refresh daily instead of freezing at
+  // their first-ever fetch (title/season records are stable, so they stay permanent).
+  async function api(path, params = {}, { bucket = null } = {}) {
+    const key = path + "?" + new URLSearchParams(params).toString() + "|" + lang + "|" + region + (bucket === "day" ? "|d:" + new Date().toISOString().slice(0, 10) : "");
+    if (!cache) return raw(path, params);
+    const { body } = await cache.through(key, () => raw(path, params));
+    return body;
+  }
+
+  const list = (payload, opts) => (payload && payload.results ? payload.results : []).map((t) => normalizeAny(t, opts)).filter((x) => x.posterUrl || x.backdrop);
+
+  return {
+    // ── discovery rails ──────────────────────────────────────────────────────────────────────────────
+    async trending(window = "week") { return list(await api(`/trending/all/${window}`, {}, { bucket: "day" })); },
+    async popularMovies(page = 1) { return (await api("/movie/popular", { page }, { bucket: "day" })).results.map((t) => normalizeMovie(t)); },
+    async popularSeries(page = 1) { return (await api("/tv/popular", { page }, { bucket: "day" })).results.map((t) => normalizeSeries(t)); },
+    async topRatedMovies(page = 1) { return (await api("/movie/top_rated", { page }, { bucket: "day" })).results.map((t) => normalizeMovie(t)); },
+    async byGenre(genreId, kind = "movie", page = 1) {
+      const p = await api(kind === "tv" ? "/discover/tv" : "/discover/movie", { with_genres: genreId, sort_by: "popularity.desc", page });
+      return p.results.map((t) => (kind === "tv" ? normalizeSeries(t) : normalizeMovie(t)));
+    },
+    async search(q, page = 1) { return list(await api("/search/multi", { query: q, page, include_adult: false })); },
+
+    // ── one title, enriched (videos → trailer, credits → cast, watch/providers → "where to watch") ─────
+    async title(id, kind = "movie") {
+      const tv = kind === "tv";
+      // pull EVERYTHING in one call: trailer, full cast+crew, logo art, keywords, certification, recommendations,
+      // similar, imdb id. include_image_language gets the English title-logo PNG. The κ-cache makes repeats free.
+      const append = tv
+        ? "videos,credits,images,keywords,recommendations,similar,external_ids,content_ratings,watch/providers"
+        : "videos,credits,images,keywords,release_dates,recommendations,similar,external_ids,watch/providers";
+      const t = await api(`/${tv ? "tv" : "movie"}/${id}`, { append_to_response: append, include_image_language: "en,null" });
+      t.providers = normalizeWatchProviders(t["watch/providers"], region);   // normalizers extract the rest
+      return tv ? normalizeSeries(t, { region }) : normalizeMovie(t, { region });
+    },
+    // ── a season's episodes (the Series → Season → Episode browser) ────────────────────────────────────
+    async season(seriesId, seasonNumber, series) {
+      const s = await api(`/tv/${seriesId}/season/${seasonNumber}`);
+      const ctx = series || { tmdbId: seriesId, name: "", topics: [], genres: [], backdrop: null, posterUrl: null, quality: 0.7 };
+      return (s.episodes || []).map((ep) => normalizeEpisode(ep, ctx));
+    },
+    async watchProviders(id, kind = "movie") { return normalizeWatchProviders(await api(`/${kind === "tv" ? "tv" : "movie"}/${id}/watch/providers`), region); },
+  };
+}
+
+// Built-in community key — the metadata plane works ZERO-SETUP for every visitor (a TMDb v3 read key is
+// designed to ship client-side). A user key in Settings still overrides it. Every response is κ-cached,
+// so most opens never re-touch the network anyway.
+const BUILTIN_KEY = "45f791c5f6a6940a50403bb3890c7b86";
+
+// browser binding — real fetch + the persistent κ-cache + built-in key (localStorage key overrides).
+if (typeof window !== "undefined") {
+  window.HoloTmdb = {
+    createTmdb,
+    // live({ apiKey }) — the one the player calls. Key from arg, localStorage "holoplayer.tmdb.key", or built-in.
+    live(opts = {}) {
+      const apiKey = opts.apiKey || (() => { try { return localStorage.getItem("holoplayer.tmdb.key") || ""; } catch { return ""; } })() || BUILTIN_KEY;
+      const cache = window.HoloMediaCache ? window.HoloMediaCache.live() : null;
+      return createTmdb({ apiKey, cache, region: opts.region || "US", lang: opts.lang || "en-US" });
+    },
+    configured() { return true; },   // built-in key: always on
+    userKey() { try { return !!localStorage.getItem("holoplayer.tmdb.key"); } catch { return false; } },
+    setKey(k) { try { localStorage.setItem("holoplayer.tmdb.key", k || ""); } catch {} },
+  };
+}
+
+export default { createTmdb };

b/7ebd737e91193f4aa2412554ac6f366fbc35d53f5878b6ddf46dfa6645184fb5

@@ -0,0 +1,616 @@
+{
+ "$comment": "Seed catalog so Holo Player is ALREADY FULL on first open — no TMDb key, offline. Real popular titles with accurate TMDb ids + metadata (genres/year/rating/overview). Each carries a verified imdb_id so the normalizer fills real, beautiful poster/backdrop art KEY-FREE via the Stremio metahub CDN (the same source Cinemeta uses); a configured TMDb key still live-upgrades to TMDb's own art/trailers. Each item is TMDb-shaped (media_type=movie|tv, genre_ids) so holo-media-item normalizers consume it exactly like a live TMDb row.",
+ "generatedAt": "2026-07-11",
+ "items": [
+  {
+   "id": 1339713,
+   "media_type": "movie",
+   "title": "Obsession",
+   "imdb_id": "tt37287335",
+   "release_date": "2026-05-13",
+   "genre_ids": [
+    27,
+    53
+   ],
+   "vote_average": 8.3,
+   "runtime": 109,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "After breaking the mysterious \"One Wish Willow\" to win his crush's heart, a hopeless romantic finds himself getting exactly what he asked for but soon discovers that some desires come at a dark, sinister price."
+  },
+  {
+   "id": 1280738,
+   "media_type": "movie",
+   "title": "The Furious",
+   "imdb_id": "tt33311069",
+   "release_date": "2025-09-07",
+   "genre_ids": [
+    28,
+    80,
+    53
+   ],
+   "vote_average": 7.5,
+   "runtime": 113,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "After a criminal network kidnaps Wang Wei's daughter and the corrupt police refuse to assist him, Wei sets out on his own to locate her. Navin, a tenacious journalist whose wife has mysteriously vanished, is his only ally. In this explosive martial arts showdown, the unlikely duo fights the kidnappers ruthlessly driven by a furious vengeance."
+  },
+  {
+   "id": 125988,
+   "media_type": "tv",
+   "name": "Silo",
+   "imdb_id": "tt14688458",
+   "first_air_date": "2023-05-04",
+   "genre_ids": [
+    10765,
+    18
+   ],
+   "vote_average": 8.2,
+   "number_of_seasons": 3,
+   "number_of_episodes": 30,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "In a ruined and toxic future, thousands live in a giant silo deep underground. After its sheriff breaks a cardinal rule and residents die mysteriously, engineer Juliette starts to uncover shocking secrets and the truth about the silo."
+  },
+  {
+   "id": 1368314,
+   "media_type": "movie",
+   "title": "Passenger",
+   "imdb_id": "tt33763941",
+   "release_date": "2026-05-20",
+   "genre_ids": [
+    27,
+    53
+   ],
+   "vote_average": 6.7,
+   "runtime": 94,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "After a young couple witnesses a gruesome highway accident, they soon realize they did not leave the crash scene alone, as a demonic presence called the Passenger that won't stop until it claims them both turns their van life adventure into a nightmare."
+  },
+  {
+   "id": 1212763,
+   "media_type": "movie",
+   "title": "Evil Dead Burn",
+   "imdb_id": "tt31170389",
+   "release_date": "2026-07-07",
+   "genre_ids": [
+    27,
+    53
+   ],
+   "vote_average": 7.2,
+   "runtime": 109,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "After her husband's abrupt death, a woman seeks solace with her in-laws. As they transform into Deadites one by one, she comes to discover that the vows she took in life survive even in death."
+  },
+  {
+   "id": 94997,
+   "media_type": "tv",
+   "name": "House of the Dragon",
+   "imdb_id": "tt11198330",
+   "first_air_date": "2022-08-21",
+   "genre_ids": [
+    10765,
+    18,
+    10759
+   ],
+   "vote_average": 8.4,
+   "number_of_seasons": 3,
+   "number_of_episodes": 26,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "The Targaryen dynasty is at the absolute apex of its power, with more than 15 dragons under their yoke. Most empires crumble from such heights. In the case of the Targaryens, their slow fall begins when King Viserys breaks with a century of tradition by naming his daughter Rhaenyra heir to the Iron Throne. But when Viserys later fathers a son, the court is shocked when Rhaenyra retains her status "
+  },
+  {
+   "id": 1084244,
+   "media_type": "movie",
+   "title": "Toy Story 5",
+   "imdb_id": "tt29355505",
+   "release_date": "2026-06-17",
+   "genre_ids": [
+    16,
+    10751,
+    35,
+    12
+   ],
+   "vote_average": 7.4,
+   "runtime": 102,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "When Bonnie receives a Lilypad tablet as a gift and becomes obsessed, Buzz, Woody, Jessie and the rest of the gang's jobs become exponentially harder when they have to go head to head with the all-new threat to playtime."
+  },
+  {
+   "id": 1083381,
+   "media_type": "movie",
+   "title": "Backrooms",
+   "imdb_id": "tt26657236",
+   "release_date": "2026-05-27",
+   "genre_ids": [
+    27,
+    9648,
+    878
+   ],
+   "vote_average": 6.8,
+   "runtime": 111,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "A strange doorway appears in the basement of a furniture showroom."
+  },
+  {
+   "id": 1202033,
+   "media_type": "movie",
+   "title": "Enola Holmes 3",
+   "imdb_id": "tt32278481",
+   "release_date": "2026-06-30",
+   "genre_ids": [
+    12,
+    80,
+    9648
+   ],
+   "vote_average": 7,
+   "runtime": 109,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Adventure follows detective Enola Holmes to Malta, where her plans to tie the knot unravel when Sherlock's disappearance plunges her into a perilous case."
+  },
+  {
+   "id": 94664,
+   "media_type": "tv",
+   "name": "Mushoku Tensei: Jobless Reincarnation",
+   "imdb_id": "tt13293588",
+   "first_air_date": "2021-01-11",
+   "genre_ids": [
+    10759,
+    16,
+    10765
+   ],
+   "vote_average": 8.5,
+   "number_of_seasons": 3,
+   "number_of_episodes": 61,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "When a 34-year-old underachiever gets run over by a truck, his story doesn't end there. Reincarnated in a new world as an infant, Rudy will seize every opportunity to live the life he's always wanted. Armed with new friends, some freshly acquired magical abilities, and the courage to do the things he's always dreamed of, he's embarking on an epic adventure—with all of his past experience intact!"
+  },
+  {
+   "id": 37854,
+   "media_type": "tv",
+   "name": "One Piece",
+   "imdb_id": "tt0388629",
+   "first_air_date": "1999-10-20",
+   "genre_ids": [
+    10759,
+    35,
+    16
+   ],
+   "vote_average": 8.7,
+   "number_of_seasons": 23,
+   "number_of_episodes": 1169,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Years ago, the fearsome Pirate King, Gol D. Roger was executed leaving a huge pile of treasure and the famous \"One Piece\" behind. Whoever claims the \"One Piece\" will be named the new King of the Pirates.\n\nMonkey D. Luffy, a boy who consumed a \"Devil Fruit,\" decides to follow in the footsteps of his idol, the pirate Shanks, and find the One Piece. It helps, of course, that his body has the properti"
+  },
+  {
+   "id": 106449,
+   "media_type": "tv",
+   "name": "A Record of a Mortal's Journey to Immortality",
+   "imdb_id": "tt12879782",
+   "first_air_date": "2020-07-25",
+   "genre_ids": [
+    16,
+    10759,
+    10765
+   ],
+   "vote_average": 8.4,
+   "number_of_seasons": 1,
+   "number_of_episodes": 190,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "A poor and ordinary boy from a village joins a minor sect in Jiang Hu and becomes an Unofficial Disciple by chance. How will Han Li, a commoner by birth, establish a foothold for himself in his sect? With his mediocre aptitude, he must successfully traverse the treacherous path of cultivation and avoid the notice of those who may do him harm. This is a story of an ordinary mortal who, against all "
+  },
+  {
+   "id": 1315772,
+   "media_type": "movie",
+   "title": "Minions & Monsters",
+   "imdb_id": "tt32890033",
+   "release_date": "2026-06-24",
+   "genre_ids": [
+    12,
+    16,
+    35,
+    10751,
+    14
+   ],
+   "vote_average": 6.4,
+   "runtime": 90,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "This is the rambunctious, ridiculous and totally true story of how the Minions conquered Hollywood, became movie stars, lost everything, unleashed monsters onto the world and then banded together to try and save the planet from the mayhem they had just created."
+  },
+  {
+   "id": 296206,
+   "media_type": "tv",
+   "name": "Agent Kim Reactivated",
+   "imdb_id": "tt42127457",
+   "first_air_date": "2026-06-26",
+   "genre_ids": [
+    10759,
+    80,
+    18
+   ],
+   "vote_average": 7.4,
+   "number_of_seasons": 1,
+   "number_of_episodes": 10,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "When an unassuming dad's daughter goes missing, he dusts off his old black-ops skills to track her down — only to attract the wrong kind of attention."
+  },
+  {
+   "id": 687163,
+   "media_type": "movie",
+   "title": "Project Hail Mary",
+   "imdb_id": "tt12042730",
+   "release_date": "2026-03-15",
+   "genre_ids": [
+    878,
+    12
+   ],
+   "vote_average": 8.7,
+   "runtime": 157,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Science teacher Ryland Grace wakes up on a spaceship light years from home with no recollection of who he is or how he got there. As his memory returns, he begins to uncover his mission: solve the riddle of the mysterious substance causing the sun to die out. He must call on his scientific knowledge and unorthodox ideas to save everything on Earth from extinction."
+  },
+  {
+   "id": 936075,
+   "media_type": "movie",
+   "title": "Michael",
+   "imdb_id": "tt11378946",
+   "release_date": "2026-04-22",
+   "genre_ids": [
+    10402,
+    18
+   ],
+   "vote_average": 8.7,
+   "runtime": 128,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "The story of Michael Jackson, one of the most influential artists the world has ever known, and his life beyond the music. His journey from the discovery of his extraordinary talent as the lead of the Jackson Five, to the visionary artist whose creative ambition fueled a relentless pursuit to become the biggest entertainer in the world, highlighting both his life off-stage and some of the most ico"
+  },
+  {
+   "id": 1275779,
+   "media_type": "movie",
+   "title": "Disclosure Day",
+   "imdb_id": "tt15047880",
+   "release_date": "2026-06-10",
+   "genre_ids": [
+    878,
+    53
+   ],
+   "vote_average": 6.7,
+   "runtime": 146,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "A cybersecurity expert becomes a whistleblower after uncovering secrets about aliens, putting him on the run from a corporation. Meanwhile, a meteorologist experiencing strange phenomena joins forces with him to prove there's life beyond our understanding."
+  },
+  {
+   "id": 1314481,
+   "media_type": "movie",
+   "title": "The Devil Wears Prada 2",
+   "imdb_id": "tt33612209",
+   "release_date": "2026-04-29",
+   "genre_ids": [
+    35,
+    18
+   ],
+   "vote_average": 7.1,
+   "runtime": 119,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Andy Sachs returns to Runway as Miranda Priestly navigates a new media landscape and Runway's position within. The duo reconnect with former assistant Emily Charlton, now the head of a luxury brand that possesses funding which could ensure Runway's survival."
+  },
+  {
+   "id": 1413976,
+   "media_type": "movie",
+   "title": "Citizen Vigilante",
+   "imdb_id": "tt35309713",
+   "release_date": "2026-06-19",
+   "genre_ids": [
+    53,
+    28,
+    80
+   ],
+   "vote_average": 6.5,
+   "runtime": 89,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "A man takes justice into his own hands, hunting down criminals. His vigilante crusade makes him a social media star but puts him at odds with the local police chief."
+  },
+  {
+   "id": 1523145,
+   "media_type": "movie",
+   "title": "Your Heart Will Be Broken",
+   "imdb_id": "tt38190257",
+   "release_date": "2026-03-26",
+   "genre_ids": [
+    10749
+   ],
+   "vote_average": 7.1,
+   "runtime": 134,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "High school student Polina is saved from bullying at her new school and makes a deal with the main bully Bars: he must pretend to be her boyfriend and protect her, and she must do everything he says. During this game, the couple develops real feelings, but her family and classmates have reasons to separate the lovers."
+  },
+  {
+   "id": 1127384,
+   "media_type": "movie",
+   "title": "Deep Water",
+   "imdb_id": "tt29516222",
+   "release_date": "2026-04-30",
+   "genre_ids": [
+    27,
+    53
+   ],
+   "vote_average": 7.3,
+   "runtime": 107,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "A group of international passengers on a flight from Los Angeles to Shanghai is forced to make an emergency landing in shark-infested waters. The terrified group is forced to work together and overcome their differences if they hope to escape their sinking plane and the frenzy of sharks drawn to the wreckage."
+  },
+  {
+   "id": 278,
+   "media_type": "movie",
+   "title": "The Shawshank Redemption",
+   "imdb_id": "tt0111161",
+   "release_date": "1994-09-23",
+   "genre_ids": [
+    18,
+    80
+   ],
+   "vote_average": 8.7,
+   "runtime": 142,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Imprisoned in the 1940s for the double murder of his wife and her lover, upstanding banker Andy Dufresne begins a new life at the Shawshank prison, where he puts his accounting skills to work for an amoral warden. During his long stretch in prison, Dufresne comes to be admired by the other inmates -- including an older prisoner named Red -- for his integrity and unquenchable sense of hope."
+  },
+  {
+   "id": 1279493,
+   "media_type": "movie",
+   "title": "The Get Out",
+   "imdb_id": "tt32321803",
+   "release_date": "2026-06-18",
+   "genre_ids": [
+    28,
+    53
+   ],
+   "vote_average": 6.4,
+   "runtime": 111,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "A nightclub owner is on the verge of leaving his dangerous past behind for retirement with his girlfriend. When masked gunmen rob him and he finds himself squeezed by ruthless cartels, a mysterious newcomer arrives with an interest in buying the business. With danger closing in from all sides, he must navigate a deadly web of deception, power, and survival  -  where escape may no longer be an opti"
+  },
+  {
+   "id": 931285,
+   "media_type": "movie",
+   "title": "Mortal Kombat II",
+   "imdb_id": "tt17490712",
+   "release_date": "2026-05-06",
+   "genre_ids": [
+    28,
+    14,
+    12
+   ],
+   "vote_average": 8,
+   "runtime": 116,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "The fan favorite champions—now joined by Johnny Cage himself—are pitted against one another in the ultimate, no-holds barred, gory battle to defeat the dark rule of Shao Kahn that threatens the very existence of the Earthrealm and its defenders."
+  },
+  {
+   "id": 11012,
+   "media_type": "movie",
+   "title": "Damage",
+   "imdb_id": "tt0104237",
+   "release_date": "1992-12-02",
+   "genre_ids": [
+    18,
+    10749
+   ],
+   "vote_average": 6.6,
+   "runtime": 111,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "The life of a respected British politician at the height of his career crumbles when he becomes obsessed with his son's lover."
+  },
+  {
+   "id": 243206,
+   "media_type": "tv",
+   "name": "Pritam and Pedro",
+   "imdb_id": "tt28077038",
+   "first_air_date": "2026-07-03",
+   "genre_ids": [
+    80,
+    18,
+    9648,
+    35
+   ],
+   "vote_average": 8.5,
+   "number_of_seasons": 1,
+   "number_of_episodes": 6,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "The dynamic between the two contrasting personalities, a seasoned cop who prefers old-school methods and a tech-savvy cop who relies on modern technology for investigations, as they navigate their partnership in solving crimes."
+  },
+  {
+   "id": 312949,
+   "media_type": "tv",
+   "name": "Chainsmoker Cat",
+   "imdb_id": "tt39551330",
+   "first_air_date": "2026-07-03",
+   "genre_ids": [
+    16,
+    35,
+    10765
+   ],
+   "vote_average": 8.9,
+   "number_of_seasons": 1,
+   "number_of_episodes": 12,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Catgirl Yani struggles to pay her rent and keep a job while feeding her smoking habit. As her loved ones' concerns grow, she must rethink her future."
+  },
+  {
+   "id": 124364,
+   "media_type": "tv",
+   "name": "FROM",
+   "imdb_id": "tt9813792",
+   "first_air_date": "2022-02-20",
+   "genre_ids": [
+    9648,
+    18,
+    10765
+   ],
+   "vote_average": 8.5,
+   "number_of_seasons": 4,
+   "number_of_episodes": 40,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Unravel the mystery of a nightmarish town in middle America that traps all those who enter. As the unwilling residents fight to keep a sense of normalcy and search for a way out, they must also survive the threats of the surrounding forest – including the terrifying creatures that come out when the sun goes down."
+  },
+  {
+   "id": 2734,
+   "media_type": "tv",
+   "name": "Law & Order: Special Victims Unit",
+   "imdb_id": "tt0203259",
+   "first_air_date": "1999-09-20",
+   "genre_ids": [
+    80,
+    18,
+    9648
+   ],
+   "vote_average": 8,
+   "number_of_seasons": 28,
+   "number_of_episodes": 595,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "In the criminal justice system, sexually-based offenses are considered especially heinous. In New York City, the dedicated detectives who investigate these vicious felonies are members of an elite squad known as the Special Victims Unit. These are their stories."
+  },
+  {
+   "id": 79744,
+   "media_type": "tv",
+   "name": "The Rookie",
+   "imdb_id": "tt7587890",
+   "first_air_date": "2018-10-16",
+   "genre_ids": [
+    80,
+    18,
+    35
+   ],
+   "vote_average": 8.5,
+   "number_of_seasons": 9,
+   "number_of_episodes": 144,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Starting over isn't easy, especially for small-town guy John Nolan who, after a life-altering incident, is pursuing his dream of being an LAPD officer. As the force's oldest rookie, he's met with skepticism from some higher-ups who see him as just a walking midlife crisis."
+  },
+  {
+   "id": 241002,
+   "media_type": "tv",
+   "name": "Adam's Sweet Agony",
+   "imdb_id": "tt30325611",
+   "first_air_date": "2024-01-08",
+   "genre_ids": [
+    16
+   ],
+   "vote_average": 6.9,
+   "number_of_seasons": 1,
+   "number_of_episodes": 8,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "This is the story of a boy, who became the lone Adam among four billion Eves. In a world where a pandemic has rendered all men impotent, high school student Itsuki is the exception who escaped it. In order to protect this secret, he transfers to a very special high school, which turns out to be composed of 90% girls! There, he encounters an upbeat and friendly senior, a sexually frustrated female "
+  },
+  {
+   "id": 5920,
+   "media_type": "tv",
+   "name": "The Mentalist",
+   "imdb_id": "tt1196946",
+   "first_air_date": "2008-09-23",
+   "genre_ids": [
+    80,
+    18,
+    9648
+   ],
+   "vote_average": 8.4,
+   "number_of_seasons": 7,
+   "number_of_episodes": 151,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Patrick Jane, a former celebrity psychic medium, uses his razor sharp skills of observation and expertise at \"reading\" people to solve serious crimes with the California Bureau of Investigation."
+  },
+  {
+   "id": 549,
+   "media_type": "tv",
+   "name": "Law & Order",
+   "imdb_id": "tt0098844",
+   "first_air_date": "1990-09-13",
+   "genre_ids": [
+    80,
+    18
+   ],
+   "vote_average": 7.3,
+   "number_of_seasons": 26,
+   "number_of_episodes": 545,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "In cases ripped from the headlines, police investigate serious and often deadly crimes, weighing the evidence and questioning the suspects until someone is taken into custody. The district attorney's office then builds a case to convict the perpetrator by proving the person guilty beyond a reasonable doubt. Working together, these expert teams navigate all sides of the complex criminal justice sys"
+  },
+  {
+   "id": 1622,
+   "media_type": "tv",
+   "name": "Supernatural",
+   "imdb_id": "tt0460681",
+   "first_air_date": "2005-09-13",
+   "genre_ids": [
+    18,
+    9648,
+    10765
+   ],
+   "vote_average": 8.3,
+   "number_of_seasons": 15,
+   "number_of_episodes": 327,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "When they were boys, Sam and Dean Winchester lost their mother to a mysterious and demonic supernatural force. Subsequently, their father raised them to be soldiers. He taught them about the paranormal evil that lives in the dark corners and on the back roads of America ... and he taught them how to kill it. Now, the Winchester brothers crisscross the country in their '67 Chevy Impala, battling ev"
+  },
+  {
+   "id": 1416,
+   "media_type": "tv",
+   "name": "Grey's Anatomy",
+   "imdb_id": "tt0413573",
+   "first_air_date": "2005-03-27",
+   "genre_ids": [
+    18
+   ],
+   "vote_average": 8.2,
+   "number_of_seasons": 22,
+   "number_of_episodes": 465,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Follows the personal and professional lives of a group of doctors at Seattle's Grey Sloan Memorial Hospital."
+  },
+  {
+   "id": 4304,
+   "media_type": "tv",
+   "name": "Xplay",
+   "imdb_id": "tt0361258",
+   "first_air_date": "2003-04-28",
+   "genre_ids": [],
+   "vote_average": 8.5,
+   "number_of_seasons": 10,
+   "number_of_episodes": 644,
+   "poster_path": null,
+   "backdrop_path": null,
+   "overview": "Xplay (previously GameSpot TV and Extended Play) is a TV program about video games. The program, known for its reviews and comedy skits, airs on G4 in the United States and had aired on G4 Canada in Canada (and briefly on YTV during its time as GameSpot TV), FUEL TV in Australia, Ego in Israel, GXT in Italy, MTV Russia & Rambler TV in Russia, Solar Sports in the Philippines and Adult Swim and Much"
+  }
+ ]
+}

b/8eb4171fc2472a04e7b6ec270350035618ea8e1c8e617b2d1ca98ff0ef92667e

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+// holo-tvdb-witness.mjs — proves the TVDB v4 provider gives the player series-depth TMDb can't, with a
+// fake TVDB (no network, no key) and a Map κ-cache. Same laws as the TMDb witness: κ-cached (fast +
+// offline), verify-before-trust, plus the two TVDB-specific mechanisms — the bearer-token lifecycle and
+// the DAY BUCKET (airing answers refresh daily; the IMDb→TVDB id bridge caches forever).
+//
+// Checks:
+//   1 tokenOnce         — first call logs in once; later calls reuse the stored token (no re-login).
+//   2 tokenRefresh      — a 401 mid-flight re-logins ONCE and retries (expired token heals itself).
+//   3 remoteBridge      — an IMDb id resolves to the TVDB series id (the identity bridge).
+//   4 airingNext        — airingOf(series item) answers status + nextAired + the next episode.
+//   5 episodesNormalized— seasonEpisodes returns the player's ONE episode shape (numbers, art, dates).
+//   6 kappaCacheHit     — a repeated request serves from κ (0 extra fetches).
+//   7 worksOffline      — with a warm cache, a request whose network is DOWN still serves from κ.
+//   8 dayBucket         — the same airing question tomorrow re-fetches (fresh), but the id bridge does NOT.
+//
+// node holo-tvdb-witness.mjs   (from holo-apps/apps/player/)
+
+import { writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { createTvdb } from "./holo-tvdb.mjs";
+import { createMediaCache, memKV } from "./holo-media-cache.mjs";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const checks = {}; const fail = [];
+const ok = (n, c, d = "") => { checks[n] = !!c; if (!c) fail.push(n + (d ? ` — ${d}` : "")); return !!c; };
+
+// ── fake TVDB (counts calls; routes by path) ─────────────────────────────────────────────────────────────
+const b64 = (o) => Buffer.from(JSON.stringify(o)).toString("base64");
+const JWT = (expSec) => `x.${b64({ exp: expSec })}.y`;
+const SERIES = {
+  id: 366972, name: "Foundation", status: { name: "Continuing" }, nextAired: "2026-07-14", lastAired: "2026-07-07",
+  episodes: [
+    { id: 1, name: "The Emperor's Peace", aired: "2021-09-24", runtime: 69, number: 1, seasonNumber: 1, overview: "Gaal arrives.", image: "/banners/ep1.jpg" },
+    { id: 2, name: "Preparing to Live", aired: "2021-09-24", runtime: 59, number: 2, seasonNumber: 1, overview: "", image: null },
+    { id: 3, name: "The Next One", aired: "2026-07-14", runtime: 55, number: 1, seasonNumber: 4, overview: "", image: null },
+    { id: 9, name: "Special", aired: "2021-01-01", runtime: 10, number: 1, seasonNumber: 0, overview: "", image: null },
+  ],
+};
+let logins = 0, calls = 0, netDown = false, expireNext = false;
+const fakeFetch = async (url, opts = {}) => {
+  const path = new URL(url).pathname;
+  if (path === "/v4/login") { logins++; return { ok: true, status: 200, json: async () => ({ status: "success", data: { token: JWT(Math.floor(Date.now() / 1000) + 30 * 86400) } }) }; }
+  if (netDown) throw new Error("network down");
+  calls++;
+  if (expireNext) { expireNext = false; return { ok: false, status: 401, json: async () => ({ message: "Unauthorized" }) }; }
+  if (path.startsWith("/v4/search/remoteid/")) return { ok: true, status: 200, json: async () => ({ data: [{ series: { id: 366972, name: "Foundation" } }] }) };
+  if (path.startsWith("/v4/series/366972/extended")) return { ok: true, status: 200, json: async () => ({ data: SERIES }) };
+  return { ok: false, status: 404, json: async () => ({}) };
+};
+
+let NOW = Date.parse("2026-07-11T12:00:00Z");
+const cache = createMediaCache({ kv: memKV() });
+const tvdb = createTvdb({ apikey: "witness-key", fetch: fakeFetch, cache, now: () => NOW });
+
+// 1 tokenOnce — two calls, one login.
+const idA = await tvdb.seriesIdByRemote("tt0804484");
+await tvdb.series(366972);
+ok("tokenOnce", logins === 1, `logins=${logins}`);
+
+// 2 tokenRefresh — next raw call answers 401 once → exactly one extra login, request still succeeds.
+expireNext = true;
+const s2 = await tvdb.series(366973).catch(() => null);   // uncached path (different id → 404 after retry is fine)
+ok("tokenRefresh", logins === 2, `logins=${logins}`);
+
+// 3 remoteBridge
+ok("remoteBridge", idA === 366972, String(idA));
+
+// 4 airingNext — via a player-shaped item (imdbId bridge), status + nextAired + next episode.
+const a = await tvdb.airingOf({ kind: "series", imdbId: "tt0804484", name: "Foundation" });
+ok("airingNext", !!a && a.status === "Continuing" && a.nextAired === "2026-07-14" && a.nextEpisode && a.nextEpisode.seasonNumber === 4, JSON.stringify(a));
+
+// 5 episodesNormalized — ONE shape: ids, numbers, seconds, art host, air date; season 0 specials excluded.
+const eps = await tvdb.seasonEpisodes({ kind: "series", imdbId: "tt0804484", name: "Foundation" }, 1);
+ok("episodesNormalized",
+  eps.length === 2 && eps[0].kind === "episode" && eps[0].episodeNumber === 1 && eps[0].seasonNumber === 1 &&
+  eps[0].runtimeSec === 69 * 60 && eps[0].releaseDate === "2021-09-24" && /artworks\.thetvdb\.com/.test(eps[0].posterUrl || "") &&
+  eps[0].source === "tvdb" && eps[0].availability && eps[0].availability.playable === false,
+  JSON.stringify(eps[0] || null));
+
+// 6 kappaCacheHit — repeat the same series read: no new network calls.
+const before = calls; await tvdb.series(366972);
+ok("kappaCacheHit", calls === before, `calls ${before}→${calls}`);
+
+// 7 worksOffline — network gone, warm κ still answers.
+netDown = true;
+const off = await tvdb.series(366972).catch(() => null);
+ok("worksOffline", !!off && off.name === "Foundation", off ? off.name : "null");
+netDown = false;
+
+// 8 dayBucket — tomorrow the airing answer re-fetches (fresh), the id bridge does NOT (permanent).
+NOW += 864e5;
+const c0 = calls; await tvdb.series(366972); const afterSeries = calls;
+await tvdb.seriesIdByRemote("tt0804484"); const afterBridge = calls;
+ok("dayBucket", afterSeries === c0 + 1 && afterBridge === afterSeries, `series +${afterSeries - c0}, bridge +${afterBridge - afterSeries}`);
+
+// ── verdict ──────────────────────────────────────────────────────────────────────────────────────────────
+const pass = fail.length === 0;
+console.log("\nholo-tvdb witness — series depth (air dates, status, next episode), κ-cached + offline\n");
+for (const [n, c] of Object.entries(checks)) console.log(`  ${c ? "✓" : "✗"}  ${n}`);
+console.log(pass ? "\n  WITNESSED ✓  the next episode is known, served from κ — fast + offline + self-refreshing daily\n" : `\n  FAILED: ${fail.join("; ")}\n`);
+writeFileSync(join(here, "holo-tvdb-witness.result.json"), JSON.stringify({ when: new Date().toISOString(), pass, checks, fail }, null, 2));
+process.exit(pass ? 0 : 1);

b/92b8ede1aa37a9b5b0b92bbd2b0f740691dbd920440e661ea8c1605a2e88a4ad

@@ -0,0 +1,15 @@
+{
+  "when": "2026-07-11T07:30:15.171Z",
+  "pass": true,
+  "checks": {
+    "tokenOnce": true,
+    "tokenRefresh": true,
+    "remoteBridge": true,
+    "airingNext": true,
+    "episodesNormalized": true,
+    "kappaCacheHit": true,
+    "worksOffline": true,
+    "dayBucket": true
+  },
+  "fail": []
+}

b/e9d10ec2b90cc4f62e0acc03288efac3e53040d4bc17f0d71432b284fb8613ed

@@ -0,0 +1,141 @@
+// holo-tvdb.mjs — TheTVDB v4 provider: the series depth TMDb can't give — episode air dates, series
+// status (Continuing/Ended), and THE NEXT EPISODE. Same discipline as holo-tmdb: dependency-injected
+// (fetch + cache + clock) so Node witnesses it with a fake TVDB — no network, no key; every response
+// goes through holo-media-cache (a κ-object keyed by the request) so a warm open is memory-speed and
+// works offline. Time-variant answers (airing) carry a DAY BUCKET in the request key: fresh once a day,
+// O(1) for the rest of it. The identity bridge is /search/remoteid — the player's items carry IMDb/TMDb
+// ids, and that mapping is permanent, so it κ-caches forever.
+
+import { browseOnly } from "./holo-media-item.mjs";
+
+const API = "https://api4.thetvdb.com/v4";
+const ART = "https://artworks.thetvdb.com";
+const artURL = (p) => (!p ? null : /^https?:/.test(p) ? p : ART + (p.startsWith("/") ? "" : "/") + p);
+
+// createTvdb({ apikey, fetch, cache, now, tokenStore }) — fetch/cache/clock injectable.
+// tokenStore: { get()->{token,exp}|null, set(t) } (browser binding persists it in localStorage).
+export function createTvdb({ apikey = "", fetch: f, cache = null, now = () => Date.now(), tokenStore = null } = {}) {
+  const doFetch = f || (typeof fetch !== "undefined" ? fetch.bind(globalThis) : null);
+  if (!doFetch) throw new Error("holo-tvdb: a fetch implementation is required");
+  let mem = null;
+  const store = tokenStore || { get: () => mem, set: (t) => { mem = t; } };
+
+  // ── bearer token: login once, reuse until near expiry (TVDB JWTs live ~1 month) ────────────────────────
+  async function login() {
+    const res = await doFetch(API + "/login", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ apikey }) });
+    if (!res.ok) throw new Error("tvdb login " + res.status);
+    const j = await res.json();
+    const token = j && j.data && j.data.token;
+    if (!token) throw new Error("tvdb login: no token");
+    let exp = now() + 25 * 864e5;   // JWT exp claim wins; fallback 25 days
+    try { exp = Math.min(exp, JSON.parse(atob(token.split(".")[1])).exp * 1000); } catch {}
+    const t = { token, exp };
+    await store.set(t);
+    return t;
+  }
+  async function token(force = false) {
+    const t = !force && (await store.get());
+    if (t && t.token && t.exp - now() > 864e5) return t.token;   // >1 day left → reuse
+    return (await login()).token;
+  }
+  async function raw(path) {
+    let tk = await token();
+    let res = await doFetch(API + path, { headers: { Authorization: "Bearer " + tk } });
+    if (res.status === 401) { tk = await token(true); res = await doFetch(API + path, { headers: { Authorization: "Bearer " + tk } }); }
+    if (!res.ok) throw new Error("tvdb " + res.status + " " + path);
+    return (await res.json()).data;
+  }
+  // every call goes through the κ-cache; bucket:"day" stamps the key with today so airing data self-refreshes.
+  const day = () => new Date(now()).toISOString().slice(0, 10);
+  async function api(path, { bucket = null } = {}) {
+    const key = "tvdb|" + path + (bucket === "day" ? "|d:" + day() : "");
+    if (!cache) return raw(path);
+    const { body } = await cache.through(key, () => raw(path));
+    return body;
+  }
+
+  // ── identity bridge: IMDb/TMDb id → TVDB series id (permanent → κ-cached forever) ─────────────────────
+  async function seriesIdByRemote(remoteId) {
+    if (!remoteId) return null;
+    const d = await api("/search/remoteid/" + encodeURIComponent(String(remoteId)));
+    for (const hit of d || []) if (hit && hit.series && hit.series.id) return hit.series.id;
+    return null;
+  }
+
+  // one series, extended — status + airing + the full default-order episode list.
+  async function series(tvdbId) {
+    const d = await api(`/series/${tvdbId}/extended?meta=episodes&short=true`, { bucket: "day" });
+    if (!d) return null;
+    const eps = (d.episodes || []).filter((e) => e && e.seasonNumber > 0);
+    const today = day();
+    const next = d.nextAired ? eps.find((e) => e.aired === d.nextAired) : null;
+    return {
+      tvdbId: d.id, name: d.name || "", status: (d.status && d.status.name) || "",
+      nextAired: d.nextAired || "", lastAired: d.lastAired || "",
+      nextEpisode: next ? { name: next.name || "", seasonNumber: next.seasonNumber, episodeNumber: next.number, aired: next.aired } : null,
+      upcoming: eps.filter((e) => e.aired && e.aired >= today).length,
+      episodes: eps,
+    };
+  }
+
+  // a season's episodes in the player's ONE episode shape (drop-in for the TMDb season path).
+  function normalizeEpisodes(s, seasonNumber, ctx = {}) {
+    return (s.episodes || []).filter((e) => e.seasonNumber === seasonNumber).map((e) => ({
+      id: "tvdb:ep:" + s.tvdbId + ":" + e.seasonNumber + ":" + e.number,
+      tvdbId: e.id, kind: "episode",
+      name: e.name || `Episode ${e.number}`,
+      seriesId: ctx.id || "tvdb:series:" + s.tvdbId, seriesName: ctx.name || s.name,
+      parentId: "tvdb:season:" + s.tvdbId + ":" + e.seasonNumber,
+      seasonNumber: e.seasonNumber, episodeNumber: e.number,
+      overview: e.overview || "", blurb: e.overview || "", rating: null,
+      runtimeSec: e.runtime ? e.runtime * 60 : 0, releaseDate: e.aired || "",
+      posterUrl: artURL(e.image) || ctx.posterUrl || null, backdrop: ctx.backdrop || null,
+      topics: ctx.topics || [], genres: ctx.genres || [],
+      channel: "TheTVDB", quality: ctx.quality ?? 0.7, license: "",
+      source: "tvdb", provider: "tvdb", kappa: "", holoKappa: "tvdb:ep:" + s.tvdbId + ":" + e.seasonNumber + ":" + e.number,
+      availability: browseOnly(),
+    }));
+  }
+
+  // airingOf(item) — the magic line for a series card: resolves the item's IMDb/TMDb id to TVDB and
+  // answers { status, nextAired, nextEpisode } or null. Fully κ-cached: id-map forever, series daily.
+  async function airingOf(it) {
+    if (!it || (it.kind !== "series" && it.kind !== "tv")) return null;
+    let tid = it.tvdbId || null;
+    if (!tid && it.imdbId) tid = await seriesIdByRemote(it.imdbId).catch(() => null);
+    if (!tid && it.tmdbId) tid = await seriesIdByRemote(it.tmdbId).catch(() => null);
+    if (!tid) return null;
+    const s = await series(tid);
+    return s && { tvdbId: tid, status: s.status, nextAired: s.nextAired, nextEpisode: s.nextEpisode, upcoming: s.upcoming };
+  }
+
+  async function seasonEpisodes(it, seasonNumber) {
+    const a = await airingOf({ ...it, kind: "series" });
+    if (!a) return [];
+    const s = await series(a.tvdbId);
+    return s ? normalizeEpisodes(s, seasonNumber, it) : [];
+  }
+
+  return { login, token, series, seriesIdByRemote, normalizeEpisodes, airingOf, seasonEpisodes };
+}
+
+// Built-in community key — series airing intel works ZERO-SETUP for every visitor (quota: 100M hits/day;
+// answers are κ-cached so real traffic is a sliver of that).
+const BUILTIN_KEY = "935f2887-1087-4494-9071-d90d0bafaf43";
+
+// browser binding — real fetch + the persistent κ-cache + token parked in localStorage across sessions.
+if (typeof window !== "undefined") {
+  const lsTokenStore = {
+    get() { try { return JSON.parse(localStorage.getItem("holoplayer.tvdb.token") || "null"); } catch { return null; } },
+    set(t) { try { localStorage.setItem("holoplayer.tvdb.token", JSON.stringify(t)); } catch {} },
+  };
+  window.HoloTvdb = {
+    createTvdb,
+    live(opts = {}) {
+      const cache = window.HoloMediaCache ? window.HoloMediaCache.live() : null;
+      return createTvdb({ apikey: opts.apikey || BUILTIN_KEY, cache, tokenStore: lsTokenStore });
+    },
+  };
+}
+
+export default { createTvdb };