Files
iptvnator/apps/electron-backend/src/app/database/operations/title-match.operations.spec.ts
T
4grayandClaude Fable 5 dc05a2566e feat(tmdb): opt-in TMDB metadata enrichment for Xtream and Stalker portals (#1123)
* 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>
2026-07-04 17:07:46 +02:00

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');
});
});