@tdanks2000/tmdb-wrapper 1.0.0

package/src/@types/endpoints/options.ts

@@ -0,0 +1,189 @@
+import {
+  AlternativeTitles,
+  Changes,
+  ContentRatings,
+  Credits,
+  EpisodeGroups,
+  ExternalIds,
+  Images,
+  Keywords,
+  MovieChangeValue,
+  MovieLists,
+  PeopleImages,
+  PersonChangeValue,
+  PersonCombinedCredits,
+  PersonMovieCredit,
+  PersonTranslations,
+  PersonTvShowCredit,
+  Recommendations,
+  ReleaseDates,
+  Reviews,
+  ScreenedTheatrically,
+  SimilarMovies,
+  Similartv,
+  TaggedImages,
+  Translations,
+  TvEpisodeChangeValue,
+  TvEpisodeCredit,
+  TvEpisodeTranslations,
+  TvSeasonChangeValue,
+  TvShowChangeValue,
+  Videos,
+  WatchProviders,
+} from '..';
+
+export interface LanguageOption {
+  language?: string;
+}
+
+export interface RegionOption {
+  region?: string;
+}
+
+export interface TimezoneOption {
+  timezone?: string;
+}
+
+export interface PageOption {
+  page?: number;
+}
+
+export interface ChangeOption extends PageOption {
+  start_date?: Date;
+  end_date?: Date;
+}
+
+export type AppendToResponseMovieKey =
+  | 'images'
+  | 'videos'
+  | 'credits'
+  | 'recommendations'
+  | 'reviews'
+  | 'changes'
+  | 'similar'
+  | 'lists'
+  | 'release_dates'
+  | 'alternative_titles'
+  | 'external_ids'
+  | 'translations'
+  | 'watch/providers'
+  | 'keywords';
+
+export type AppendToResponseTvKey =
+  | 'content_ratings'
+  | 'images'
+  | 'videos'
+  | 'credits'
+  | 'recommendations'
+  | 'reviews'
+  | 'changes'
+  | 'similar'
+  | 'alternative_titles'
+  | 'external_ids'
+  | 'translations'
+  | 'watch/providers'
+  | 'aggregate_credits'
+  | 'episode_groups'
+  | 'screened_theatrically'
+  | 'keywords';
+
+export type AppendToResponsePersonKey =
+  | 'images'
+  | 'changes'
+  | 'movie_credits'
+  | 'tv_credits'
+  | 'combined_credits'
+  | 'external_ids'
+  | 'tagged_images'
+  | 'translations';
+
+export type AppendToResponseTvEpisodeKey = 'images' | 'credits' | 'external_ids' | 'videos' | 'translations';
+
+export type AppendToResponseTvSeasonKey =
+  | 'images'
+  | 'credits'
+  | 'external_ids'
+  | 'videos'
+  | 'aggregate_credits'
+  | 'translations';
+
+type AppendToResponseAllKeys =
+  | AppendToResponseTvKey
+  | AppendToResponseMovieKey
+  | AppendToResponseTvEpisodeKey
+  | AppendToResponseTvSeasonKey
+  | AppendToResponsePersonKey;
+
+export type AppendToResponseMediaType = 'movie' | 'tvShow' | 'person' | 'tvSeason' | 'tvEpisode';
+
+export type AppendToResponse<
+  K,
+  T extends AppendToResponseAllKeys[] | undefined,
+  Media extends AppendToResponseMediaType,
+> = K &
+  (T extends undefined
+    ? object
+    : T extends Array<unknown>
+    ? ('credits' extends T[number]
+        ? {
+            credits: Media extends 'tvEpisode' ? TvEpisodeCredit : Omit<Credits, 'id'>;
+          }
+        : object) &
+        ('videos' extends T[number] ? { videos: Omit<Videos, 'id'> } : object) &
+        ('images' extends T[number]
+          ? {
+              images: Omit<Media extends 'person' ? PeopleImages : Images, 'id'>;
+            }
+          : object) &
+        ('recommendations' extends T[number] ? { recommendations: Recommendations } : object) &
+        ('reviews' extends T[number] ? { reviews: Omit<Reviews, 'id'> } : object) &
+        ('reviews' extends T[number] ? { reviews: Omit<Translations, 'id'> } : object) &
+        ('changes' extends T[number]
+          ? {
+              changes: Changes<
+                Media extends 'person'
+                  ? PersonChangeValue
+                  : Media extends 'movie'
+                  ? MovieChangeValue
+                  : Media extends 'tvShow'
+                  ? TvShowChangeValue
+                  : Media extends 'tvSeason'
+                  ? TvSeasonChangeValue
+                  : TvEpisodeChangeValue
+              >;
+            }
+          : object) &
+        ('keywords' extends T[number] ? { keywords: Omit<Keywords, 'id'> } : object) &
+        ('lists' extends T[number] ? { lists: Omit<MovieLists, 'id'> } : object) &
+        ('release_dates' extends T[number] ? { release_dates: Omit<ReleaseDates, 'id'> } : object) &
+        ('alternative_titles' extends T[number] ? { alternative_titles: Omit<AlternativeTitles, 'id'> } : object) &
+        ('external_ids' extends T[number] ? { external_ids: Omit<ExternalIds, 'id'> } : object) &
+        ('translations' extends T[number]
+          ? {
+              translations: Omit<
+                Media extends 'person'
+                  ? PersonTranslations
+                  : Media extends 'tvEpisode'
+                  ? TvEpisodeTranslations
+                  : Translations,
+                'id'
+              >;
+            }
+          : object) &
+        ('watch/providers' extends T[number] ? { 'watch/providers': Omit<WatchProviders, 'id'> } : object) &
+        ('aggregate_credits' extends T[number] ? { aggregate_credits: Omit<Credits, 'id'> } : object) &
+        ('episode_groups' extends T[number] ? { episode_groups: Omit<EpisodeGroups, 'id'> } : object) &
+        ('screened_theatrically' extends T[number]
+          ? { screened_theatrically: Omit<ScreenedTheatrically, 'id'> }
+          : object) &
+        ('similar' extends T[number]
+          ? {
+              similar: Media extends 'movie' ? SimilarMovies : Media extends 'tvShow' ? Similartv : unknown;
+            }
+          : object) &
+        ('content_ratings' extends T[number] ? { content_ratings: Omit<ContentRatings, 'id'> } : object) &
+        ('movie_credits' extends T[number] ? { movie_credits: Omit<PersonMovieCredit, 'id'> } : object) &
+        ('tv_credits' extends T[number] ? { tv_credits: Omit<PersonTvShowCredit, 'id'> } : object) &
+        ('combined_credits' extends T[number] ? { combined_credits: Omit<PersonCombinedCredits, 'id'> } : object) &
+        ('tagged_images' extends T[number] ? { tagged_images: TaggedImages } : object)
+    : never);

package/src/@types/endpoints/people.ts

@@ -0,0 +1,151 @@
+import { Image, Movie, Person, TV } from '..';
+
+interface Cast {
+  character: string;
+  credit_id: string;
+  vote_count: number;
+  id: number;
+  backdrop_path: string;
+  poster_path: string;
+  original_language: string;
+  vote_average: number;
+  genre_ids: number[];
+  popularity: number;
+  overview: string;
+}
+
+interface Crew {
+  id: number;
+  department: string;
+  original_language: string;
+  credit_id: string;
+  overview: string;
+  vote_count: number;
+  poster_path: string;
+  backdrop_path: string;
+  popularity: number;
+  genre_ids: number[];
+  job: string;
+  vote_average: number;
+}
+
+export interface PersonMovieCast extends Cast {
+  release_date: string;
+  video: boolean;
+  adult: boolean;
+  title: string;
+  original_title: string;
+}
+
+export interface PersonMovieCrew extends Crew {
+  original_title: string;
+  video: boolean;
+  title: string;
+  adult: boolean;
+  release_date: string;
+}
+
+export interface PersonTvShowCrew extends Crew {
+  episode_count: number;
+  origin_country: string[];
+  original_name: string;
+  name: string;
+  first_air_date: string;
+}
+
+export interface PersonTvShowCast extends Cast {
+  original_name: string;
+  name: string;
+  episode_count: number;
+  first_air_date: string;
+  origin_country: string[];
+}
+
+export interface PersonMovieCredit {
+  cast: PersonMovieCast[];
+  crew: PersonMovieCrew[];
+  id: number;
+}
+
+export interface PersonTvShowCredit {
+  cast: PersonTvShowCast[];
+  crew: PersonTvShowCrew[];
+  id: number;
+}
+
+export interface PersonCombinedCredits {
+  cast: (PersonMovieCast & PersonTvShowCast)[];
+  crew: (PersonMovieCrew & PersonTvShowCrew)[];
+  id: number;
+}
+
+export interface PersonDetails {
+  birthday: string;
+  known_for_department: string;
+  deathday: string;
+  id: number;
+  name: string;
+  also_known_as: string[];
+  gender: number;
+  biography: string;
+  popularity: number;
+  place_of_birth: string;
+  profile_path: string;
+  adult: boolean;
+  imdb_id: string;
+  homepage: string;
+}
+
+export type PersonChangeValue =
+  | string
+  | {
+      profile: {
+        file_path: string;
+      };
+    };
+
+export interface PopularPersons {
+  page: number;
+  results: Person[];
+  total_results: number;
+  total_pages: number;
+}
+
+export interface PeopleImages {
+  id: number;
+  profiles: Image[];
+}
+
+export interface TaggedImage {
+  aspect_ratio: number;
+  file_path: string;
+  height: number;
+  id: string;
+  iso_639_1: string;
+  vote_average: number;
+  vote_count: number;
+  width: number;
+  image_type: string;
+  media_type: string;
+  media: Movie | TV;
+}
+
+export interface TaggedImages {
+  page: number;
+  results: TaggedImage[];
+  total_results: number;
+  total_pages: number;
+}
+
+export interface PersonTranslations {
+  id: number;
+  translations: {
+    iso_3166_1: string;
+    iso_639_1: string;
+    name: string;
+    english_name: string;
+    data: {
+      biography: string;
+    };
+  };
+}

package/src/@types/endpoints/review.ts

@@ -0,0 +1,8 @@
+import { Review } from '..';
+
+export interface ReviewDetails extends Review {
+  iso_639_1: string;
+  media_id: number;
+  media_title: number;
+  media_type: number;
+}

package/src/@types/endpoints/search.ts

@@ -0,0 +1,10 @@
+import { MovieWithMediaType, PersonWithMediaType, TVWithMediaType } from '..';
+
+export interface Search<T> {
+  page: number;
+  results: T[];
+  total_pages: number;
+  total_results: number;
+}
+
+export type MultiSearchResult = MovieWithMediaType | TVWithMediaType | PersonWithMediaType;

package/src/@types/endpoints/trending.ts

@@ -0,0 +1,20 @@
+import { MediaType, Movie, MovieWithMediaType, Person, PersonWithMediaType, TV, TVWithMediaType } from '..';
+
+export type TimeWindow = 'day' | 'week';
+
+export type TrendingMediaType = MediaType | 'all';
+
+type TrendingResult<T extends TrendingMediaType> = T extends 'tv'
+  ? TV
+  : T extends 'movie'
+  ? Movie
+  : T extends 'person'
+  ? Person
+  : TVWithMediaType | MovieWithMediaType | PersonWithMediaType;
+
+export interface TrendingResults<T extends TrendingMediaType> {
+  page: number;
+  results: TrendingResult<T>[];
+  total_pages: number;
+  total_results: number;
+}

package/src/@types/endpoints/tvEpisode.ts

@@ -0,0 +1,58 @@
+import { Credits, Crew } from '..';
+
+export interface EpisodeSelection {
+  tvShowID: number;
+  seasonNumber: number;
+  episodeNumber: number;
+}
+
+export interface Episode {
+  air_date: string;
+  episode_number: number;
+  crew: Crew[];
+  guest_stars: GuestStar[];
+  id: number;
+  name: string;
+  overview: string;
+  production_code: string;
+  season_number: number;
+  still_path: string;
+  vote_average: number;
+  vote_count: number;
+  runtime: number;
+  show_id: number;
+}
+
+export interface GuestStar {
+  credit_id: string;
+  order: number;
+  character: string;
+  adult: boolean;
+  gender: number | null;
+  id: number;
+  known_for_department: string;
+  name: string;
+  original_name: string;
+  popularity: number;
+  profile_path: string | null;
+}
+
+export interface TvEpisodeCredit extends Credits {
+  guest_stars: GuestStar[];
+}
+
+export interface TvEpisodeTranslations {
+  id: number;
+  translations: {
+    iso_3166_1: string;
+    iso_639_1: string;
+    name: string;
+    english_name: string;
+    data: {
+      name: string;
+      overview: string;
+    };
+  };
+}
+
+export type TvEpisodeChangeValue = string | unknown;

package/src/@types/endpoints/tvSeasons.ts

@@ -0,0 +1,23 @@
+import { Episode } from '..';
+
+export interface SeasonSelection {
+  tvShowID: number;
+  seasonNumber: number;
+}
+
+export interface SeasonDetails {
+  air_date: string;
+  episodes: Episode[];
+  name: string;
+  overview: string;
+  id: number;
+  poster_path: string | null;
+  season_number: number;
+}
+
+export type TvSeasonChangeValue =
+  | string
+  | {
+      episode_id: number;
+      episode_number: number;
+    };