@tdanks2000/tmdb-wrapper 1.4.0 → 1.6.0

package/dist/index.d.mts

@@ -23,17 +23,7 @@ interface Certification {
   order: number;
 }
 interface Certifications {
-  certifications: {
-    US: Certification[];
-    CA: Certification[];
-    DE: Certification[];
-    GB: Certification[];
-    AU: Certification[];
-    BR: Certification[];
-    FR: Certification[];
-    NZ: Certification[];
-    IN: Certification[];
-  };
+  certifications: Record<string, Certification[]>;
 }
 //# sourceMappingURL=certification.d.ts.map
 //#endregion
@@ -65,12 +55,18 @@ interface ChangeItem<T> {
 }
 //# sourceMappingURL=changes.d.ts.map
 //#endregion
+//#region src/@types/wire.d.ts
+type TMDBDate = string;
+type TMDBDateTime = string;
+type Nullable<T> = T | null;
+//# sourceMappingURL=wire.d.ts.map
+//#endregion
 //#region src/@types/endpoints/collection.d.ts
 interface Collection {
   id: number;
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   name: string;
-  poster_path: string;
+  poster_path: Nullable<string>;
   adult: boolean;
   original_language: string;
   original_name: string;
@@ -228,7 +224,7 @@ declare enum ChangeKeys {
 //#region src/@types/endpoints/credits.d.ts
 interface CreditSeason {
   air_date?: string;
-  poster_path?: string;
+  poster_path: Nullable<string>;
   season_number?: number;
 }
 interface Media$1 {
@@ -238,11 +234,11 @@ interface Media$1 {
   vote_count?: number;
   overview?: string;
   vote_average?: number;
-  backdrop_path?: string;
+  backdrop_path: Nullable<string>;
   genre_ids?: number[];
   original_name?: string;
   origin_country?: string[];
-  poster_path?: string;
+  poster_path: Nullable<string>;
   original_language?: string;
   popularity?: number;
   character?: string;
@@ -275,7 +271,7 @@ interface Cast {
   name: string;
   original_name: string;
   popularity: number;
-  profile_path: string;
+  profile_path: Nullable<string>;
   cast_id: number;
   character: string;
   credit_id: string;
@@ -289,7 +285,7 @@ interface Crew {
   name: string;
   original_name: string;
   popularity: number;
-  profile_path: string;
+  profile_path: Nullable<string>;
   credit_id: string;
   department: string;
   job: string;
@@ -336,7 +332,7 @@ interface AggregateCast {
   name: string;
   original_name: string;
   popularity: number;
-  profile_path: string;
+  profile_path: Nullable<string>;
   roles: CastRole[];
   total_episode_count: number;
   order: number;
@@ -354,7 +350,7 @@ interface AggregateCrew {
   name: string;
   original_name: string;
   popularity: number;
-  profile_path: string;
+  profile_path: Nullable<string>;
   jobs: CrewJob[];
   department: string;
   total_episode_count: number;
@@ -362,7 +358,8 @@ interface AggregateCrew {
 //# sourceMappingURL=credits.d.ts.map
 //#endregion
 //#region src/@types/endpoints/discover.d.ts
-type SortOption = "popularity.asc" | "popularity.desc" | "release_date.asc" | "release_date.desc" | "revenue.asc" | "revenue.desc" | "primary_release_date.asc" | "primary_release_date.desc" | "original_title.asc" | "original_title.desc" | "vote_average.asc" | "vote_average.desc" | "vote_count.asc" | "vote_count.desc";
+type MovieSortOption = "original_title.asc" | "original_title.desc" | "popularity.asc" | "popularity.desc" | "revenue.asc" | "revenue.desc" | "primary_release_date.asc" | "primary_release_date.desc" | "title.asc" | "title.desc" | "vote_average.asc" | "vote_average.desc" | "vote_count.asc" | "vote_count.desc";
+type TvSortOption = "first_air_date.asc" | "first_air_date.desc" | "name.asc" | "name.desc" | "original_name.asc" | "original_name.desc" | "popularity.asc" | "popularity.desc" | "vote_average.asc" | "vote_average.desc" | "vote_count.asc" | "vote_count.desc";
 interface MovieDiscoverResult {
   page: number;
   results: Movie[];
@@ -375,29 +372,31 @@ interface TvShowDiscoverResult {
   total_results: number;
   total_pages: number;
 }
+type WatchMonetizationType = "flatrate" | "free" | "ads" | "rent" | "buy";
 interface DiscoverQueryOptions {
   language?: string;
-  sort_by?: SortOption;
   page?: number;
   "vote_average.gte"?: number;
+  "vote_average.lte"?: number;
   "vote_count.gte"?: number;
   "vote_count.lte"?: number;
-  "vote_average.lte"?: number;
   with_watch_providers?: string;
+  without_watch_providers?: string;
   watch_region?: string;
-  without_companies?: string;
-  with_watch_monetization_types?: "flatrate" | "free" | "ads" | "rent" | "buy";
+  with_watch_monetization_types?: WatchMonetizationType | string;
   "with_runtime.gte"?: number;
   "with_runtime.lte"?: number;
   with_genres?: string;
   without_genres?: string;
-  with_original_language?: string;
-  without_keywords?: string;
   with_keywords?: string;
+  without_keywords?: string;
   with_companies?: string;
+  without_companies?: string;
+  with_original_language?: string;
   with_text_query?: string;
 }
-interface MovieQueryOptions extends DiscoverQueryOptions {
+interface MovieQueryOptions extends Omit<DiscoverQueryOptions, "with_text_query"> {
+  sort_by?: MovieSortOption;
   region?: string;
   certification_country?: string;
   certification?: string;
@@ -410,22 +409,25 @@ interface MovieQueryOptions extends DiscoverQueryOptions {
   "primary_release_date.lte"?: string;
   "release_date.gte"?: string;
   "release_date.lte"?: string;
-  with_release_type?: string;
+  with_release_type?: number | string;
   year?: number;
   with_cast?: string;
   with_crew?: string;
   with_people?: string;
 }
 interface TvShowQueryOptions extends DiscoverQueryOptions {
+  sort_by?: TvSortOption;
   "air_date.gte"?: string;
   "air_date.lte"?: string;
   "first_air_date.gte"?: string;
   "first_air_date.lte"?: string;
   first_air_date_year?: number;
-  timezone?: string;
-  with_networks?: string;
+  include_adult?: boolean;
   include_null_first_air_dates?: boolean;
   screened_theatrically?: boolean;
+  timezone?: string;
+  with_networks?: number | string;
+  with_origin_country?: string;
   with_status?: string;
   with_type?: string;
 }
@@ -473,8 +475,8 @@ interface PageOption {
   page?: number;
 }
 interface ChangeOption extends PageOption {
-  start_date?: Date;
-  end_date?: Date;
+  start_date?: TMDBDate;
+  end_date?: TMDBDate;
 }
 type AppendToResponseMovieKey = "images" | "videos" | "credits" | "recommendations" | "reviews" | "changes" | "similar" | "lists" | "release_dates" | "alternative_titles" | "external_ids" | "translations" | "watch/providers" | "keywords";
 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";
@@ -554,12 +556,12 @@ interface Keywords {
 interface BelongsToCollection {
   id: number;
   name: string;
-  poster_path: string;
-  backdrop_path: string;
+  poster_path: Nullable<string>;
+  backdrop_path: Nullable<string>;
 }
 interface MovieDetails {
   adult: boolean;
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   belongs_to_collection?: BelongsToCollection;
   budget: number;
   genres: Genre[];
@@ -570,7 +572,7 @@ interface MovieDetails {
   original_title: string;
   overview: string;
   popularity: number;
-  poster_path?: string;
+  poster_path: Nullable<string>;
   production_companies: ProductionCompany[];
   production_countries: ProductionCountry[];
   release_date: string;
@@ -595,7 +597,7 @@ declare enum ReleaseDateType {
 interface ReleaseDate {
   certification: string;
   iso_639_1: string;
-  release_date: Date;
+  release_date: TMDBDateTime;
   type: ReleaseDateType;
   note: string;
 }
@@ -621,7 +623,7 @@ interface MovieList {
   iso_639_1: string;
   list_type: string;
   name: string;
-  poster_path: string;
+  poster_path: Nullable<string>;
 }
 interface MovieLists {
   id: number;
@@ -632,7 +634,7 @@ interface MovieLists {
 }
 interface LatestMovie {
   adult: boolean;
-  backdrop_path?: string;
+  backdrop_path: Nullable<string>;
   belongs_to_collection?: BelongsToCollection;
   budget: number;
   genres: Genre[];
@@ -643,7 +645,7 @@ interface LatestMovie {
   original_title: string;
   overview: string;
   popularity: number;
-  poster_path: string;
+  poster_path: Nullable<string>;
   production_companies: ProductionCompany[];
   production_countries: ProductionCountry[];
   release_date: string;
@@ -722,8 +724,8 @@ interface Cast$1 {
   credit_id: string;
   vote_count: number;
   id: number;
-  backdrop_path: string;
-  poster_path: string;
+  backdrop_path: Nullable<string>;
+  poster_path: Nullable<string>;
   original_language: string;
   vote_average: number;
   genre_ids: number[];
@@ -737,8 +739,8 @@ interface Crew$1 {
   credit_id: string;
   overview: string;
   vote_count: number;
-  poster_path: string;
-  backdrop_path: string;
+  poster_path: Nullable<string>;
+  backdrop_path: Nullable<string>;
   popularity: number;
   genre_ids: number[];
   job: string;
@@ -798,14 +800,14 @@ interface PersonDetails {
   biography: string;
   popularity: number;
   place_of_birth: string;
-  profile_path: string;
+  profile_path: Nullable<string>;
   adult: boolean;
   imdb_id: string;
   homepage: string;
 }
 type PersonChangeValue = string | {
   profile: {
-    file_path: string;
+    file_path: Nullable<string>;
   };
 };
 interface PopularPersons {
@@ -820,7 +822,7 @@ interface PeopleImages {
 }
 interface TaggedImage {
   aspect_ratio: number;
-  file_path: string;
+  file_path: Nullable<string>;
   height: number;
   id: string;
   iso_639_1: string;
@@ -839,7 +841,7 @@ interface TaggedImages {
 }
 interface PersonTranslations {
   id: number;
-  translations: {
+  translations: Array<{
     iso_3166_1: string;
     iso_639_1: string;
     name: string;
@@ -847,14 +849,14 @@ interface PersonTranslations {
     data: {
       biography: string;
     };
-  };
+  }>;
 }
 //#endregion
 //#region src/@types/endpoints/review.d.ts
 interface ReviewDetails extends Review {
   iso_639_1: string;
   media_id: number;
-  media_title: number;
+  media_title: string;
   media_type: number;
 }
 //# sourceMappingURL=review.d.ts.map
@@ -980,7 +982,7 @@ interface SeasonDetails {
   name: string;
   overview: string;
   id: number;
-  poster_path: string | null;
+  poster_path: Nullable<string>;
   season_number: number;
 }
 type TvSeasonChangeValue = string | {
@@ -1007,7 +1009,7 @@ interface CreatedBy {
   credit_id: string;
   name: string;
   gender: number;
-  profile_path: string;
+  profile_path: Nullable<string>;
 }
 interface NextEpisodeToAir {
   id: number;
@@ -1021,7 +1023,7 @@ interface NextEpisodeToAir {
   runtime: number;
   season_number: number;
   show_id: number;
-  still_path: string;
+  still_path: Nullable<string>;
 }
 interface LastEpisodeToAir {
   air_date: string;
@@ -1031,14 +1033,14 @@ interface LastEpisodeToAir {
   overview: string;
   production_code: string;
   season_number: number;
-  still_path: string;
+  still_path: Nullable<string>;
   vote_average: number;
   vote_count: number;
 }
 interface Network {
   name: string;
   id: number;
-  logo_path: string;
+  logo_path: Nullable<string>;
   origin_country: string;
 }
 interface Season {
@@ -1047,11 +1049,11 @@ interface Season {
   id: number;
   name: string;
   overview: string;
-  poster_path: string;
+  poster_path: Nullable<string>;
   season_number: number;
 }
 interface TvShowDetails {
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   created_by: CreatedBy[];
   episode_run_time: number[];
   first_air_date: string;
@@ -1072,7 +1074,7 @@ interface TvShowDetails {
   original_name: string;
   overview: string;
   popularity: number;
-  poster_path: string;
+  poster_path: Nullable<string>;
   production_companies: ProductionCompany[];
   production_countries: ProductionCountry[];
   seasons: Season[];
@@ -1085,7 +1087,7 @@ interface TvShowDetails {
 }
 interface Network {
   id: number;
-  logo_path: string;
+  logo_path: Nullable<string>;
   name: string;
   origin_country: string;
 }
@@ -1112,7 +1114,7 @@ interface ScreenedTheatrically {
   results: ScreenedTheatricallyResult[];
 }
 interface SimilarTvShow {
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   first_air_date: string;
   genre_ids: number[];
   id: number;
@@ -1120,7 +1122,7 @@ interface SimilarTvShow {
   original_name: string;
   overview: string;
   origin_country: string[];
-  poster_path: string;
+  poster_path: Nullable<string>;
   popularity: number;
   name: string;
   vote_average: number;
@@ -1133,7 +1135,7 @@ interface Similartv {
   total_results: number;
 }
 interface Latesttv {
-  backdrop_path?: string;
+  backdrop_path: Nullable<string>;
   created_by: CreatedBy[];
   episode_run_time: number[];
   first_air_date: string;
@@ -1152,7 +1154,7 @@ interface Latesttv {
   original_name: string;
   overview?: string;
   popularity: number;
-  poster_path?: string;
+  poster_path: Nullable<string>;
   production_companies: ProductionCompany[];
   seasons: Season[];
   status: string;
@@ -1161,10 +1163,10 @@ interface Latesttv {
   vote_count: number;
 }
 interface OnTheAirResult {
-  poster_path: string;
+  poster_path: Nullable<string>;
   popularity: number;
   id: number;
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   vote_average: number;
   overview: string;
   first_air_date: string;
@@ -1182,10 +1184,10 @@ interface OnTheAir {
   total_pages: number;
 }
 interface AiringTodayResult {
-  poster_path: string;
+  poster_path: Nullable<string>;
   popularity: number;
   id: number;
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   vote_average: number;
   overview: string;
   first_air_date: string;
@@ -1203,10 +1205,10 @@ interface tvAiringToday {
   total_pages: number;
 }
 interface PopularTvShowResult {
-  poster_path: string;
+  poster_path: Nullable<string>;
   popularity: number;
   id: number;
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   vote_average: number;
   overview: string;
   first_air_date: string;
@@ -1224,10 +1226,10 @@ interface Populartv {
   total_pages: number;
 }
 interface TopRatedTvShowResult {
-  poster_path: string;
+  poster_path: Nullable<string>;
   popularity: number;
   id: number;
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   vote_average: number;
   overview: string;
   first_air_date: string;
@@ -1289,297 +1291,59 @@ interface WatchRegion {
 interface WatchRegionsResponse {
   results: WatchRegion[];
 }
-interface WatchLocale {
-  AR: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  AT: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-  };
-  AU: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  BE: {
-    link: string;
-    buy: Buy[];
-    flatrate: Flatrate[];
-    rent: Rent[];
-  };
-  BR: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
-  CA: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  CH: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
-  CL: {
-    link: string;
-    flatrate: Flatrate[];
-    buy: Buy[];
-    rent: Rent[];
-  };
-  CO: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  CZ: {
-    link: string;
-    buy: Buy[];
-    flatrate: Flatrate[];
-    rent: Rent[];
-  };
-  DE: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-  };
-  DK: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
-  EC: {
-    link: string;
-    flatrate: Flatrate[];
-    buy: Buy[];
-    rent: Rent[];
-  };
-  EE: {
-    link: string;
-    flatrate: Flatrate[];
-    buy: Buy[];
-    rent: Rent[];
-  };
-  ES: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  FI: {
-    link: string;
-    buy: Buy[];
-    flatrate: Flatrate[];
-    rent: Rent[];
-  };
-  FR: {
-    link: string;
-    flatrate: Flatrate[];
-    buy: Buy[];
-    rent: Rent[];
-  };
-  GB: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  GR: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  HU: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
-  ID: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  IE: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  IN: {
-    link: string;
-    buy: Buy[];
-    flatrate: Flatrate[];
-    rent: Rent[];
-  };
-  IT: {
-    link: string;
-    buy: Buy[];
-    flatrate: Flatrate[];
-    rent: Rent[];
-  };
-  JP: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  KR: {
-    link: string;
-    buy: Buy[];
-    rent: Rent[];
-    flatrate: Flatrate[];
-  };
-  LT: {
-    link: string;
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
-  LV: {
-    link: string;
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
-  MX: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  MY: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  NL: {
-    link: string;
-    flatrate: Flatrate[];
-    buy: Buy[];
-    rent: Rent[];
-  };
-  NO: {
-    link: string;
-    buy: Buy[];
-    rent: Rent[];
-    flatrate: Flatrate[];
-  };
-  NZ: {
-    link: string;
-    buy: Buy[];
-    rent: Rent[];
-    flatrate: Flatrate[];
-  };
-  PE: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  PH: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
-  PL: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  PT: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  RO: {
-    link: string;
-    flatrate: Flatrate[];
-  };
-  RU: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  SE: {
-    link: string;
-    rent: Rent[];
-    flatrate: Flatrate[];
-    buy: Buy[];
-  };
-  SG: {
-    link: string;
-    flatrate: Flatrate[];
-    buy: Buy[];
-    rent: Rent[];
-  };
-  TH: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  TR: {
-    link: string;
-    buy: Buy[];
-    rent: Rent[];
-    flatrate: Flatrate[];
-  };
-  US: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
-  VE: {
-    link: string;
-    flatrate: Flatrate[];
-    rent: Rent[];
-    buy: Buy[];
-  };
-  ZA: {
-    link: string;
-    rent: Rent[];
-    buy: Buy[];
-    flatrate: Flatrate[];
-  };
+interface WatchProviderEntry {
+  display_priority: number;
+  logo_path: string | null;
+  provider_id: number;
+  provider_name: string;
 }
+type WatchLocale = Record<string, {
+  link: string;
+  flatrate?: WatchProviderEntry[];
+  rent?: WatchProviderEntry[];
+  buy?: WatchProviderEntry[];
+  free?: WatchProviderEntry[];
+  ads?: WatchProviderEntry[];
+}>;
 interface WatchProviders {
   id: number;
   results: WatchLocale;
 }
+interface WatchProviderListItem {
+  display_priority: number;
+  logo_path: string | null;
+  provider_id: number;
+  provider_name: string;
+}
+interface WatchProviderListResponse {
+  results: WatchProviderListItem[];
+}
 //# sourceMappingURL=watchProviders.d.ts.map
 //#endregion
 //#region src/utils/api.d.ts
+type Primitive = string | number | boolean;
+type QueryValue = Primitive | null | undefined | Array<Primitive | null | undefined>;
+type Query = Record<string, QueryValue>;
+interface RequestOptions<Q extends object = object> {
+  query?: Q;
+  signal?: AbortSignal;
+  timeoutMs?: number;
+  retries?: number;
+  retryDelayMs?: number;
+}
+declare class TMDBError extends Error {
+  readonly status: number;
+  readonly url: string;
+  readonly payload?: unknown | undefined;
+  constructor(message: string, status: number, url: string, payload?: unknown | undefined);
+}
+declare const parseOptions: (options?: Query) => string;
 declare class API {
   private apiKey?;
   private accessToken?;
   constructor(auth: TokenType);
-  /**
-   * Generic GET:
-   * @template T — response type
-   * @template O — options (query params) type
-   */
-  get<T, O extends Record<string, unknown> = Record<string, unknown>>(path: string, options?: O): Promise<T>;
+  get<T, Q extends object = object>(path: string, opts?: RequestOptions<Q>): Promise<T>;
 }
-declare const parseOptions: (options?: Record<string, unknown>) => string;
 //# sourceMappingURL=api.d.ts.map
 //#endregion
 //#region src/utils/getimagePath.d.ts
@@ -1643,7 +1407,7 @@ interface PersonWithMediaType extends Person {
 }
 interface Movie {
   id: number;
-  poster_path: string;
+  poster_path: Nullable<string>;
   adult: boolean;
   overview: string;
   release_date: string;
@@ -1651,7 +1415,7 @@ interface Movie {
   original_title: string;
   original_language: string;
   title: string;
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   popularity: number;
   vote_count: number;
   video: boolean;
@@ -1670,13 +1434,13 @@ interface TV {
   id: number;
   name: string;
   first_air_date: string;
-  backdrop_path: string;
+  backdrop_path: Nullable<string>;
   genre_ids: number[];
   origin_country: string[];
   original_language: string;
   original_name: string;
   overview: string;
-  poster_path: string;
+  poster_path: Nullable<string>;
   popularity: number;
   vote_count: number;
   vote_average: number;
@@ -1745,9 +1509,9 @@ interface Review {
   author: string;
   author_details: AuthorDetails;
   content: string;
-  created_at: Date;
+  created_at: TMDBDateTime;
   id: string;
-  updated_at: Date;
+  updated_at: TMDBDateTime;
   url: string;
 }
 interface Reviews {
@@ -1796,9 +1560,24 @@ type TokenType = string | TMDBConfig;
 //# sourceMappingURL=types.d.ts.map
 //#endregion
 //#region src/@types/models/baseEndpoint.d.ts
+/**
+ * Base class for all TMDB API endpoints.
+ *
+ * Provides a configured {@link API} client instance to subclasses.
+ */
 declare class BaseEndpoint {
   protected readonly auth: TokenType;
-  protected api: API;
+  /**
+   * Low-level HTTP client wrapper used by all endpoints.
+   */
+  protected readonly api: API;
+  /**
+   * Create a new endpoint instance.
+   *
+   * @param {TokenType} auth - Authentication information.
+   * - If a string: treated as a v4 API Read Access Token (Bearer token).
+   * - If an object: can include an API key and/or access token.
+   */
   constructor(auth: TokenType);
 }
 //# sourceMappingURL=baseEndpoint.d.ts.map
@@ -1806,40 +1585,64 @@ declare class BaseEndpoint {
 //#region src/endpoints/account.d.ts
 /**
  * Represents an endpoint for retrieving account details.
+ *
+ * TMDB v3 reference:
+ * - GET /account/{account_id}
+ *
+ * Note:
+ * TMDB does not expose a generic "GET /account" for account details. You must
+ * provide an `account_id`. Most apps obtain it from an auth flow and then cache
+ * it for subsequent requests.
  */
 declare class AccountEndpoint extends BaseEndpoint {
   protected readonly access_token: TokenType;
   /**
    * Constructs a new AccountEndpoint instance.
-   * @param {string} access_token - The access token used for authentication.
+   *
+   * @param {TokenType} access_token - The access token used for authentication.
    */
   constructor(access_token: TokenType);
   /**
    * Retrieves account details asynchronously.
+   *
+   * TMDB: GET /account/{account_id}
+   *
+   * @param {number} accountId - The TMDB account ID.
    * @returns {Promise<AccountDetails>} A Promise that resolves with the account details.
    */
-  details(): Promise<AccountDetails>;
+  details(accountId: number): Promise<AccountDetails>;
 }
 //# sourceMappingURL=account.d.ts.map
 //#endregion
 //#region src/endpoints/certification.d.ts
 /**
  * Represents an endpoint for retrieving certifications for movies and TV shows.
+ *
+ * TMDB v3 reference:
+ * - GET /certification/movie/list
+ * - GET /certification/tv/list
  */
 declare class CertificationEndpoint extends BaseEndpoint {
   protected readonly access_token: TokenType;
   /**
    * Constructs a new CertificationEndpoint instance.
-   * @param {string} access_token - The access token used for authentication.
+   *
+   * @param {TokenType} access_token - The access token used for authentication.
    */
   constructor(access_token: TokenType);
   /**
    * Retrieves certifications for movies asynchronously.
+   *
+   * TMDB: GET /certification/movie/list
+   *
    * @returns {Promise<Certifications>} A Promise that resolves with the certifications for movies.
    */
   movies(): Promise<Certifications>;
   /**
    * Retrieves certifications for TV shows asynchronously.
+   *
+   * TMDB: GET /certification/tv/list
+   *
    * @returns {Promise<Certifications>} A Promise that resolves with the certifications for TV shows.
    */
   tv(): Promise<Certifications>;
@@ -1849,28 +1652,43 @@ declare class CertificationEndpoint extends BaseEndpoint {
 //#region src/endpoints/changes.d.ts
 /**
  * Represents an endpoint for retrieving changes in movies, TV shows, and persons.
+ *
+ * TMDB v3 reference:
+ * - GET /movie/changes
+ * - GET /tv/changes
+ * - GET /person/changes
  */
 declare class ChangeEndpoint extends BaseEndpoint {
   protected readonly access_token: TokenType;
   /**
    * Constructs a new ChangeEndpoint instance.
-   * @param {string} access_token - The access token used for authentication.
+   *
+   * @param {TokenType} access_token - The access token used for authentication.
    */
   constructor(access_token: TokenType);
   /**
    * Retrieves changes in movies asynchronously.
+   *
+   * TMDB: GET /movie/changes
+   *
    * @param {ChangeOption} [options] - Optional parameters for filtering the changes.
    * @returns {Promise<MediaChanges>} A Promise that resolves with the changes in movies.
    */
   movies(options?: ChangeOption): Promise<MediaChanges>;
   /**
    * Retrieves changes in TV shows asynchronously.
+   *
+   * TMDB: GET /tv/changes
+   *
    * @param {ChangeOption} [options] - Optional parameters for filtering the changes.
    * @returns {Promise<MediaChanges>} A Promise that resolves with the changes in TV shows.
    */
   tv(options?: ChangeOption): Promise<MediaChanges>;
   /**
    * Retrieves changes related to persons asynchronously.
+   *
+   * TMDB: GET /person/changes
+   *
    * @param {ChangeOption} [options] - Optional parameters for filtering the changes.
    * @returns {Promise<MediaChanges>} A Promise that resolves with the changes related to persons.
    */
@@ -1987,22 +1805,33 @@ declare class CreditsEndpoint extends BaseEndpoint {
 //#region src/endpoints/discover.d.ts
 /**
  * Represents an endpoint for discovering movies and TV shows based on various criteria.
+ *
+ * TMDB v3 reference:
+ * - GET /discover/movie
+ * - GET /discover/tv
  */
 declare class DiscoverEndpoint extends BaseEndpoint {
   protected readonly access_token: TokenType;
   /**
    * Constructs a new DiscoverEndpoint instance.
-   * @param {string} access_token - The access token used for authentication.
+   *
+   * @param {TokenType} access_token - The access token used for authentication.
    */
   constructor(access_token: TokenType);
   /**
    * Retrieves a list of movies based on the provided query options asynchronously.
+   *
+   * TMDB: GET /discover/movie
+   *
    * @param {MovieQueryOptions} [options] - Optional parameters for refining the movie discovery.
    * @returns {Promise<MovieDiscoverResult>} A Promise that resolves with the movie discovery results.
    */
   movie(options?: MovieQueryOptions): Promise<MovieDiscoverResult>;
   /**
    * Retrieves a list of TV shows based on the provided query options asynchronously.
+   *
+   * TMDB: GET /discover/tv
+   *
    * @param {TvShowQueryOptions} [options] - Optional parameters for refining the TV show discovery.
    * @returns {Promise<TvShowDiscoverResult>} A Promise that resolves with the TV show discovery results.
    */
@@ -2758,26 +2587,21 @@ declare class WatchProvidersEndpoint extends BaseEndpoint {
    * @param {string} access_token - The access token used for authentication.
    */
   constructor(access_token: TokenType);
-  /**
-   * Retrieves a list of all available watch providers (streaming services).
-   * @returns {Promise<WatchProviders>} A Promise that resolves with the list of watch providers.
-   */
-  available(): Promise<WatchProviders>;
-  /**
-   * Retrieves a list of available regions for watch providers.
-   * @returns {Promise<WatchRegionsResponse>} A Promise that resolves with the list of available regions.
-   */
-  regions(): Promise<WatchRegionsResponse>;
   /**
    * Retrieves a list of watch providers for movies.
-   * @returns {Promise<WatchProviders>} A Promise that resolves with the list of movie watch providers.
+   * @returns {Promise<WatchProviderListResponse>} A Promise that resolves with the list of movie watch providers.
    */
-  movie(): Promise<WatchProviders>;
+  movie(): Promise<WatchProviderListResponse>;
   /**
    * Retrieves a list of watch providers for TV shows.
-   * @returns {Promise<WatchProviders>} A Promise that resolves with the list of TV watch providers.
+   * @returns {Promise<WatchProviderListResponse>} A Promise that resolves with the list of TV watch providers.
+   */
+  tv(): Promise<WatchProviderListResponse>;
+  /**
+   * Retrieves a list of available regions for watch providers.
+   * @returns {Promise<WatchProviderListResponse>} A Promise that resolves with the list of available regions.
    */
-  tv(): Promise<WatchProviders>;
+  regions(): Promise<WatchProviderListResponse>;
 }
 //# sourceMappingURL=watchProviders.d.ts.map
 //#endregion
@@ -2807,5 +2631,5 @@ declare class TMDB {
   watchProviders: WatchProvidersEndpoint;
 }
 //#endregion
-export { API, AccountDetails, AggregateCast, AggregateCredits, AggregateCrew, AiringTodayResult, AlternativeNames, AlternativeTitles, AppendToResponse, AppendToResponseMediaType, AppendToResponseMovieKey, AppendToResponsePersonKey, AppendToResponseTvEpisodeKey, AppendToResponseTvKey, AppendToResponseTvSeasonKey, AuthorDetails, Avatar, BackdropSizes, BaseEndpoint, BelongingMovies, BelongsToCollection, Buy, Cast, CastRole, Certification, Certifications, Change, ChangeItem, ChangeKeys, ChangeOption, Changes, Collection, CollectionImageOptions, CollectionSearchOptions, Company, CompanyDetails, CompanyImages, Configuration, ContentRatings, ContentRatingsResult, CreatedBy, CreditResponse, CreditSeason, Credits, Crew, CrewJob, Dates, DetailedCollection, DiscoverQueryOptions, Episode, EpisodeGroup, EpisodeGroups, EpisodeSelection, ErrorResponse, ExternalIdOptions, ExternalIds, ExternalSource, FindResult, Flatrate, Genre, Genres, Gravatar, GuestStar, Image, ImageCollection, ImageConfiguration, ImageFormat, ImageFormats, ImageSize, ImageSizes, Images, Keyword, Keywords, KeywordsOptions, KnownFor, LanguageOption, LastEpisodeToAir, LatestMovie, Latesttv, LogoSizes, Media$1 as Media, MediaChange, MediaChanges, MediaType, Movie, MovieChangeValue, MovieDetails, MovieDiscoverResult, MovieList, MovieLists, MovieQueryOptions, MovieSearchOptions, MovieWithMediaType, MoviesImageSearchOptions, MoviesPlayingNow, MultiSearchOptions, MultiSearchResult, Name, Network, NetworkDetails, NetworkImages, NextEpisodeToAir, OnTheAir, OnTheAirResult, PageOption, ParentCompany, PeopleImages, PeopleSearchOptions, Person, PersonChangeValue, PersonCombinedCredits, PersonDetails, PersonMovieCast, PersonMovieCredit, PersonMovieCrew, PersonTranslations, PersonTvShowCast, PersonTvShowCredit, PersonTvShowCrew, PersonWithMediaType, PopularMovies, PopularPersons, PopularTvShowResult, Populartv, PosterSizes, ProductionCompany, ProductionCountry, ProfileSizes, Recommendation, Recommendations, RegionOption, ReleaseDate, ReleaseDateResult, ReleaseDateType, ReleaseDates, Rent, Review, ReviewDetails, Reviews, ScreenedTheatrically, ScreenedTheatricallyResult, Search, SearchOptions, Season, SeasonDetails, SeasonSelection, SimilarMovies, SimilarTvShow, Similartv, SortOption, SpokenLanguage, StillSizes, TMDB, TMDBConfig, TMDB_IMAGE_BASE_URL, TV, TVWithMediaType, TaggedImage, TaggedImages, TimeWindow, TimezoneOption, Title, TokenType, TopRatedMovies, TopRatedTvShowResult, TopRatedtv, Translation, TranslationData, Translations, TrendingMediaType, TrendingResults, TvEpisodeChangeValue, TvEpisodeCredit, TvEpisodeImageSearchOptions, TvEpisodeTranslations, TvEpisodeVideoSearchOptions, TvSearchOptions, TvSeasonChangeValue, TvSeasonImageSearchOptions, TvSeasonVideoSearchOptions, TvShowChangeValue, TvShowDetails, TvShowDiscoverResult, TvShowImageOptions, TvShowQueryOptions, TvShowVideoOptions, UpcomingMovies, Video, Videos, WatchLocale, WatchProviders, WatchRegion, WatchRegionsResponse, formImage, getFullImagePath, parseOptions, tvAiringToday };
+export { API, AccountDetails, AggregateCast, AggregateCredits, AggregateCrew, AiringTodayResult, AlternativeNames, AlternativeTitles, AppendToResponse, AppendToResponseMediaType, AppendToResponseMovieKey, AppendToResponsePersonKey, AppendToResponseTvEpisodeKey, AppendToResponseTvKey, AppendToResponseTvSeasonKey, AuthorDetails, Avatar, BackdropSizes, BaseEndpoint, BelongingMovies, BelongsToCollection, Buy, Cast, CastRole, Certification, Certifications, Change, ChangeItem, ChangeKeys, ChangeOption, Changes, Collection, CollectionImageOptions, CollectionSearchOptions, Company, CompanyDetails, CompanyImages, Configuration, ContentRatings, ContentRatingsResult, CreatedBy, CreditResponse, CreditSeason, Credits, Crew, CrewJob, Dates, DetailedCollection, DiscoverQueryOptions, Episode, EpisodeGroup, EpisodeGroups, EpisodeSelection, ErrorResponse, ExternalIdOptions, ExternalIds, ExternalSource, FindResult, Flatrate, Genre, Genres, Gravatar, GuestStar, Image, ImageCollection, ImageConfiguration, ImageFormat, ImageFormats, ImageSize, ImageSizes, Images, Keyword, Keywords, KeywordsOptions, KnownFor, LanguageOption, LastEpisodeToAir, LatestMovie, Latesttv, LogoSizes, Media$1 as Media, MediaChange, MediaChanges, MediaType, Movie, MovieChangeValue, MovieDetails, MovieDiscoverResult, MovieList, MovieLists, MovieQueryOptions, MovieSearchOptions, MovieSortOption, MovieWithMediaType, MoviesImageSearchOptions, MoviesPlayingNow, MultiSearchOptions, MultiSearchResult, Name, Network, NetworkDetails, NetworkImages, NextEpisodeToAir, OnTheAir, OnTheAirResult, PageOption, ParentCompany, PeopleImages, PeopleSearchOptions, Person, PersonChangeValue, PersonCombinedCredits, PersonDetails, PersonMovieCast, PersonMovieCredit, PersonMovieCrew, PersonTranslations, PersonTvShowCast, PersonTvShowCredit, PersonTvShowCrew, PersonWithMediaType, PopularMovies, PopularPersons, PopularTvShowResult, Populartv, PosterSizes, Primitive, ProductionCompany, ProductionCountry, ProfileSizes, Query, QueryValue, Recommendation, Recommendations, RegionOption, ReleaseDate, ReleaseDateResult, ReleaseDateType, ReleaseDates, Rent, RequestOptions, Review, ReviewDetails, Reviews, ScreenedTheatrically, ScreenedTheatricallyResult, Search, SearchOptions, Season, SeasonDetails, SeasonSelection, SimilarMovies, SimilarTvShow, Similartv, SpokenLanguage, StillSizes, TMDB, TMDBConfig, TMDBError, TMDB_IMAGE_BASE_URL, TV, TVWithMediaType, TaggedImage, TaggedImages, TimeWindow, TimezoneOption, Title, TokenType, TopRatedMovies, TopRatedTvShowResult, TopRatedtv, Translation, TranslationData, Translations, TrendingMediaType, TrendingResults, TvEpisodeChangeValue, TvEpisodeCredit, TvEpisodeImageSearchOptions, TvEpisodeTranslations, TvEpisodeVideoSearchOptions, TvSearchOptions, TvSeasonChangeValue, TvSeasonImageSearchOptions, TvSeasonVideoSearchOptions, TvShowChangeValue, TvShowDetails, TvShowDiscoverResult, TvShowImageOptions, TvShowQueryOptions, TvShowVideoOptions, TvSortOption, UpcomingMovies, Video, Videos, WatchLocale, WatchMonetizationType, WatchProviderEntry, WatchProviderListItem, WatchProviderListResponse, WatchProviders, WatchRegion, WatchRegionsResponse, formImage, getFullImagePath, parseOptions, tvAiringToday };
 //# sourceMappingURL=index.d.mts.map