@lorenzopant/tmdb 0.0.5 → 0.0.7

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

@@ -1,8 +1,8 @@
 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 { MovieAlternativeTitles, MovieAppendToResponseNamespace, MovieCredits, MovieDetails, MovieDetailsWithAppends, MovieExternalIDs, MovieImages, MovieKeywords, MovieRecommendations, MovieReleaseDates, MovieReviews, MovieSimilar, MovieTranslations, MovieVideos, MovieWatchProvider } from "../types/movies";
+import { MovieAlternativeTitlesParams, MovieChangesParams, MovieCreditsParams, MovieDetailsParams, MovieExternalIDsParams, MovieImagesParams, MovieKeywordsParams, MovieRecommendationsParams, MovieReleaseDatesParams, MovieReviewsParams, MovieSimilarParams, MovieTranslationsParams, MovieVideosParams, MovieWathProvidersParams } from "../types/params";
 export declare const MOVIE_ENDPOINTS: {
     MOVIE: string;
     ALTERNATIVE_TITLES: string;
@@ -18,6 +18,7 @@ export declare const MOVIE_ENDPOINTS: {
     TRANSLATIONS: string;
     VIDEOS: string;
     WATCH_PROVIDERS: string;
+    REVIEWS: string;
 };
 export declare class MoviesAPI {
     private client;
@@ -34,7 +35,9 @@ export declare class MoviesAPI {
      * @returns A promise that resolves to the movie details.
      * @reference https://developer.themoviedb.org/reference/movie-details
      */
-    details(params: MovieDetailsParams): Promise<MovieDetails>;
+    details<T extends readonly MovieAppendToResponseNamespace[] = []>(params: MovieDetailsParams & {
+        append_to_response?: T[number] | T;
+    }): Promise<T extends [] ? MovieDetails : MovieDetailsWithAppends<T>>;
     /**
      * Alternative Titles
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/alternative_titles
@@ -56,7 +59,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 +71,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 +82,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 +97,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 +136,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<MovieRecommendations>;
     /**
      * Release Dates
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/release_dates
@@ -147,7 +153,19 @@ 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>;
+    /**
+     * Reviews
+     * GET - https://api.themoviedb.org/3/movie/{movie_id}/reviews
+     *
+     * Get the user reviews for a movie.
+     * @param movie_id The ID of the movie.
+     * @param page Page number of the results to return. Defaults to 1.
+     * @param language Language code to filter the results. Default is "en-US".
+     * @returns A promise that resolves to a paginated response of movies reviews.
+     * @reference https://developer.themoviedb.org/reference/movie-reviews
+     */
+    reviews(params: MovieReviewsParams): Promise<MovieReviews>;
     /**
      * Similar
      * GET -https://api.themoviedb.org/3/movie/{movie_id}/similar
@@ -161,7 +179,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<MovieSimilar>;
     /**
      * Translations
      * GET - https://api.themoviedb.org/3/movie/{movie_id}/translations
@@ -173,7 +191,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 +201,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 +218,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",
@@ -14,10 +13,10 @@ export const MOVIE_ENDPOINTS = {
     TRANSLATIONS: "/translations",
     VIDEOS: "/videos",
     WATCH_PROVIDERS: "/watch/providers",
+    REVIEWS: "/reviews",
     // Missing:
     // ACCOUNT_STATES
     // LISTS
-    // REVIEWS
     // ADD RATING
     // DELETE RATING
 };
@@ -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,10 +185,26 @@ 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);
     }
+    /**
+     * Reviews
+     * GET - https://api.themoviedb.org/3/movie/{movie_id}/reviews
+     *
+     * Get the user reviews for a movie.
+     * @param movie_id The ID of the movie.
+     * @param page Page number of the results to return. Defaults to 1.
+     * @param language Language code to filter the results. Default is "en-US".
+     * @returns A promise that resolves to a paginated response of movies reviews.
+     * @reference https://developer.themoviedb.org/reference/movie-reviews
+     */
+    async reviews(params) {
+        const { language = this.defaultOptions.language, ...rest } = params;
+        const endpoint = `${MOVIE_ENDPOINTS.MOVIE}/${params.movie_id}${MOVIE_ENDPOINTS.REVIEWS}`;
+        return this.client.request(endpoint, { language, ...rest });
+    }
     /**
      * Similar
      * GET -https://api.themoviedb.org/3/movie/{movie_id}/similar
@@ -202,10 +218,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 +234,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 +247,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 +268,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/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

@@ -25,6 +25,15 @@ describe("Movies (integration)", () => {
             expect(error).toBeInstanceOf(TMDBError);
         }
     });
+    it("(MOVIE DETAILS) should get movie details with appended response", async () => {
+        const movie_id = 550; // Fight Club
+        const movie = await tmdb.movies.details({ movie_id, append_to_response: ["reviews"] });
+        expect(movie).toBeDefined();
+        expect(movie.id).toBe(movie_id);
+        expect(movie.title).toBe("Fight Club");
+        expect(movie.reviews.results).toBeDefined();
+        expect(movie.reviews.results.length).toBeGreaterThanOrEqual(0);
+    });
     it("(MOVIE ALTERNATIVE TITLES) should get movie alternative titles", async () => {
         const movie_id = 550; // Fight Club
         const movie_titles = await tmdb.movies.alternative_titles({ movie_id });
@@ -34,7 +43,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 +52,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 +68,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 +76,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 +84,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 +98,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,16 +108,26 @@ 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);
         expect(release_dates.results[0].iso_3166_1).toBeDefined();
         expect(release_dates.results[0].release_dates.length).toBeGreaterThan(0);
     });
+    it("(MOVIE REVIEWS) should get movie reviews", async () => {
+        const movie_id = 550; // Fight Club
+        const reviews = await tmdb.movies.reviews({ movie_id });
+        expect(reviews).toBeDefined();
+        expect(reviews.results.length).toBeGreaterThan(0);
+        expect(reviews.results[0].id).toBeDefined();
+        expect(reviews.page).toBe(1);
+        expect(reviews.total_results).toBeGreaterThan(0);
+        expect(reviews.total_pages).toBeGreaterThan(0);
+    });
     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 +137,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 +146,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 +155,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/movies/movies.test.js

@@ -13,9 +13,9 @@ describe("MoviesAPI", () => {
     });
     it("should call client.request with the correct parameters", async () => {
         const movie_id = 550;
-        const append_to_response = ["credits", "images"];
         const language = "en";
-        await moviesAPI.details({ movie_id, append_to_response, language });
+        const append_to_response = ["credits", "images"];
+        await moviesAPI.details({ movie_id, language, append_to_response });
         expect(clientMock.request).toHaveBeenCalledOnce();
         expect(clientMock.request).toHaveBeenCalledWith("/movie/550", {
             movie_id,

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/movies.d.ts

@@ -1,5 +1,6 @@
-import { Cast, Collection, Crew, Genre, ImageItem, Keyword, ProductionCompany, ProductionCountry, SpokenLanguage, VideoItem } from "./common";
+import { Cast, Changes, Collection, Crew, Genre, ImageItem, Keyword, ProductionCompany, ProductionCountry, SpokenLanguage, VideoItem } from "./common";
 import { ReleaseType } from "./enums";
+import { PaginatedResponse } from "./params";
 import { ISO3166Country } from "./utility";
 export type MovieDetails = {
     adult: boolean;
@@ -55,6 +56,7 @@ export type MovieAlternativeTitle = {
     iso_3166_1: string;
     type: string;
 };
+export type MovieChanges = Changes;
 export type MovieCredits = {
     id: number;
     cast: Cast[];
@@ -77,6 +79,8 @@ export type MovieImages = {
     logos: ImageItem[];
     posters: ImageItem[];
 };
+export type MovieRecommendations = PaginatedResponse<MovieResultItem>;
+export type MovieSimilar = PaginatedResponse<MovieResultItem>;
 export type MovieReleaseDates = {
     id: number;
     results: MovieReleaseDateResult[];
@@ -93,6 +97,22 @@ export type MovieReleaseDate = {
     note: string;
     descriptors: any[];
 };
+export type MovieReviews = PaginatedResponse<MovieReview>;
+export type MovieReview = {
+    author: string;
+    author_details: MovieReviewAuthorDetails;
+    content: string;
+    created_at: string;
+    id: string;
+    updated_at: string;
+    url: string;
+};
+export type MovieReviewAuthorDetails = {
+    name: string;
+    username: string;
+    avatar_path?: string;
+    rating?: number;
+};
 export type MovieTranslations = {
     id: number;
     translations: MovieTranslationResults[];
@@ -130,3 +150,22 @@ export type WatchProviderItem = {
     provider_name: string;
     display_priority: number;
 };
+/** Append To Response */
+export type MovieAppendToResponseNamespace = "alternative_titles" | "changes" | "credits" | "external_ids" | "images" | "keywords" | "recommendations" | "release_dates" | "reviews" | "similar" | "translations" | "videos";
+export type MovieAppendableMap = {
+    alternative_titles: MovieAlternativeTitles;
+    changes: MovieChanges;
+    credits: MovieCredits;
+    external_ids: MovieExternalIDs;
+    images: MovieImages;
+    keywords: MovieKeywords;
+    recommendations: MovieRecommendations;
+    release_dates: MovieReleaseDates;
+    reviews: MovieReviews;
+    similar: MovieSimilar;
+    translations: MovieTranslations;
+    videos: MovieVideos;
+};
+export type MovieDetailsWithAppends<T extends readonly MovieAppendToResponseNamespace[]> = MovieDetails & {
+    [K in T[number]]: MovieAppendableMap[K];
+};

package/dist/types/params.d.ts

@@ -1,5 +1,6 @@
 import { CountryISO3166_1 } from "./countries";
 import { LanguageISO6391 } from "./lang";
+import { MovieAppendToResponseNamespace } from "./movies";
 export type PaginatedResponse<T> = {
     page: number;
     total_pages: number;
@@ -22,10 +23,40 @@ export type MovieListParams = {
 };
 export type MovieDetailsParams = {
     movie_id: number;
-    append_to_response?: string[];
+    append_to_response?: MovieAppendToResponseNamespace[];
     language?: LanguageISO6391;
 };
 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;
+export type MovieReviewsParams = MovieRecommendationsParams;

package/package.json

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