mirror of
https://github.com/4gray/iptvnator.git
synced 2026-10-15 21:56:18 -08:00
* feat(tmdb): opt-in TMDB metadata enrichment for Xtream and Stalker portals Adds an opt-in TMDB integration (Settings > Metadata) that enriches detail views with a field-level merge — the provider stays authoritative for stream data, TMDB fills editorial fields when the match is confident. Enrichment: - Movie/series details: plot, cast (avatar chips), director, genres, rating, poster/backdrop, official YouTube trailers - Confidence-gated matching: provider tmdb_id trusted; otherwise normalized-title search with year gate (±1; series accept earlier premieres), season-suffix stripping, Cyrillic search-language override, and language-prefix fallback variants - Lazy season/episode enrichment: real episode names, overviews, stills - "Similar" rail (Xtream): TMDB recommendations matched to the catalog - Actor pages per portal with full filmography, availability filter and an Electron-only "All portals" scope backed by a batched DB_MATCH_TITLES worker op over the trigram FTS index Infrastructure: - SQLite cache table tmdb_metadata (details, search verdicts, seasons, persons; per-language, TTL-guarded), in-memory fallback for the PWA - Settings: enable toggle, own-API-key override with a live "check key" button; TMDB attribution in Settings and About - Embedded key stays an empty placeholder; CI injects TMDB_API_KEY via tools/tmdb/inject-tmdb-key.mjs when the secret is configured - normalizeTitle shared between renderer and DB worker - CSP: allow YouTube embeds (frame-src was 'none'; trailers never worked) Fixes and refactors along the way: - fix(stalker): Advanced Search sent bare get_ordered_list requests and skipped the auth handshake when isFullStalkerPortal was missing on the active-playlist meta — full portals answered "Authorization failed." and search looked empty; now mirrors the catalog request shape and routes through makeAuthenticatedRequest with URL-based detection - fix(stalker): TMDB fields survive info re-normalization; detail views prefer the store copy patched by async enrichment over stale snapshots - refactor(xtream): split oversized vod/serial detail components into component-scoped playback services; detail routes re-initialize on route param changes (router reuses them for detail-to-detail nav) - i18n: all new keys translated across the 18 locales Docs: docs/architecture/tmdb-metadata-enrichment.md + CLAUDE.md updates. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(tmdb): provide route params observable to inline collection details, linearize regexes The global-collection inline detail host builds a fake ActivatedRoute for VodDetailsRouteComponent/SerialDetailsComponent with only snapshot.params. Since the detail components now read route.params via toSignal() (detail-> detail re-init), the missing observable crashed component construction and the content hero never rendered — broke dashboard-activation, favorites and recent Electron E2E on all platforms. Provide the params observable alongside the snapshot and assert it in the component spec. Also resolves both CodeQL js/polynomial-redos alerts: bracket-stripping in normalizeTitle now excludes opening delimiters inside the classes, and youtubeEmbedUrl extracts watch?v= ids with a linear two-pass match instead of "watch\?.*v=". Combining-diacritics range rewritten as explicit \u escapes (greptile note). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(tmdb): surface TMDB-only VOD score in the rating badge, drop youtube.com from CSP Review follow-ups on PR #1123: the Xtream VOD detail badge renders rating_imdb, but the merge wrote the TMDB score only into `rating`, so a TMDB-only score was never displayed (Codex P2) — fill rating_imdb when the provider left it empty, mirroring the Stalker merge. All trailer iframes are normalized to youtube-nocookie.com, so the extra youtube.com frame-src allowance was dead surface (greptile) — removed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(tmdb): resolve confirmed review findings — matching correctness, race guards, cache schema Fixes the confirmed findings from the PR #1123 code review: - Stalker search: setSelectedContentType now runs BEFORE setSelectedItem, so the TMDB enrichment gate in the selection hook no longer sees the content type of the previously open tab (wrong/no enrichment after ITV -> search -> movie). - Title normalization is now two-tier (normalizeTitleKeys): the exact normalized form keeps a trailing year, the base form strips it and remembers the tag. Year stripping is anchored to the end of the title ("2001: A Space Odyssey" keeps its year) and language-prefix stripping is UPPERCASE-only ("It: Chapter Two" is no longer amputated). - All catalog matching (similar rail, actor pages, DB worker DB_MATCH_TITLES) compares exact forms first and only accepts year-stripped matches when the stripped tag is year-compatible (+-1) with the TMDB year — "Blade Runner" (1982) can no longer claim a catalog "Blade Runner 2049". CatalogTitleMatch carries the stripped trailingYear so the renderer can apply the guard to worker matches. - mergedBackdrops tolerates a plain-string backdrop_path; enrichment merge+patch blocks are wrapped in try/catch so a malformed provider payload can no longer become an unhandled rejection. - loadGlobalMatches (both actor routes) guards against actor->actor navigation races — a slow match for the previous person no longer overwrites the current one's results. - tmdb_metadata media_type CHECK widened to ('movie','tv','person') and person rows now use the honest 'person' type (TmdbCacheMediaType). Pre-release dev DBs with the narrow CHECK are rebuilt in place — the table is a pure cache, so the migration is a self-healing drop-and-recreate keyed off sqlite_master. Docs updated (tmdb-metadata-enrichment.md, CLAUDE.md). New regression coverage: title-normalization.util.spec.ts, two-tier cases in tmdb-similar.util.spec.ts and title-match.operations.spec.ts. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
103 lines
3.4 KiB
TypeScript
103 lines
3.4 KiB
TypeScript
import type { AppDatabase } from '../database.types';
|
|
import { matchTitles } from './title-match.operations';
|
|
|
|
function createDbMock(rowsPerCall: unknown[][]) {
|
|
let call = 0;
|
|
const all = jest.fn().mockImplementation(() => {
|
|
const rows = rowsPerCall[call] ?? [];
|
|
call += 1;
|
|
return Promise.resolve(rows);
|
|
});
|
|
return { db: { all } as unknown as AppDatabase, all };
|
|
}
|
|
|
|
const matrixRow = {
|
|
title: 'The Matrix [4K]',
|
|
xtream_id: 42,
|
|
type: 'movie',
|
|
category_xtream_id: 7,
|
|
playlist_id: 'playlist-1',
|
|
playlist_name: 'My Portal',
|
|
};
|
|
|
|
describe('title-match.operations', () => {
|
|
it('returns confident matches with playlist context', async () => {
|
|
const { db } = createDbMock([[matrixRow]]);
|
|
|
|
await expect(matchTitles(db, ['The Matrix'])).resolves.toEqual([
|
|
{
|
|
queryTitle: 'The Matrix',
|
|
playlistId: 'playlist-1',
|
|
playlistName: 'My Portal',
|
|
categoryId: 7,
|
|
xtreamId: 42,
|
|
type: 'movie',
|
|
trailingYear: null,
|
|
},
|
|
]);
|
|
});
|
|
|
|
it('reports the stripped year tag for base-tier matches', async () => {
|
|
const { db } = createDbMock([
|
|
[{ ...matrixRow, title: 'The Matrix 1999' }],
|
|
]);
|
|
|
|
const matches = await matchTitles(db, ['The Matrix']);
|
|
expect(matches).toHaveLength(1);
|
|
expect(matches[0].trailingYear).toBe(1999);
|
|
});
|
|
|
|
it('keeps title-years intact on the exact tier', async () => {
|
|
const { db } = createDbMock([
|
|
[{ ...matrixRow, title: 'Blade Runner 2049' }],
|
|
]);
|
|
|
|
// Exact-tier: the query itself carries the year as part of the title
|
|
const exact = await matchTitles(db, ['Blade Runner 2049']);
|
|
expect(exact).toHaveLength(1);
|
|
expect(exact[0].trailingYear).toBeNull();
|
|
});
|
|
|
|
it('flags "Blade Runner" matching "Blade Runner 2049" with the year tag', async () => {
|
|
const { db } = createDbMock([
|
|
[{ ...matrixRow, title: 'Blade Runner 2049' }],
|
|
]);
|
|
|
|
// Base-tier hit: the renderer must reject it via the 2049/1982
|
|
// year incompatibility (trailingYear is surfaced for exactly that)
|
|
const matches = await matchTitles(db, ['Blade Runner']);
|
|
expect(matches).toHaveLength(1);
|
|
expect(matches[0].trailingYear).toBe(2049);
|
|
});
|
|
|
|
it('drops FTS candidates whose normalized title differs', async () => {
|
|
const { db } = createDbMock([
|
|
[{ ...matrixRow, title: 'The Matrix Reloaded' }],
|
|
]);
|
|
|
|
await expect(matchTitles(db, ['The Matrix'])).resolves.toEqual([]);
|
|
});
|
|
|
|
it('skips titles that normalize to nothing usable and deduplicates', async () => {
|
|
const { db, all } = createDbMock([[matrixRow]]);
|
|
|
|
await matchTitles(db, ['', ' ', 'The Matrix', 'The Matrix']);
|
|
expect(all).toHaveBeenCalledTimes(1);
|
|
});
|
|
|
|
it('survives a failing FTS query for one title', async () => {
|
|
let call = 0;
|
|
const all = jest.fn().mockImplementation(() => {
|
|
call += 1;
|
|
return call === 1
|
|
? Promise.reject(new Error('fts syntax'))
|
|
: Promise.resolve([matrixRow]);
|
|
});
|
|
const db = { all } as unknown as AppDatabase;
|
|
|
|
const matches = await matchTitles(db, ['Weird "Title"', 'The Matrix']);
|
|
expect(matches).toHaveLength(1);
|
|
expect(matches[0].queryTitle).toBe('The Matrix');
|
|
});
|
|
});
|