feat(watchlist): buildRecord — TMDB detail → canonical record

Port pure fn mapping raw TMDB JSON + prev frontmatter → WatchlistRecord. Fixtures from python reference selftest. TDD: 14 new cases all green.

tests/fixtures/tmdb-movie-dune2.json

@@ -0,0 +1,81 @@
+{
+  "id": 693134,
+  "title": "Dune: Part Two",
+  "original_title": "Dune: Part Two",
+  "original_language": "en",
+  "spoken_languages": [
+    {
+      "iso_639_1": "en",
+      "english_name": "English"
+    }
+  ],
+  "overview": "Paul Atreides unites with the Fremen...",
+  "runtime": 167,
+  "status": "Released",
+  "release_date": "2024-02-27",
+  "vote_average": 8.1,
+  "homepage": "https://www.dunemovie.com",
+  "poster_path": "/1pdfLvkbY9ohJlCjQH2CZjjYVvJ.jpg",
+  "genres": [
+    {
+      "name": "Science Fiction"
+    },
+    {
+      "name": "Adventure"
+    }
+  ],
+  "production_countries": [
+    {
+      "name": "United States of America"
+    }
+  ],
+  "credits": {
+    "cast": [
+      {
+        "name": "Timothée Chalamet"
+      },
+      {
+        "name": "Zendaya"
+      }
+    ],
+    "crew": [
+      {
+        "job": "Director",
+        "name": "Denis Villeneuve"
+      },
+      {
+        "job": "Screenplay",
+        "name": "Jon Spaihts"
+      },
+      {
+        "job": "Producer",
+        "name": "Mary Parent"
+      }
+    ]
+  },
+  "external_ids": {
+    "imdb_id": "tt15239678"
+  },
+  "release_dates": {
+    "results": [
+      {
+        "iso_3166_1": "US",
+        "release_dates": [
+          {
+            "certification": "PG-13"
+          }
+        ]
+      }
+    ]
+  },
+  "videos": {
+    "results": [
+      {
+        "site": "YouTube",
+        "type": "Trailer",
+        "official": true,
+        "key": "Way9Dexny3w"
+      }
+    ]
+  }
+}

tests/fixtures/tmdb-tv-loki.json

@@ -0,0 +1,80 @@
+{
+  "id": 84958,
+  "name": "Loki",
+  "original_name": "Loki",
+  "original_language": "en",
+  "spoken_languages": [
+    {
+      "iso_639_1": "en",
+      "english_name": "English"
+    }
+  ],
+  "overview": "After stealing the Tesseract...",
+  "episode_run_time": [],
+  "status": "Ended",
+  "first_air_date": "2021-06-09",
+  "last_air_date": "2023-11-09",
+  "number_of_seasons": 2,
+  "number_of_episodes": 12,
+  "networks": [
+    {
+      "name": "Disney+"
+    }
+  ],
+  "vote_average": 8.2,
+  "homepage": "https://www.disneyplus.com/series/wp/6pARMvILBGzF",
+  "poster_path": null,
+  "genres": [
+    {
+      "name": "Drama"
+    },
+    {
+      "name": "Sci-Fi & Fantasy"
+    }
+  ],
+  "origin_country": [
+    "United States of America"
+  ],
+  "created_by": [
+    {
+      "name": "Michael Waldron"
+    }
+  ],
+  "aggregate_credits": {
+    "cast": [
+      {
+        "name": "Tom Hiddleston"
+      },
+      {
+        "name": "Sophia Di Martino"
+      }
+    ]
+  },
+  "external_ids": {
+    "imdb_id": "tt9140554"
+  },
+  "content_ratings": {
+    "results": [
+      {
+        "iso_3166_1": "US",
+        "rating": "TV-14"
+      }
+    ]
+  },
+  "videos": {
+    "results": [
+      {
+        "site": "YouTube",
+        "type": "Trailer",
+        "official": true,
+        "key": "nW948Va-l10"
+      }
+    ]
+  },
+  "last_episode_to_air": {
+    "season_number": 2,
+    "episode_number": 6,
+    "name": "Glorious Purpose"
+  },
+  "next_episode_to_air": null
+}

tests/watchlist-build.test.ts

@@ -0,0 +1,112 @@
+import { describe, expect, test } from 'bun:test';
+import { buildRecord } from 'packages/obsidian/src/watchlist/build';
+import movieDetail from 'tests/fixtures/tmdb-movie-dune2.json';
+import tvDetail from 'tests/fixtures/tmdb-tv-loki.json';
+
+const EMPTY_PREV = { watch_status: 'Unwatched', rating: '0', rating_stars: '' };
+
+describe('buildRecord movie', () => {
+	const r = buildRecord(movieDetail, true, EMPTY_PREV);
+	test('core mapping (mirrors python selftest)', () => {
+		expect(r.language).toBe('English');
+		expect(r.country).toBe('United States of America');
+		expect(r.imdbId).toBe('tt15239678');
+		expect(r.contentRating).toBe('PG-13');
+		expect(r.tmdbId).toBe('693134');
+		expect(r.category).toBe('Movie');
+		expect(r.trailer).toContain('youtube.com');
+		expect(r.year).toBe('2024');
+		expect(r.director).toEqual(['Denis Villeneuve']);
+		expect(r.writer).toEqual(['Jon Spaihts']);
+		expect(r.producer).toEqual(['Mary Parent']);
+		expect(r.imdbPage).toBe('https://www.imdb.com/title/tt15239678/');
+	});
+	test('movie: seasons/episodes null, vod empty', () => {
+		expect(r.seasons).toBeNull();
+		expect(r.episodes).toBeNull();
+		expect(r.vod).toEqual([]);
+	});
+});
+
+describe('buildRecord tv', () => {
+	const r = buildRecord(tvDetail, false, EMPTY_PREV);
+	test('tv mapping', () => {
+		expect(r.mediaType).toBe('TV Series');
+		expect(r.category).toBe('Series');
+		expect(r.year).toBe('2021 - 2023');
+		expect(r.seasons).toBe(2);
+		expect(r.episodes).toBe(12);
+		expect(r.vod).toEqual(['Disney+']);
+		expect(r.contentRating).toBe('TV-14');
+		expect(r.lastEpisode).toBe('S2, E6: Glorious Purpose');
+		expect(r.upcomingEpisode).toBeNull();
+		expect(r.runtime).toBeNull();
+		expect(r.director).toEqual(['Michael Waldron']);
+	});
+	test('ongoing series year + TBA', () => {
+		const ongoing = { ...tvDetail, status: 'Returning Series', last_air_date: '2026-01-01', next_episode_to_air: null };
+		const r2 = buildRecord(ongoing, false, EMPTY_PREV);
+		expect(r2.year).toBe('2021 -');
+		expect(r2.upcomingEpisode).toBe('TBA');
+	});
+	test('same start/end year collapses', () => {
+		const oneYear = { ...tvDetail, first_air_date: '2021-06-09', last_air_date: '2021-07-14' };
+		expect(buildRecord(oneYear, false, EMPTY_PREV).year).toBe('2021');
+	});
+});
+
+describe('anime derivation', () => {
+	test('Animation + Japanese → Anime', () => {
+		const anime = {
+			...tvDetail,
+			genres: [{ name: 'Animation' }, { name: 'Drama' }],
+			original_language: 'ja',
+			spoken_languages: [{ iso_639_1: 'ja', english_name: 'Japanese' }],
+		};
+		expect(buildRecord(anime, false, EMPTY_PREV).category).toBe('Anime');
+	});
+	test('Animation + English → not Anime', () => {
+		const western = { ...tvDetail, genres: [{ name: 'Animation' }] };
+		expect(buildRecord(western, false, EMPTY_PREV).category).toBe('Series');
+	});
+});
+
+describe('user-field preservation', () => {
+	test('prev fields carried', () => {
+		const prev = { watch_status: 'Watching', rating: '4', rating_stars: '⭐️⭐️⭐️⭐️', notion_url: 'https://notion.so/x' };
+		const r = buildRecord(tvDetail, false, prev);
+		expect(r.watchStatus).toBe('Watching');
+		expect(r.rating).toBe('4');
+		expect(r.ratingStars).toBe('⭐️⭐️⭐️⭐️');
+		expect(r.notionUrl).toBe('https://notion.so/x');
+	});
+});
+
+describe('watch-status rule (TV)', () => {
+	test('Watched + newer episode → Unwatched', () => {
+		const prev = { watch_status: 'Watched', last_air_date: '2023-10-01', rating: '5', rating_stars: '⭐️⭐️⭐️⭐️⭐️' };
+		expect(buildRecord(tvDetail, false, prev).watchStatus).toBe('Unwatched');
+	});
+	test('Watched + same date → stays Watched', () => {
+		const prev = { watch_status: 'Watched', last_air_date: '2023-11-09' };
+		expect(buildRecord(tvDetail, false, prev).watchStatus).toBe('Watched');
+	});
+	test('movie never flips', () => {
+		const prev = { watch_status: 'Watched', last_air_date: '2020-01-01' };
+		expect(buildRecord(movieDetail, true, prev).watchStatus).toBe('Watched');
+	});
+	test('no prev last_air_date → no flip', () => {
+		const prev = { watch_status: 'Watched' };
+		expect(buildRecord(tvDetail, false, prev).watchStatus).toBe('Watched');
+	});
+});
+
+describe('eng_name derivation', () => {
+	test('non-Latin original → engName = localized title', () => {
+		const jp = { ...movieDetail, title: 'A Silent Voice: The Movie', original_title: '映画 聲の形' };
+		expect(buildRecord(jp, true, EMPTY_PREV).engName).toBe('A Silent Voice: The Movie');
+	});
+	test('same Latin title → empty', () => {
+		expect(buildRecord(movieDetail, true, EMPTY_PREV).engName).toBe('');
+	});
+});