[ROMM-1176] Fetch video ID and place in carousel

backend/endpoints/responses/rom.py

@@ -85,6 +85,7 @@ class RomSchema(BaseModel):
 
     # Metadata fields
     first_release_date: int | None
+    youtube_video_id: str | None
     alternative_names: list[str]
     genres: list[str]
     franchises: list[str]

backend/endpoints/tests/test_rom.py

@@ -58,6 +58,7 @@ def test_update_rom(rename_file_mock, get_rom_by_id_mock, client, access_token,
             "dlcs": "[]",
             "companies": '[{"id": 203227, "company": {"id": 70, "name": "Nintendo"}}, {"id": 203307, "company": {"id": 766, "name": "Retro Studios"}}]',
             "first_release_date": 1675814400,
+            "youtube_video_id": "dQw4w9WgXcQ",
             "remasters": "[]",
             "remakes": "[]",
             "expanded_games": "[]",

backend/handler/metadata/igdb_handler.py

@@ -56,6 +56,7 @@ class IGDBMetadata(TypedDict):
     total_rating: str
     aggregated_rating: str
     first_release_date: int | None
+    youtube_video_id: str | None
     genres: list[str]
     franchises: list[str]
     alternative_names: list[str]
@@ -82,9 +83,12 @@ class IGDBRom(TypedDict):
     igdb_metadata: NotRequired[IGDBMetadata]
 
 
-def extract_metadata_from_igdb_rom(rom: dict) -> IGDBMetadata:
+def extract_metadata_from_igdb_rom(
+    rom: dict, video_id: str | None = None
+) -> IGDBMetadata:
     return IGDBMetadata(
         {
+            "youtube_video_id": video_id,
             "total_rating": str(round(rom.get("total_rating", 0.0), 2)),
             "aggregated_rating": str(round(rom.get("aggregated_rating", 0.0), 2)),
             "first_release_date": rom.get("first_release_date", None),
@@ -185,6 +189,7 @@ def __init__(self) -> None:
         self.games_fields = GAMES_FIELDS
         self.search_endpoint = f"{self.BASE_URL}/search"
         self.search_fields = SEARCH_FIELDS
+        self.video_endpoint = f"{self.BASE_URL}/game_videos"
         self.pagination_limit = 200
         self.twitch_auth = TwitchAuth()
         self.headers = {
@@ -202,7 +207,6 @@ async def wrapper(*args):
 
         return wrapper
 
-    # trunk-ignore(ruff/ASYNC109): timeout is used for request
     async def _request(self, url: str, data: str, timeout: int = 120) -> list:
         httpx_client = ctx_httpx_client.get()
         try:
@@ -424,6 +428,13 @@ async def get_rom(self, file_name: str, platform_igdb_id: int) -> IGDBRom:
         if not rom:
             return fallback_rom
 
+        # Get the video ID for the game
+        video_ids = await self._request(
+            self.video_endpoint,
+            f'fields video_id; where game={rom["id"]};',
+        )
+        video_id = pydash.get(video_ids, "[0].video_id", None)
+
         return IGDBRom(
             igdb_id=rom["id"],
             slug=rom["slug"],
@@ -438,7 +449,7 @@ async def get_rom(self, file_name: str, platform_igdb_id: int) -> IGDBRom:
                 )
                 for s in rom.get("screenshots", [])
             ],
-            igdb_metadata=extract_metadata_from_igdb_rom(rom),
+            igdb_metadata=extract_metadata_from_igdb_rom(rom, video_id),
         )
 
     @check_twitch_token
@@ -455,6 +466,13 @@ async def get_rom_by_id(self, igdb_id: int) -> IGDBRom:
         if not rom:
             return IGDBRom(igdb_id=None)
 
+        # Get the video ID for the game
+        video_ids = await self._request(
+            self.video_endpoint,
+            f'fields video_id; where game={rom["id"]};',
+        )
+        video_id = pydash.get(video_ids, "[0].video_id", None)
+
         return IGDBRom(
             igdb_id=rom["id"],
             slug=rom["slug"],
@@ -469,7 +487,7 @@ async def get_rom_by_id(self, igdb_id: int) -> IGDBRom:
                 )
                 for s in rom.get("screenshots", [])
             ],
-            igdb_metadata=extract_metadata_from_igdb_rom(rom),
+            igdb_metadata=extract_metadata_from_igdb_rom(rom, video_id),
         )
 
     @check_twitch_token