feat(frontend/api): tv details page

server/api/themoviedb.ts

@@ -238,6 +238,10 @@ export interface TmdbTvDetails {
   type: string;
   vote_average: number;
   vote_count: number;
+  credits: {
+    cast: TmdbCreditCast[];
+    crew: TmdbCreditCrew[];
+  };
 }
 
 class TheMovieDb {
@@ -304,7 +308,7 @@ class TheMovieDb {
   }): Promise<TmdbTvDetails> => {
     try {
       const response = await this.axios.get<TmdbTvDetails>(`/tv/${tvId}`, {
-        params: { language },
+        params: { language, append_to_response: 'credits' },
       });
 
       return response.data;
@@ -365,6 +369,60 @@ class TheMovieDb {
     }
   }
 
+  public async getTvRecommendations({
+    tvId,
+    page = 1,
+    language = 'en-US',
+  }: {
+    tvId: number;
+    page?: number;
+    language?: string;
+  }): Promise<TmdbSearchTvResponse> {
+    try {
+      const response = await this.axios.get<TmdbSearchTvResponse>(
+        `/tv/${tvId}/recommendations`,
+        {
+          params: {
+            page,
+            language,
+          },
+        }
+      );
+
+      return response.data;
+    } catch (e) {
+      throw new Error(
+        `[TMDB] Failed to fetch tv recommendations: ${e.message}`
+      );
+    }
+  }
+
+  public async getTvSimilar({
+    tvId,
+    page = 1,
+    language = 'en-US',
+  }: {
+    tvId: number;
+    page?: number;
+    language?: string;
+  }): Promise<TmdbSearchTvResponse> {
+    try {
+      const response = await this.axios.get<TmdbSearchTvResponse>(
+        `/tv/${tvId}/similar`,
+        {
+          params: {
+            page,
+            language,
+          },
+        }
+      );
+
+      return response.data;
+    } catch (e) {
+      throw new Error(`[TMDB] Failed to fetch tv similar: ${e.message}`);
+    }
+  }
+
   public getDiscoverMovies = async ({
     sortBy = 'popularity.desc',
     page = 1,

server/models/Movie.ts

@@ -1,31 +1,13 @@
-import {
-  TmdbMovieDetails,
-  TmdbCreditCast,
-  TmdbCreditCrew,
-} from '../api/themoviedb';
+import { TmdbMovieDetails } from '../api/themoviedb';
 import { MediaRequest } from '../entity/MediaRequest';
-import { ProductionCompany, Genre } from './common';
-
-export interface Cast {
-  id: number;
-  castId: number;
-  character: string;
-  creditId: string;
-  gender?: number;
-  name: string;
-  order: number;
-  profilePath?: string;
-}
-
-export interface Crew {
-  id: number;
-  creditId: string;
-  department: string;
-  gender?: number;
-  job: string;
-  name: string;
-  profilePath?: string;
-}
+import {
+  ProductionCompany,
+  Genre,
+  Cast,
+  Crew,
+  mapCast,
+  mapCrew,
+} from './common';
 
 export interface MovieDetails {
   id: number;
@@ -65,27 +47,6 @@ export interface MovieDetails {
   request?: MediaRequest;
 }
 
-const mapCast = (person: TmdbCreditCast): Cast => ({
-  castId: person.cast_id,
-  character: person.character,
-  creditId: person.credit_id,
-  id: person.id,
-  name: person.name,
-  order: person.order,
-  gender: person.gender,
-  profilePath: person.profile_path,
-});
-
-const mapCrew = (person: TmdbCreditCrew): Crew => ({
-  creditId: person.credit_id,
-  department: person.department,
-  id: person.id,
-  job: person.job,
-  name: person.name,
-  gender: person.gender,
-  profilePath: person.profile_path,
-});
-
 export const mapMovieDetails = (
   movie: TmdbMovieDetails,
   request?: MediaRequest

server/models/Tv.ts

@@ -1,4 +1,11 @@
-import { Genre, ProductionCompany } from './common';
+import {
+  Genre,
+  ProductionCompany,
+  Cast,
+  Crew,
+  mapCast,
+  mapCrew,
+} from './common';
 import { MediaRequest } from '../entity/MediaRequest';
 import {
   TmdbTvEpisodeDetails,
@@ -64,6 +71,10 @@ export interface TvDetails {
   type: string;
   voteAverage: number;
   voteCount: number;
+  credits: {
+    cast: Cast[];
+    crew: Crew[];
+  };
   request?: MediaRequest;
 }
 
@@ -140,5 +151,9 @@ export const mapTvDetails = (
     ? mapEpisodeDetails(show.next_episode_to_air)
     : undefined,
   posterPath: show.poster_path,
+  credits: {
+    cast: show.credits.cast.map(mapCast),
+    crew: show.credits.crew.map(mapCrew),
+  },
   request,
 });

server/models/common.ts

@@ -1,3 +1,5 @@
+import { TmdbCreditCast, TmdbCreditCrew } from '../api/themoviedb';
+
 export interface ProductionCompany {
   id: number;
   logoPath?: string;
@@ -9,3 +11,45 @@ export interface Genre {
   id: number;
   name: string;
 }
+
+export interface Cast {
+  id: number;
+  castId: number;
+  character: string;
+  creditId: string;
+  gender?: number;
+  name: string;
+  order: number;
+  profilePath?: string;
+}
+
+export interface Crew {
+  id: number;
+  creditId: string;
+  department: string;
+  gender?: number;
+  job: string;
+  name: string;
+  profilePath?: string;
+}
+
+export const mapCast = (person: TmdbCreditCast): Cast => ({
+  castId: person.cast_id,
+  character: person.character,
+  creditId: person.credit_id,
+  id: person.id,
+  name: person.name,
+  order: person.order,
+  gender: person.gender,
+  profilePath: person.profile_path,
+});
+
+export const mapCrew = (person: TmdbCreditCrew): Crew => ({
+  creditId: person.credit_id,
+  department: person.department,
+  id: person.id,
+  job: person.job,
+  name: person.name,
+  gender: person.gender,
+  profilePath: person.profile_path,
+});

server/overseerr-api.yml

@@ -562,6 +562,17 @@ components:
           type: number
         voteCount:
           type: number
+        credits:
+          type: object
+          properties:
+            cast:
+              type: array
+              items:
+                $ref: '#/components/schemas/Cast'
+            crew:
+              type: array
+              items:
+                $ref: '#/components/schemas/Crew'
         request:
           $ref: '#/components/schemas/MediaRequest'
     MediaRequest:
@@ -1415,6 +1426,11 @@ paths:
           schema:
             type: number
             example: 76479
+        - in: query
+          name: language
+          schema:
+            type: string
+            example: en
       responses:
         '200':
           description: TV details
@@ -1422,6 +1438,96 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/TvDetails'
+  /tv/{tvId}/recommendations:
+    get:
+      summary: Request recommended tv series
+      description: Returns list of recommended tv series based on provided tv ID in JSON format
+      tags:
+        - tv
+      parameters:
+        - in: path
+          name: tvId
+          required: true
+          schema:
+            type: number
+            example: 76479
+        - in: query
+          name: page
+          schema:
+            type: number
+            example: 1
+            default: 1
+        - in: query
+          name: language
+          schema:
+            type: string
+            example: en
+      responses:
+        '200':
+          description: List of tv series
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  page:
+                    type: number
+                    example: 1
+                  totalPages:
+                    type: number
+                    example: 20
+                  totalResults:
+                    type: number
+                    example: 200
+                  results:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/TvResult'
+  /tv/{tvId}/similar:
+    get:
+      summary: Request similar tv series
+      description: Returns list of similar tv series based on provided movie ID in JSON format
+      tags:
+        - tv
+      parameters:
+        - in: path
+          name: tvId
+          required: true
+          schema:
+            type: number
+            example: 76479
+        - in: query
+          name: page
+          schema:
+            type: number
+            example: 1
+            default: 1
+        - in: query
+          name: language
+          schema:
+            type: string
+            example: en
+      responses:
+        '200':
+          description: List of tv series
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  page:
+                    type: number
+                    example: 1
+                  totalPages:
+                    type: number
+                    example: 20
+                  totalResults:
+                    type: number
+                    example: 200
+                  results:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/TvResult'
 
 security:
   - cookieAuth: []

server/routes/tv.ts

@@ -2,17 +2,73 @@ import { Router } from 'express';
 import TheMovieDb from '../api/themoviedb';
 import { MediaRequest } from '../entity/MediaRequest';
 import { mapTvDetails } from '../models/Tv';
+import { mapTvResult } from '../models/Search';
 
 const tvRoutes = Router();
 
 tvRoutes.get('/:id', async (req, res) => {
   const tmdb = new TheMovieDb();
 
-  const tv = await tmdb.getTvShow({ tvId: Number(req.params.id) });
+  const tv = await tmdb.getTvShow({
+    tvId: Number(req.params.id),
+    language: req.query.language as string,
+  });
 
   const request = await MediaRequest.getRequest(tv.id);
 
   return res.status(200).json(mapTvDetails(tv, request));
 });
 
+tvRoutes.get('/:id/recommendations', async (req, res) => {
+  const tmdb = new TheMovieDb();
+
+  const results = await tmdb.getTvRecommendations({
+    tvId: Number(req.params.id),
+    page: Number(req.query.page),
+    language: req.query.language as string,
+  });
+
+  const requests = await MediaRequest.getRelatedRequests(
+    results.results.map((result) => result.id)
+  );
+
+  return res.status(200).json({
+    page: results.page,
+    totalPages: results.total_pages,
+    totalResults: results.total_results,
+    results: results.results.map((result) =>
+      mapTvResult(
+        result,
+        requests.find((req) => req.mediaId === result.id)
+      )
+    ),
+  });
+});
+
+tvRoutes.get('/:id/similar', async (req, res) => {
+  const tmdb = new TheMovieDb();
+
+  const results = await tmdb.getTvSimilar({
+    tvId: Number(req.params.id),
+    page: Number(req.query.page),
+    language: req.query.language as string,
+  });
+
+  const requests = await MediaRequest.getRelatedRequests(
+    results.results.map((result) => result.id)
+  );
+
+  return res.status(200).json({
+    page: results.page,
+    totalPages: results.total_pages,
+    totalResults: results.total_results,
+    results: results.results.map((result) =>
+      mapTvResult(
+        result,
+        requests.find((req) => req.mediaId === result.id)
+      )
+    ),
+  });
+});
+
 export default tvRoutes;