@lorenzopant/tmdb 1.8.0 → 1.10.0

package/dist/endpoints/find.d.ts

@@ -0,0 +1,17 @@
+import { FindByIDParams, FindResults } from "../types";
+import { TMDBAPIBase } from "./base";
+export declare class FindAPI extends TMDBAPIBase {
+    /**
+     * By ID
+     * GET - https://api.themoviedb.org/3/find/{external_id}
+     *
+     * Find movies, TV series, seasons, episodes, or people by an external ID.
+     *
+     * @param external_id External identifier to look up
+     * @param external_source Source namespace for the external ID
+     * @param language Language for localized results
+     * @reference https://developer.themoviedb.org/reference/find-by-id
+     */
+    by_id(params: FindByIDParams): Promise<FindResults>;
+}
+//# sourceMappingURL=find.d.ts.map

package/dist/endpoints/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/endpoints/find.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,OAAQ,SAAQ,WAAW;IACvC;;;;;;;;;;OAUG;IACG,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;CAMzD"}

package/dist/endpoints/find.js

@@ -0,0 +1,21 @@
+import { ENDPOINTS } from "../routes";
+import { TMDBAPIBase } from "./base";
+export class FindAPI extends TMDBAPIBase {
+    /**
+     * By ID
+     * GET - https://api.themoviedb.org/3/find/{external_id}
+     *
+     * Find movies, TV series, seasons, episodes, or people by an external ID.
+     *
+     * @param external_id External identifier to look up
+     * @param external_source Source namespace for the external ID
+     * @param language Language for localized results
+     * @reference https://developer.themoviedb.org/reference/find-by-id
+     */
+    async by_id(params) {
+        const { external_id, ...rest } = params;
+        const endpoint = `${ENDPOINTS.FIND}/${encodeURIComponent(external_id)}`;
+        const requestParams = this.withLanguage(rest);
+        return this.client.request(endpoint, requestParams);
+    }
+}

package/dist/endpoints/keywords.d.ts

@@ -0,0 +1,30 @@
+import { Keyword, KeywordDetailsParams, KeywordMoviesParams, MovieResultItem, PaginatedResponse } from "../types";
+import { TMDBAPIBase } from "./base";
+export declare class KeywordsAPI extends TMDBAPIBase {
+    private keywordPath;
+    /**
+     * Details
+     * GET - https://api.themoviedb.org/3/keyword/{keyword_id}
+     *
+     * Get the details of a keyword by ID.
+     *
+     * @param keyword_id Unique identifier for the keyword
+     * @reference https://developer.themoviedb.org/reference/keyword-details
+     */
+    details(params: KeywordDetailsParams): Promise<Keyword>;
+    /**
+     * Movies
+     * GET - https://api.themoviedb.org/3/keyword/{keyword_id}/movies
+     *
+     * Get the movies associated with a keyword.
+     *
+     * @deprecated TMDB marks this endpoint as deprecated. Use discover/movie with_keywords instead.
+     * @param keyword_id Unique identifier for the keyword
+     * @param language Language for localized results
+     * @param page Page number for paginated results
+     * @param include_adult Include adult titles in results
+     * @reference https://developer.themoviedb.org/reference/keyword-movies
+     */
+    movies(params: KeywordMoviesParams): Promise<PaginatedResponse<MovieResultItem>>;
+}
+//# sourceMappingURL=keywords.d.ts.map

package/dist/endpoints/keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywords.d.ts","sourceRoot":"","sources":["../../src/endpoints/keywords.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,WAAY,SAAQ,WAAW;IAC3C,OAAO,CAAC,WAAW;IAInB;;;;;;;;OAQG;IACG,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7D;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;CAKtF"}

package/dist/endpoints/keywords.js

@@ -0,0 +1,38 @@
+import { ENDPOINTS } from "../routes";
+import { TMDBAPIBase } from "./base";
+export class KeywordsAPI extends TMDBAPIBase {
+    keywordPath(keyword_id) {
+        return `${ENDPOINTS.KEYWORDS.DETAILS}/${keyword_id}`;
+    }
+    /**
+     * Details
+     * GET - https://api.themoviedb.org/3/keyword/{keyword_id}
+     *
+     * Get the details of a keyword by ID.
+     *
+     * @param keyword_id Unique identifier for the keyword
+     * @reference https://developer.themoviedb.org/reference/keyword-details
+     */
+    async details(params) {
+        const endpoint = this.keywordPath(params.keyword_id);
+        return this.client.request(endpoint, params);
+    }
+    /**
+     * Movies
+     * GET - https://api.themoviedb.org/3/keyword/{keyword_id}/movies
+     *
+     * Get the movies associated with a keyword.
+     *
+     * @deprecated TMDB marks this endpoint as deprecated. Use discover/movie with_keywords instead.
+     * @param keyword_id Unique identifier for the keyword
+     * @param language Language for localized results
+     * @param page Page number for paginated results
+     * @param include_adult Include adult titles in results
+     * @reference https://developer.themoviedb.org/reference/keyword-movies
+     */
+    async movies(params) {
+        const endpoint = `${this.keywordPath(params.keyword_id)}${ENDPOINTS.KEYWORDS.MOVIES}`;
+        const requestParams = this.withLanguage(params);
+        return this.client.request(endpoint, requestParams);
+    }
+}

package/dist/endpoints/watch_providers.d.ts

@@ -0,0 +1,35 @@
+import { WatchProviderListParams, WatchProviderListResponse, WatchProviderRegionsParams, WatchProviderRegionsResponse } from "../types";
+import { TMDBAPIBase } from "./base";
+export declare class WatchProvidersAPI extends TMDBAPIBase {
+    /**
+     * Movie Providers
+     * GET - https://api.themoviedb.org/3/watch/providers/movie
+     *
+     * Get the list of movie watch providers supported by TMDB.
+     *
+     * @param language Language used for localized provider names
+     * @reference https://developer.themoviedb.org/reference/watch-provider-movie-list
+     */
+    movie_providers(params?: WatchProviderListParams): Promise<WatchProviderListResponse>;
+    /**
+     * TV Providers
+     * GET - https://api.themoviedb.org/3/watch/providers/tv
+     *
+     * Get the list of TV watch providers supported by TMDB.
+     *
+     * @param language Language used for localized provider names
+     * @reference https://developer.themoviedb.org/reference/watch-provider-tv-list
+     */
+    tv_providers(params?: WatchProviderListParams): Promise<WatchProviderListResponse>;
+    /**
+     * Available Regions
+     * GET - https://api.themoviedb.org/3/watch/providers/regions
+     *
+     * Get the list of regions with watch provider support.
+     *
+     * @param language Language used for localized region names
+     * @reference https://developer.themoviedb.org/reference/watch-providers-available-regions
+     */
+    available_regions(params?: WatchProviderRegionsParams): Promise<WatchProviderRegionsResponse>;
+}
+//# sourceMappingURL=watch_providers.d.ts.map

package/dist/endpoints/watch_providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch_providers.d.ts","sourceRoot":"","sources":["../../src/endpoints/watch_providers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AACxI,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,iBAAkB,SAAQ,WAAW;IACjD;;;;;;;;OAQG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAM3F;;;;;;;;OAQG;IACG,YAAY,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAMxF;;;;;;;;OAQG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,4BAA4B,CAAC;CAKnG"}

package/dist/endpoints/watch_providers.js

@@ -0,0 +1,46 @@
+import { ENDPOINTS } from "../routes";
+import { TMDBAPIBase } from "./base";
+export class WatchProvidersAPI extends TMDBAPIBase {
+    /**
+     * Movie Providers
+     * GET - https://api.themoviedb.org/3/watch/providers/movie
+     *
+     * Get the list of movie watch providers supported by TMDB.
+     *
+     * @param language Language used for localized provider names
+     * @reference https://developer.themoviedb.org/reference/watch-provider-movie-list
+     */
+    async movie_providers(params) {
+        const language = params?.language ?? this.defaultOptions.language;
+        const requestParams = language === undefined ? params : { ...params, language };
+        return this.client.request(ENDPOINTS.WATCH_PROVIDERS.MOVIE, requestParams);
+    }
+    /**
+     * TV Providers
+     * GET - https://api.themoviedb.org/3/watch/providers/tv
+     *
+     * Get the list of TV watch providers supported by TMDB.
+     *
+     * @param language Language used for localized provider names
+     * @reference https://developer.themoviedb.org/reference/watch-provider-tv-list
+     */
+    async tv_providers(params) {
+        const language = params?.language ?? this.defaultOptions.language;
+        const requestParams = language === undefined ? params : { ...params, language };
+        return this.client.request(ENDPOINTS.WATCH_PROVIDERS.TV, requestParams);
+    }
+    /**
+     * Available Regions
+     * GET - https://api.themoviedb.org/3/watch/providers/regions
+     *
+     * Get the list of regions with watch provider support.
+     *
+     * @param language Language used for localized region names
+     * @reference https://developer.themoviedb.org/reference/watch-providers-available-regions
+     */
+    async available_regions(params) {
+        const language = params?.language ?? this.defaultOptions.language;
+        const requestParams = language === undefined ? params : { ...params, language };
+        return this.client.request(ENDPOINTS.WATCH_PROVIDERS.REGIONS, requestParams);
+    }
+}

package/dist/routes.d.ts

@@ -20,6 +20,7 @@ export declare const ENDPOINTS: {
         MOVIE: string;
         TV: string;
     };
+    FIND: string;
     CREDITS: {
         DETAILS: string;
     };
@@ -37,6 +38,10 @@ export declare const ENDPOINTS: {
         MOVIE_LIST: string;
         TV_LIST: string;
     };
+    KEYWORDS: {
+        DETAILS: string;
+        MOVIES: string;
+    };
     MOVIES: {
         DETAILS: string;
         ALTERNATIVE_TITLES: string;
@@ -92,5 +97,10 @@ export declare const ENDPOINTS: {
         VIDEOS: string;
         WATCH_PROVIDERS: string;
     };
+    WATCH_PROVIDERS: {
+        MOVIE: string;
+        TV: string;
+        REGIONS: string;
+    };
 };
 //# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FrB,CAAC"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGrB,CAAC"}

package/dist/routes.js

@@ -20,6 +20,7 @@ export const ENDPOINTS = {
         MOVIE: "/discover/movie",
         TV: "/discover/tv",
     },
+    FIND: "/find",
     CREDITS: {
         DETAILS: "/credit",
     },
@@ -37,6 +38,10 @@ export const ENDPOINTS = {
         MOVIE_LIST: "/genre/movie/list",
         TV_LIST: "/genre/tv/list",
     },
+    KEYWORDS: {
+        DETAILS: "/keyword",
+        MOVIES: "/movies",
+    },
     MOVIES: {
         DETAILS: "/movie",
         ALTERNATIVE_TITLES: "/alternative_titles",
@@ -92,4 +97,9 @@ export const ENDPOINTS = {
         VIDEOS: "/videos",
         WATCH_PROVIDERS: "/watch/providers",
     },
+    WATCH_PROVIDERS: {
+        MOVIE: "/watch/providers/movie",
+        TV: "/watch/providers/tv",
+        REGIONS: "/watch/providers/regions",
+    },
 };

package/dist/tmdb.d.ts

@@ -5,12 +5,15 @@ import { CreditsAPI } from "./endpoints/credits";
 import { CollectionsAPI } from "./endpoints/collections";
 import { ConfigurationAPI } from "./endpoints/configuration";
 import { DiscoverAPI } from "./endpoints/discover";
+import { FindAPI } from "./endpoints/find";
 import { GenresAPI } from "./endpoints/genres";
+import { KeywordsAPI } from "./endpoints/keywords";
 import { MovieListsAPI } from "./endpoints/movie_lists";
 import { MoviesAPI } from "./endpoints/movies";
 import { SearchAPI } from "./endpoints/search";
 import { TVSeriesAPI } from "./endpoints/tv_series";
 import { TVSeriesListsAPI } from "./endpoints/tv_series_lists";
+import { WatchProvidersAPI } from "./endpoints/watch_providers";
 import { ImageAPI } from "./images/images";
 import { TMDBOptions } from "./types/config";
 export declare class TMDB {
@@ -22,14 +25,17 @@ export declare class TMDB {
     images: ImageAPI;
     configuration: ConfigurationAPI;
     genres: GenresAPI;
+    keywords: KeywordsAPI;
     tv_lists: TVSeriesListsAPI;
     tv_series: TVSeriesAPI;
+    watch_providers: WatchProvidersAPI;
     certifications: CertificationsAPI;
     changes: ChangesAPI;
     companies: CompaniesAPI;
     credits: CreditsAPI;
     collections: CollectionsAPI;
     discover: DiscoverAPI;
+    find: FindAPI;
     /**
      * Creates a new TMDB instance.
      * @param accessToken The TMDB API access token.

package/dist/tmdb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tmdb.d.ts","sourceRoot":"","sources":["../src/tmdb.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAa,IAAI;IAChB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAc;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,aAAa,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC;IACjB,aAAa,EAAE,gBAAgB,CAAC;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,WAAW,CAAC;IACvB,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,QAAQ,EAAE,WAAW,CAAC;IAG7B;;;;OAIG;gBACS,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB;CAmB1D"}
+{"version":3,"file":"tmdb.d.ts","sourceRoot":"","sources":["../src/tmdb.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAa,IAAI;IAChB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAc;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,aAAa,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC;IACjB,aAAa,EAAE,gBAAgB,CAAC;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,EAAE,iBAAiB,CAAC;IACnC,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IAGrB;;;;OAIG;gBACS,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB;CAsB1D"}

package/dist/tmdb.js

@@ -7,12 +7,15 @@ import { CreditsAPI } from "./endpoints/credits";
 import { CollectionsAPI } from "./endpoints/collections";
 import { ConfigurationAPI } from "./endpoints/configuration";
 import { DiscoverAPI } from "./endpoints/discover";
+import { FindAPI } from "./endpoints/find";
 import { GenresAPI } from "./endpoints/genres";
+import { KeywordsAPI } from "./endpoints/keywords";
 import { MovieListsAPI } from "./endpoints/movie_lists";
 import { MoviesAPI } from "./endpoints/movies";
 import { SearchAPI } from "./endpoints/search";
 import { TVSeriesAPI } from "./endpoints/tv_series";
 import { TVSeriesListsAPI } from "./endpoints/tv_series_lists";
+import { WatchProvidersAPI } from "./endpoints/watch_providers";
 import { Errors } from "./errors/messages";
 import { ImageAPI } from "./images/images";
 export class TMDB {
@@ -24,14 +27,17 @@ export class TMDB {
     images;
     configuration;
     genres;
+    keywords;
     tv_lists;
     tv_series;
+    watch_providers;
     certifications;
     changes;
     companies;
     credits;
     collections;
     discover;
+    find;
     // etc...
     /**
      * Creates a new TMDB instance.
@@ -49,13 +55,16 @@ export class TMDB {
         this.images = new ImageAPI(this.options.images);
         this.configuration = new ConfigurationAPI(this.client, this.options);
         this.genres = new GenresAPI(this.client, this.options);
+        this.keywords = new KeywordsAPI(this.client, this.options);
         this.tv_lists = new TVSeriesListsAPI(this.client, this.options);
         this.tv_series = new TVSeriesAPI(this.client, this.options);
+        this.watch_providers = new WatchProvidersAPI(this.client, this.options);
         this.certifications = new CertificationsAPI(this.client, this.options);
         this.changes = new ChangesAPI(this.client, this.options);
         this.companies = new CompaniesAPI(this.client, this.options);
         this.credits = new CreditsAPI(this.client, this.options);
         this.collections = new CollectionsAPI(this.client, this.options);
         this.discover = new DiscoverAPI(this.client, this.options);
+        this.find = new FindAPI(this.client, this.options);
     }
 }

package/dist/types/other/find.d.ts

@@ -0,0 +1,104 @@
+import { CountryISO3166_1 } from "../config";
+import { Language } from "../config/languages";
+import { LiteralUnion } from "../utility";
+/**
+ * External source values accepted by TMDB's find-by-id endpoint.
+ * @reference https://developer.themoviedb.org/reference/find-by-id
+ */
+export type FindExternalSource = LiteralUnion<"imdb_id" | "tvdb_id" | "freebase_mid" | "freebase_id" | "tvrage_id" | "facebook_id" | "instagram_id" | "twitter_id">;
+/**
+ * Parameters for TMDB's find-by-id endpoint.
+ * `external_id` is sent in the request path and `external_source` as a query param.
+ */
+export type FindByIDParams = {
+    external_id: string;
+    external_source: FindExternalSource;
+    language?: Language;
+};
+type FindMediaResultBase = {
+    adult: boolean;
+    backdrop_path: string | null;
+    id: number;
+    original_language: string;
+    overview: string;
+    poster_path: string | null;
+    popularity: number;
+    vote_average: number;
+    vote_count: number;
+};
+/**
+ * Movie item returned inside `movie_results`.
+ */
+export type FindMovieResultItem = FindMediaResultBase & {
+    media_type: "movie";
+    original_title: string;
+    release_date: string;
+    title: string;
+    video: boolean;
+};
+/**
+ * Person item returned inside `person_results`.
+ */
+export type FindPersonResultItem = {
+    adult: boolean;
+    gender: number | null;
+    id: number;
+    known_for_department: string;
+    media_type: "person";
+    name: string;
+    original_name: string;
+    popularity: number;
+    profile_path: string | null;
+};
+/**
+ * TV series item returned inside `tv_results`.
+ */
+export type FindTVResultItem = FindMediaResultBase & {
+    media_type: "tv";
+    first_air_date: string;
+    name: string;
+    origin_country: CountryISO3166_1[];
+    original_name: string;
+};
+/**
+ * TV episode item returned inside `tv_episode_results`.
+ */
+export type FindTVEpisodeResultItem = {
+    air_date: string;
+    episode_number: number;
+    id: number;
+    media_type: "tv_episode";
+    name: string;
+    overview: string;
+    production_code: string;
+    season_number: number;
+    show_id: number;
+    still_path: string | null;
+    vote_average: number;
+    vote_count: number;
+};
+/**
+ * TV season item returned inside `tv_season_results`.
+ */
+export type FindTVSeasonResultItem = {
+    air_date: string;
+    episode_count: number;
+    id: number;
+    media_type: "tv_season";
+    name: string;
+    overview: string;
+    poster_path: string | null;
+    season_number: number;
+};
+/**
+ * Response returned by TMDB's find-by-id endpoint.
+ */
+export type FindResults = {
+    movie_results: FindMovieResultItem[];
+    person_results: FindPersonResultItem[];
+    tv_results: FindTVResultItem[];
+    tv_episode_results: FindTVEpisodeResultItem[];
+    tv_season_results: FindTVSeasonResultItem[];
+};
+export {};
+//# sourceMappingURL=find.d.ts.map

package/dist/types/other/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/types/other/find.ts"],"names":[],"mappings":"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"}

package/dist/types/other/find.js

@@ -0,0 +1 @@
+export {};

package/dist/types/other/index.d.ts

@@ -1,4 +1,7 @@
 export * from "./collections";
 export * from "./companies";
 export * from "./credits";
+export * from "./find";
+export * from "./watch_providers";
+export * from "./keywords";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/other/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/other/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/other/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/types/other/index.js

@@ -1,3 +1,6 @@
 export * from "./collections";
 export * from "./companies";
 export * from "./credits";
+export * from "./find";
+export * from "./watch_providers";
+export * from "./keywords";

package/dist/types/other/keywords.d.ts

@@ -0,0 +1,20 @@
+import { TMDBQueryParams } from "../common";
+/**
+ * Base params used by keyword endpoints.
+ */
+export type KeywordBaseParam = {
+    /** TMDB keyword identifier. */
+    keyword_id: number;
+};
+/**
+ * Parameters for fetching keyword details.
+ */
+export type KeywordDetailsParams = KeywordBaseParam;
+/**
+ * Parameters for fetching movies associated with a keyword.
+ * @reference https://developer.themoviedb.org/reference/keyword-movies
+ */
+export type KeywordMoviesParams = KeywordBaseParam & Pick<TMDBQueryParams, "language" | "page"> & {
+    include_adult?: boolean;
+};
+//# sourceMappingURL=keywords.d.ts.map

package/dist/types/other/keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywords.d.ts","sourceRoot":"","sources":["../../../src/types/other/keywords.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GACjD,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,MAAM,CAAC,GAAG;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC"}

package/dist/types/other/keywords.js

@@ -0,0 +1 @@
+export {};

package/dist/types/other/watch_providers.d.ts

@@ -0,0 +1,35 @@
+import { WithLanguage } from "../common";
+import { WatchProviderItem } from "../common/media";
+import { CountryISO3166_1 } from "../config";
+import { ConfigurationCountry } from "../config/configuration";
+/**
+ * Parameters supported by watch provider namespace endpoints.
+ */
+export type WatchProviderListParams = WithLanguage;
+/**
+ * Parameters for listing the available watch provider regions.
+ */
+export type WatchProviderRegionsParams = WithLanguage;
+/**
+ * Country-specific display priorities returned by top-level watch provider list endpoints.
+ */
+export type WatchProviderDisplayPriorities = Partial<Record<CountryISO3166_1, number>>;
+/**
+ * A watch provider returned by top-level movie and TV provider list endpoints.
+ */
+export type WatchProviderListItem = WatchProviderItem & {
+    display_priorities: WatchProviderDisplayPriorities;
+};
+/**
+ * Response returned by movie and TV watch provider list endpoints.
+ */
+export type WatchProviderListResponse = {
+    results: WatchProviderListItem[];
+};
+/**
+ * Response returned by the available regions endpoint.
+ */
+export type WatchProviderRegionsResponse = {
+    results: ConfigurationCountry[];
+};
+//# sourceMappingURL=watch_providers.d.ts.map

package/dist/types/other/watch_providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch_providers.d.ts","sourceRoot":"","sources":["../../../src/types/other/watch_providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACvD,kBAAkB,EAAE,8BAA8B,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,qBAAqB,EAAE,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE,oBAAoB,EAAE,CAAC;CAChC,CAAC"}

package/dist/types/other/watch_providers.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,69 +1,71 @@
 {
-  "name": "@lorenzopant/tmdb",
-  "version": "1.8.0",
-  "description": "A completely type-safe The Movie Database (TMDB) API wrapper for typescript applications.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lorenzopant/tmdb"
-  },
-  "homepage": "https://lorenzopant-tmdb-docs.vercel.app",
-  "bugs": {
-    "url": "https://github.com/lorenzopant/tmdb/issues"
-  },
-  "author": "Lorenzo Pantano",
-  "license": "MIT",
-  "keywords": [
-    "tmdb",
-    "typescript",
-    "api",
-    "movies"
-  ],
-  "devDependencies": {
-    "@eslint/compat": "^2.0.0",
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.30.0",
-    "@types/node": "^22.15.2",
-    "@typescript-eslint/eslint-plugin": "^8.35.0",
-    "@typescript-eslint/parser": "^8.35.0",
-    "@vitest/coverage-v8": "^4.0.9",
-    "@vitest/ui": "^4.0.10",
-    "dotenv": "^16.5.0",
-    "eslint": "^9.30.0",
-    "eslint-config-prettier": "^10.1.5",
-    "eslint-plugin-import": "^2.32.0",
-    "husky": "^9.1.7",
-    "release-it": "^19.0.3",
-    "release-it-pnpm": "^4.6.6",
-    "ts-morph": "^27.0.2",
-    "tsx": "^4.21.0",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.35.0",
-    "vite": "^7.0.0",
-    "vitest": "^4.0.9"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./types": {
-      "types": "./dist/types/index.d.ts",
-      "default": "./dist/types/index.js"
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
-    "lint": "eslint .",
-    "release": "pnpm release:patch",
-    "release:patch": "pnpm version patch --git-tag-version && git push --follow-tags",
-    "release:minor": "pnpm version minor --git-tag-version && git push --follow-tags",
-    "release:major": "pnpm version major --git-tag-version && git push --follow-tags"
-  }
-}
+	"name": "@lorenzopant/tmdb",
+	"version": "1.10.0",
+	"description": "A completely type-safe The Movie Database (TMDB) API wrapper for typescript applications.",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/lorenzopant/tmdb"
+	},
+	"homepage": "https://lorenzopant-tmdb-docs.vercel.app",
+	"bugs": {
+		"url": "https://github.com/lorenzopant/tmdb/issues"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest",
+		"test:ui": "vitest --ui",
+		"test:coverage": "vitest --coverage",
+		"prepare": "husky",
+		"lint": "eslint .",
+		"release": "pnpm release:patch",
+		"release:patch": "pnpm version patch --git-tag-version && git push --follow-tags",
+		"release:minor": "pnpm version minor --git-tag-version && git push --follow-tags",
+		"release:major": "pnpm version major --git-tag-version && git push --follow-tags"
+	},
+	"author": "Lorenzo Pantano",
+	"license": "MIT",
+	"keywords": [
+		"tmdb",
+		"typescript",
+		"api",
+		"movies"
+	],
+	"packageManager": "pnpm@8.8.0",
+	"devDependencies": {
+		"@eslint/compat": "^2.0.0",
+		"@eslint/eslintrc": "^3.3.1",
+		"@eslint/js": "^9.30.0",
+		"@types/node": "^22.15.2",
+		"@typescript-eslint/eslint-plugin": "^8.35.0",
+		"@typescript-eslint/parser": "^8.35.0",
+		"@vitest/coverage-v8": "^4.0.9",
+		"@vitest/ui": "^4.0.10",
+		"dotenv": "^16.5.0",
+		"eslint": "^9.30.0",
+		"eslint-config-prettier": "^10.1.5",
+		"eslint-plugin-import": "^2.32.0",
+		"husky": "^9.1.7",
+		"release-it": "^19.0.3",
+		"release-it-pnpm": "^4.6.6",
+		"ts-morph": "^27.0.2",
+		"tsx": "^4.21.0",
+		"typescript": "^5.8.3",
+		"typescript-eslint": "^8.35.0",
+		"vite": "^7.0.0",
+		"vitest": "^4.0.9"
+	},
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		},
+		"./types": {
+			"types": "./dist/types/index.d.ts",
+			"default": "./dist/types/index.js"
+		}
+	}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 @lorenzopant
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.