@lorenzopant/tmdb 0.0.4 → 0.0.6

package/dist/endpoints/movie_lists.d.ts

@@ -12,6 +12,7 @@ export declare class MovieListsAPI {
     private client;
     private defaultOptions;
     constructor(client: ApiClient, defaultOptions?: TMDBOptions);
+    private withDefaults;
     /**
      * Fetch Movie List Wrapper
      * @param endpoint Endpoint to call

package/dist/endpoints/movie_lists.js

@@ -13,6 +13,10 @@ export class MovieListsAPI {
         this.client = client;
         this.defaultOptions = defaultOptions;
     }
+    withDefaults(params) {
+        const { language = this.defaultOptions.language, region = this.defaultOptions.region, ...rest } = params;
+        return { language, region, ...rest };
+    }
     /**
      * Fetch Movie List Wrapper
      * @param endpoint Endpoint to call
@@ -20,8 +24,7 @@ export class MovieListsAPI {
      * @returns Specific to endpoint (MovieListResult)
      */
     fetch_movie_list(endpoint, params = {}) {
-        const mergedParams = { ...this.defaultOptions, ...params };
-        return this.client.request(MOVIE_ENDPOINTS.MOVIE + endpoint, mergedParams);
+        return this.client.request(MOVIE_ENDPOINTS.MOVIE + endpoint, this.withDefaults(params));
     }
     /**
      * Now Playing

package/dist/endpoints/movies.d.ts

@@ -2,7 +2,7 @@ import { ApiClient } from "../client";
 import { TMDBOptions } from "../tmdb";
 import { Changes } from "../types/common";
 import { MovieAlternativeTitles, MovieCredits, MovieDetails, MovieExternalIDs, MovieImages, MovieKeywords, MovieReleaseDates, MovieResultItem, MovieTranslations, MovieVideos, MovieWatchProvider } from "../types/movies";
-import { MovieAlternativeTitlesParams, MovieDetailsParams, PaginatedResponse } from "../types/params";
+import { MovieAlternativeTitlesParams, MovieChangesParams, MovieCreditsParams, MovieDetailsParams, MovieExternalIDsParams, MovieImagesParams, MovieKeywordsParams, MovieRecommendationsParams, MovieReleaseDatesParams, MovieSimilarParams, MovieTranslationsParams, MovieVideosParams, MovieWathProvidersParams, PaginatedResponse } from "../types/params";
 export declare const MOVIE_ENDPOINTS: {
     MOVIE: string;
     ALTERNATIVE_TITLES: string;
@@ -56,7 +56,7 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to the movie credits.
      * @reference https://developer.themoviedb.org/reference/movie-credits
      */
-    credits(movie_id: number, language?: string): Promise<MovieCredits>;
+    credits(params: MovieCreditsParams): Promise<MovieCredits>;
     /**
      * External IDs
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/external_ids
@@ -68,7 +68,7 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to the movie external IDs.
      * @reference https://developer.themoviedb.org/reference/movie-external-ids
      */
-    external_ids(movie_id: number): Promise<MovieExternalIDs>;
+    external_ids(params: MovieExternalIDsParams): Promise<MovieExternalIDs>;
     /**
      * Keywords
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/keywords
@@ -79,7 +79,7 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to the movie keywords.
      * @reference https://developer.themoviedb.org/reference/movie-keywords
      */
-    keywords(movie_id: number): Promise<MovieKeywords>;
+    keywords(params: MovieKeywordsParams): Promise<MovieKeywords>;
     /**
      * Changes
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/changes
@@ -94,20 +94,23 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to the changes made to the movie.
      * @reference https://developer.themoviedb.org/reference/movie-changes
      */
-    changes(movie_id: number, page?: number, start_date?: string, end_date?: string): Promise<Changes>;
+    changes(params: MovieChangesParams): Promise<Changes>;
     /**
      * Images
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/images
      *
      * Fetches images related to a specific movie, such as posters and backdrops.
      * The images are returned in various sizes and formats.
+     *
+     * If you have a language specified, it will act as a filter on the returned items. You can use the include_image_language param to query additional languages.
+     *
      * @param movie_id - The unique identifier of the movie.
      * @param language - (Optional) The language code to filter the images by language.
      * @param include_image_language - (Optional) A comma-separated list of language codes to include images for.
      * @returns A promise that resolves to a `MovieImages` object containing the movie's images.
      * @reference https://developer.themoviedb.org/reference/movie-images
      */
-    images(movie_id: number, language?: string, include_image_language?: string): Promise<MovieImages>;
+    images(params: MovieImagesParams): Promise<MovieImages>;
     /**
      * Latest
      * GET - https://api.themoviedb.org/3/movie/latest
@@ -130,7 +133,7 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to a paginated response of similar movies.
      * @reference https://developer.themoviedb.org/reference/movie-recommendations
      */
-    recommendations(movie_id: number, page?: number, language?: string): Promise<PaginatedResponse<MovieResultItem>>;
+    recommendations(params: MovieRecommendationsParams): Promise<PaginatedResponse<MovieResultItem>>;
     /**
      * Release Dates
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/release_dates
@@ -147,7 +150,7 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to the release dates for the movie.
      * @reference https://developer.themoviedb.org/reference/movie-release-dates
      */
-    release_dates(movie_id: number): Promise<MovieReleaseDates>;
+    release_dates(params: MovieReleaseDatesParams): Promise<MovieReleaseDates>;
     /**
      * Similar
      * GET -https://api.themoviedb.org/3/movie/{movie_id}/similar
@@ -161,7 +164,7 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to a paginated response of similar movies.
      * @reference https://developer.themoviedb.org/reference/movie-similar
      */
-    similar(movie_id: number, language?: string, page?: number): Promise<PaginatedResponse<MovieResultItem>>;
+    similar(params: MovieSimilarParams): Promise<PaginatedResponse<MovieResultItem>>;
     /**
      * Translations
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/translations
@@ -173,7 +176,7 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to the translations of the movie.
      * @reference https://developer.themoviedb.org/reference/movie-translations
      */
-    translations(movie_id: number): Promise<MovieTranslations>;
+    translations(params: MovieTranslationsParams): Promise<MovieTranslations>;
     /**
      * Videos
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/videos
@@ -183,7 +186,7 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to a list of videos for the movie.
      * @reference https://developer.themoviedb.org/reference/movie-videos
      */
-    videos(movie_id: number, language?: string): Promise<MovieVideos>;
+    videos(params: MovieVideosParams): Promise<MovieVideos>;
     /**
      * Watch Providers
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/watch/providers
@@ -200,5 +203,5 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to a list of videos for the movie.
      * @reference https://developer.themoviedb.org/reference/movie-videos
      */
-    watch_providers(movie_id: number): Promise<MovieWatchProvider>;
+    watch_providers(params: MovieWathProvidersParams): Promise<MovieWatchProvider>;
 }

package/dist/endpoints/movies.js

@@ -1,4 +1,3 @@
-import { mergeParams } from "../utils/params";
 export const MOVIE_ENDPOINTS = {
     MOVIE: "/movie",
     ALTERNATIVE_TITLES: "/alternative_titles",
@@ -40,9 +39,9 @@ export class MoviesAPI {
      * @reference https://developer.themoviedb.org/reference/movie-details
      */
     async details(params) {
-        const mergedParams = { ...this.defaultOptions, ...params };
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${mergedParams.movie_id}`;
-        return this.client.request(endpoint, mergedParams);
+        const { language = this.defaultOptions.language, ...rest } = params;
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}`;
+        return this.client.request(endpoint, { language, ...rest });
     }
     /**
      * Alternative Titles
@@ -55,9 +54,8 @@ export class MoviesAPI {
      * @reference https://developer.themoviedb.org/reference/movie-alternative-titles
      */
     async alternative_titles(params) {
-        const mergedParams = mergeParams(this.defaultOptions, params);
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${mergedParams.movie_id}${MOVIE_ENDPOINTS.ALTERNATIVE_TITLES}`;
-        return this.client.request(endpoint, mergedParams);
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.ALTERNATIVE_TITLES}`;
+        return this.client.request(endpoint, params);
     }
     /**
      * Credits
@@ -69,10 +67,10 @@ export class MoviesAPI {
      * @returns A promise that resolves to the movie credits.
      * @reference https://developer.themoviedb.org/reference/movie-credits
      */
-    async credits(movie_id, language = "en-US") {
-        const params = { language };
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.CREDITS}`;
-        return this.client.request(endpoint, params);
+    async credits(params) {
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.CREDITS}`;
+        const { language = this.defaultOptions.language, ...rest } = params;
+        return this.client.request(endpoint, { language, ...rest });
     }
     /**
      * External IDs
@@ -85,8 +83,8 @@ export class MoviesAPI {
      * @returns A promise that resolves to the movie external IDs.
      * @reference https://developer.themoviedb.org/reference/movie-external-ids
      */
-    async external_ids(movie_id) {
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.EXTERNAL_IDS}`;
+    async external_ids(params) {
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.EXTERNAL_IDS}`;
         return this.client.request(endpoint);
     }
     /**
@@ -99,8 +97,8 @@ export class MoviesAPI {
      * @returns A promise that resolves to the movie keywords.
      * @reference https://developer.themoviedb.org/reference/movie-keywords
      */
-    async keywords(movie_id) {
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.KEYWORDS}`;
+    async keywords(params) {
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.KEYWORDS}`;
         return this.client.request(endpoint);
     }
     /**
@@ -117,9 +115,8 @@ export class MoviesAPI {
      * @returns A promise that resolves to the changes made to the movie.
      * @reference https://developer.themoviedb.org/reference/movie-changes
      */
-    async changes(movie_id, page, start_date, end_date) {
-        const params = { page, start_date, end_date };
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.CHANGES}`;
+    async changes(params) {
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.CHANGES}`;
         return this.client.request(endpoint, params);
     }
     /**
@@ -128,16 +125,19 @@ export class MoviesAPI {
      *
      * Fetches images related to a specific movie, such as posters and backdrops.
      * The images are returned in various sizes and formats.
+     *
+     * If you have a language specified, it will act as a filter on the returned items. You can use the include_image_language param to query additional languages.
+     *
      * @param movie_id - The unique identifier of the movie.
      * @param language - (Optional) The language code to filter the images by language.
      * @param include_image_language - (Optional) A comma-separated list of language codes to include images for.
      * @returns A promise that resolves to a `MovieImages` object containing the movie's images.
      * @reference https://developer.themoviedb.org/reference/movie-images
      */
-    async images(movie_id, language, include_image_language) {
-        const params = { language, include_image_language };
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.IMAGES}`;
-        return this.client.request(endpoint, params);
+    async images(params) {
+        const { language = this.defaultOptions.language, ...rest } = params;
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.IMAGES}`;
+        return this.client.request(endpoint, { language, ...rest });
     }
     /**
      * Latest
@@ -164,10 +164,10 @@ export class MoviesAPI {
      * @returns A promise that resolves to a paginated response of similar movies.
      * @reference https://developer.themoviedb.org/reference/movie-recommendations
      */
-    async recommendations(movie_id, page, language) {
-        const params = { page, language };
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.RECOMMENDATIONS}`;
-        return this.client.request(endpoint, params);
+    async recommendations(params) {
+        const { language = this.defaultOptions.language, ...rest } = params;
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.RECOMMENDATIONS}`;
+        return this.client.request(endpoint, { language, ...rest });
     }
     /**
      * Release Dates
@@ -185,8 +185,8 @@ export class MoviesAPI {
      * @returns A promise that resolves to the release dates for the movie.
      * @reference https://developer.themoviedb.org/reference/movie-release-dates
      */
-    async release_dates(movie_id) {
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.RELEASE_DATES}`;
+    async release_dates(params) {
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.RELEASE_DATES}`;
         return this.client.request(endpoint);
     }
     /**
@@ -202,10 +202,10 @@ export class MoviesAPI {
      * @returns A promise that resolves to a paginated response of similar movies.
      * @reference https://developer.themoviedb.org/reference/movie-similar
      */
-    async similar(movie_id, language, page) {
-        const params = { page, language };
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.SIMILAR}`;
-        return this.client.request(endpoint, params);
+    async similar(params) {
+        const { language = this.defaultOptions.language, ...rest } = params;
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.SIMILAR}`;
+        return this.client.request(endpoint, { language, ...rest });
     }
     /**
      * Translations
@@ -218,8 +218,8 @@ export class MoviesAPI {
      * @returns A promise that resolves to the translations of the movie.
      * @reference https://developer.themoviedb.org/reference/movie-translations
      */
-    async translations(movie_id) {
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.TRANSLATIONS}`;
+    async translations(params) {
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.TRANSLATIONS}`;
         return this.client.request(endpoint);
     }
     /**
@@ -231,10 +231,10 @@ export class MoviesAPI {
      * @returns A promise that resolves to a list of videos for the movie.
      * @reference https://developer.themoviedb.org/reference/movie-videos
      */
-    async videos(movie_id, language) {
-        const params = { language };
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.VIDEOS}`;
-        return this.client.request(endpoint, params);
+    async videos(params) {
+        const { language = this.defaultOptions.language, ...rest } = params;
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.VIDEOS}`;
+        return this.client.request(endpoint, { language, ...rest });
     }
     /**
      * Watch Providers
@@ -252,8 +252,8 @@ export class MoviesAPI {
      * @returns A promise that resolves to a list of videos for the movie.
      * @reference https://developer.themoviedb.org/reference/movie-videos
      */
-    async watch_providers(movie_id) {
-        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${movie_id}${MOVIE_ENDPOINTS.WATCH_PROVIDERS}`;
+    async watch_providers(params) {
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.WATCH_PROVIDERS}`;
         return this.client.request(endpoint);
     }
 }

package/dist/endpoints/search.d.ts

@@ -9,6 +9,7 @@ export declare class SearchAPI {
     private client;
     private defaultOptions;
     constructor(client: ApiClient, defaultOptions?: TMDBOptions);
+    withDefaults(params: SearchMoviesParams): SearchMoviesParams;
     /**
      * Search
      * GET - https://api.themoviedb.org/3/search/movie

package/dist/endpoints/search.js

@@ -8,6 +8,10 @@ export class SearchAPI {
         this.client = client;
         this.defaultOptions = defaultOptions;
     }
+    withDefaults(params) {
+        const { language = this.defaultOptions.language, region = this.defaultOptions.region, ...rest } = params;
+        return { language, region, ...rest };
+    }
     /**
      * Search
      * GET - https://api.themoviedb.org/3/search/movie
@@ -24,8 +28,6 @@ export class SearchAPI {
      */
     async movies(params) {
         const endpoint = `${SEARCH_ENDPOINTS.MOVIE}`;
-        // Merge defaultOptions with params, giving precedence to params
-        const mergedParams = { ...this.defaultOptions, ...params };
-        return this.client.request(endpoint, mergedParams);
+        return this.client.request(endpoint, this.withDefaults(params));
     }
 }

package/dist/index.d.ts

@@ -2,3 +2,8 @@ export { TMDB } from "./tmdb";
 export { TMDBError } from "./errors/tmdb";
 export type { MovieDetails, MovieAlternativeTitle, MovieAlternativeTitles, MovieCredits, MovieExternalIDs, MovieImages, MovieKeywords, MovieReleaseDates, MovieTranslations, MovieVideos, } from "./types/movies";
 export type { Changes, Collection, Genre, ImageItem, Keyword, ProductionCompany, ProductionCountry, SpokenLanguage, VideoItem, Cast, Crew, } from "./types/common";
+export type { SearchMoviesParams, MovieDetailsParams, MovieListParams, PaginatedResponse, MovieAlternativeTitlesParams, } from "./types/params";
+export type { CountryISO3166_1 } from "./types/countries";
+export { TMDBCountries } from "./types/countries";
+export type { LanguageISO6391 } from "./types/lang";
+export { Languages } from "./types/lang";

package/dist/index.js

@@ -1,3 +1,5 @@
 // src/index.ts
 export { TMDB } from "./tmdb";
 export { TMDBError } from "./errors/tmdb";
+export { TMDBCountries } from "./types/countries";
+export { Languages } from "./types/lang";

package/dist/tests/movie_list/movie_list.integration.test.js

@@ -3,7 +3,7 @@ import { TMDB } from "../../tmdb";
 const token = process.env.TMDB_ACCESS_TOKEN;
 if (!token)
     throw new Error("TMDB_ACCESS_TOKEN is not set, plaase set it in your enviroment variables.");
-const tmdb = new TMDB(token, { language: "it-IT", region: "IT", country: "IT" });
+const tmdb = new TMDB(token, { language: "it", region: "IT" });
 describe("Movie List (integration)", () => {
     it("(NOW PLAYING) should get now playing movies", async () => {
         const now_playing = await tmdb.movie_lists.now_playing();

package/dist/tests/movies/movies.integration.test.js

@@ -34,7 +34,7 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE CREDITS) should get movie credits", async () => {
         const movie_id = 550; // Fight Club
-        const credits = await tmdb.movies.credits(movie_id);
+        const credits = await tmdb.movies.credits({ movie_id });
         expect(credits).toBeDefined();
         expect(credits.id).toBe(movie_id);
         expect(credits.cast.length).toBeGreaterThan(0);
@@ -43,14 +43,14 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE EXTERNAL IDS) should get movie external IDs", async () => {
         const movie_id = 550; // Fight Club
-        const external_ids = await tmdb.movies.external_ids(movie_id);
+        const external_ids = await tmdb.movies.external_ids({ movie_id });
         expect(external_ids).toBeDefined();
         expect(external_ids.id).toBe(movie_id);
         expect(external_ids.imdb_id).toBe("tt0137523");
     });
     it("(MOVIE KEYWORDS) should get movie keywords", async () => {
         const movie_id = 550; // Fight Club
-        const keywords = await tmdb.movies.keywords(movie_id);
+        const keywords = await tmdb.movies.keywords({ movie_id });
         expect(keywords).toBeDefined();
         expect(keywords.id).toBe(movie_id);
         expect(keywords.keywords.length).toBeGreaterThan(0);
@@ -59,7 +59,7 @@ describe("Movies (integration)", () => {
         const movie_id = 550; // Fight Club
         const start_date = "2024-12-20";
         const end_date = "2024-12-24";
-        const changes = await tmdb.movies.changes(movie_id, 1, start_date, end_date);
+        const changes = await tmdb.movies.changes({ movie_id, start_date, end_date });
         expect(changes).toBeDefined();
         expect(changes.changes).toBeDefined();
         expect(changes.changes[0].key).toBe("images");
@@ -67,7 +67,7 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE IMAGES) should get movie images", async () => {
         const movie_id = 550; // Fight Club
-        const images = await tmdb.movies.images(movie_id);
+        const images = await tmdb.movies.images({ movie_id });
         expect(images).toBeDefined();
         expect(images.id).toBe(movie_id);
         expect(images.backdrops.length).toBeGreaterThan(0);
@@ -75,10 +75,10 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE IMAGES) should get movie images for a specific language", async () => {
         const movie_id = 550; // Fight Club
-        const images = await tmdb.movies.images(movie_id, "en");
+        const images = await tmdb.movies.images({ movie_id, language: "de" });
         expect(images).toBeDefined();
         expect(images.id).toBe(movie_id);
-        expect(images.backdrops.length).toBeGreaterThan(0);
+        expect(images.backdrops.length).toBeGreaterThanOrEqual(0);
         expect(images.posters.length).toBeGreaterThan(0);
     });
     it("(MOVIE LATEST) should get the latest movie details", async () => {
@@ -89,7 +89,7 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE RECOMMENDATIONS) should get movie recommendations", async () => {
         const movie_id = 550; // Fight Club
-        const recommendations = await tmdb.movies.recommendations(movie_id);
+        const recommendations = await tmdb.movies.recommendations({ movie_id });
         expect(recommendations).toBeDefined();
         expect(recommendations.results.length).toBeGreaterThan(0);
         expect(recommendations.results[0].id).toBeDefined();
@@ -99,7 +99,7 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE RELEASE DATES) should get movie release dates", async () => {
         const movie_id = 550; // Fight Club
-        const release_dates = await tmdb.movies.release_dates(movie_id);
+        const release_dates = await tmdb.movies.release_dates({ movie_id });
         expect(release_dates).toBeDefined();
         expect(release_dates.id).toBe(movie_id);
         expect(release_dates.results.length).toBeGreaterThan(0);
@@ -108,7 +108,7 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE SIMILAR) should get similar movies", async () => {
         const movie_id = 550;
-        const similar = await tmdb.movies.similar(movie_id);
+        const similar = await tmdb.movies.similar({ movie_id });
         expect(similar).toBeDefined();
         expect(similar.results.length).toBeGreaterThan(0);
         expect(similar.results[0].id).toBeDefined();
@@ -118,7 +118,7 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE TRANSLATIONS) should get translations for a movie", async () => {
         const movie_id = 550;
-        const translations = await tmdb.movies.translations(movie_id);
+        const translations = await tmdb.movies.translations({ movie_id });
         expect(translations).toBeDefined();
         expect(translations.id).toBe(movie_id);
         expect(translations.translations).toBeDefined();
@@ -127,7 +127,7 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE VIDEOS) should get videos for a movie", async () => {
         const movie_id = 550;
-        const videos = await tmdb.movies.videos(movie_id);
+        const videos = await tmdb.movies.videos({ movie_id });
         expect(videos).toBeDefined();
         expect(videos.id).toBe(movie_id);
         expect(videos.results).toBeDefined();
@@ -136,7 +136,7 @@ describe("Movies (integration)", () => {
     });
     it("(MOVIE WATCH PROVIDERS) should get watch providers for a movie", async () => {
         const movie_id = 550;
-        const watch_providers = await tmdb.movies.watch_providers(movie_id);
+        const watch_providers = await tmdb.movies.watch_providers({ movie_id });
         expect(watch_providers).toBeDefined();
         expect(watch_providers.id).toBe(movie_id);
         expect(watch_providers.results).toBeDefined();

package/dist/tests/search/search.integration.test.js

@@ -13,7 +13,7 @@ describe("Search (integration)", () => {
         expect(movies.results[0].title).toBe("Fight Club");
     });
     it("(SEARCH MOVIE) should search for a movie with default options", async () => {
-        const tmdb = new TMDB(token, { language: "it-IT", region: "IT" });
+        const tmdb = new TMDB(token, { language: "it", region: "IT" });
         const movies = await tmdb.search.movies({ query: "Fight Club" });
         expect(movies.page).toBe(1);
         expect(movies.total_results).toBeGreaterThan(0);

package/dist/tmdb.d.ts

@@ -1,10 +1,21 @@
 import { MovieListsAPI } from "./endpoints/movie_lists";
 import { MoviesAPI } from "./endpoints/movies";
 import { SearchAPI } from "./endpoints/search";
+import { CountryISO3166_1 } from "./types/countries";
+import { LanguageISO6391 } from "./types/lang";
 export type TMDBOptions = {
-    language?: string;
-    region?: string;
-    country?: string;
+    /**
+     * The language to use for requests (ISO 639-1 code)
+     * This provides localization and translated data.
+     */
+    language?: LanguageISO6391;
+    /**
+     * Region codes follow ISO 3166-1 (e.g. 'US', 'IT', 'JP') and are used to localize results.
+     * They affect release dates, age certifications, watch providers, and filtered movie lists.
+     * Example: 'region=IT' returns Italian-specific results for now playing, watch providers, etc.
+     * If not set, TMDB may fall back to a default or global data.
+     */
+    region?: CountryISO3166_1;
 };
 export declare class TMDB {
     private client;
@@ -18,9 +29,4 @@ export declare class TMDB {
      * @param options Optional default options (e.g., language) for all requests.
      */
     constructor(accessToken: string, options?: TMDBOptions);
-    /**
-     * Helper to merge default options with method-specific params.
-     * Method-level params override defaults.
-     */
-    withDefaults<T extends object>(params?: T): T & TMDBOptions;
 }

package/dist/tmdb.js

@@ -21,15 +21,8 @@ export class TMDB {
             throw new Error(Errors.NO_ACCESS_TOKEN);
         this.options = options;
         this.client = new ApiClient(accessToken);
-        this.movies = new MoviesAPI(this.client, options);
-        this.movie_lists = new MovieListsAPI(this.client, options);
-        this.search = new SearchAPI(this.client, options);
-    }
-    /**
-     * Helper to merge default options with method-specific params.
-     * Method-level params override defaults.
-     */
-    withDefaults(params) {
-        return { ...this.options, ...params };
+        this.movies = new MoviesAPI(this.client, this.options);
+        this.movie_lists = new MovieListsAPI(this.client, this.options);
+        this.search = new SearchAPI(this.client, this.options);
     }
 }

package/dist/types/params.d.ts

@@ -29,3 +29,32 @@ export type MovieAlternativeTitlesParams = {
     movie_id: number;
     country?: CountryISO3166_1;
 };
+export type MovieCreditsParams = {
+    movie_id: number;
+    language?: LanguageISO6391;
+};
+export type MovieKeywordsParams = {
+    movie_id: number;
+};
+export type MovieExternalIDsParams = MovieKeywordsParams;
+export type MovieReleaseDatesParams = MovieKeywordsParams;
+export type MovieTranslationsParams = MovieKeywordsParams;
+export type MovieWathProvidersParams = MovieKeywordsParams;
+export type MovieChangesParams = {
+    movie_id: number;
+    page?: number;
+    start_date?: string;
+    end_date?: string;
+};
+export type MovieImagesParams = {
+    movie_id: number;
+    language?: LanguageISO6391;
+    include_image_language?: LanguageISO6391;
+};
+export type MovieRecommendationsParams = {
+    movie_id: number;
+    page?: number;
+    language?: LanguageISO6391;
+};
+export type MovieSimilarParams = MovieRecommendationsParams;
+export type MovieVideosParams = MovieCreditsParams;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lorenzopant/tmdb",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "A completely type-safe The Movie Database (TMDB) API wrapper for typescript applications.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",