@tdanks2000/tmdb-wrapper 1.4.0 → 1.6.0

package/dist/index.cjs

@@ -114,6 +114,39 @@ let ReleaseDateType = /* @__PURE__ */ function(ReleaseDateType$1) {
 //#endregion
 //#region src/utils/api.ts
 const BASE_URL_V3 = "https://api.themoviedb.org/3";
+var TMDBError = class extends Error {
+	constructor(message, status, url, payload) {
+		super(message);
+		this.status = status;
+		this.url = url;
+		this.payload = payload;
+		this.name = "TMDBError";
+	}
+};
+const parseOptions = (options) => {
+	if (!options) return "";
+	const entries = [];
+	for (const [key, value] of Object.entries(options)) {
+		if (value === void 0 || value === null) continue;
+		if (Array.isArray(value)) for (const item of value) {
+			if (item === void 0 || item === null) continue;
+			entries.push([key, String(item)]);
+		}
+		else entries.push([key, String(value)]);
+	}
+	return new URLSearchParams(entries).toString();
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const shouldRetry = (status) => status === 429 || status === 502 || status === 503 || status === 504;
+const readRetryAfterMs = (res) => {
+	const raw = res.headers.get("retry-after");
+	if (!raw) return void 0;
+	const asSeconds = Number(raw);
+	if (Number.isFinite(asSeconds)) return Math.max(0, asSeconds * 1e3);
+	const asDate = Date.parse(raw);
+	if (!Number.isNaN(asDate)) return Math.max(0, asDate - Date.now());
+	return void 0;
+};
 var API = class {
 	apiKey;
 	accessToken;
@@ -124,41 +157,55 @@ var API = class {
 			this.accessToken = auth.accessToken;
 		}
 	}
-	/**
-	* Generic GET:
-	* @template T — response type
-	* @template O — options (query params) type
-	*/
-	async get(path, options) {
-		const rawOptions = {
-			...options ?? {},
+	async get(path, opts = {}) {
+		const query = {
+			...opts.query ? opts.query : {},
 			...this.apiKey ? { api_key: this.apiKey } : {}
 		};
-		const params = parseOptions(rawOptions);
-		const response = await fetch(`${BASE_URL_V3}${path}?${params}`, {
-			method: "GET",
-			headers: {
-				...this.accessToken ? { Authorization: `Bearer ${this.accessToken}` } : {},
-				"Content-Type": "application/json;charset=utf-8"
+		const qs = parseOptions(query);
+		const url = `${BASE_URL_V3}${path}${qs ? `?${qs}` : ""}`;
+		const retries = opts.retries ?? 2;
+		const retryDelayMs = opts.retryDelayMs ?? 300;
+		const timeoutMs = opts.timeoutMs ?? 3e4;
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), timeoutMs);
+		if (opts.signal) if (opts.signal.aborted) controller.abort();
+		else opts.signal.addEventListener("abort", () => controller.abort(), { once: true });
+		try {
+			for (let attempt = 0; attempt <= retries; attempt++) {
+				const res = await fetch(url, {
+					method: "GET",
+					signal: controller.signal,
+					headers: {
+						...this.accessToken ? { Authorization: `Bearer ${this.accessToken}` } : {},
+						Accept: "application/json"
+					}
+				});
+				if (res.ok) return await res.json();
+				let payload;
+				let message = `${res.status} ${res.statusText}`;
+				try {
+					payload = await res.json();
+					if (payload && typeof payload === "object" && "status_message" in payload) message = String(payload.status_message);
+				} catch {
+					try {
+						payload = await res.text();
+					} catch {}
+				}
+				if (attempt < retries && shouldRetry(res.status)) {
+					const retryAfter = readRetryAfterMs(res);
+					const delay = retryAfter ?? retryDelayMs * 2 ** attempt;
+					await sleep(delay);
+					continue;
+				}
+				throw new TMDBError(message, res.status, url, payload);
 			}
-		});
-		if (!response.ok) {
-			const error = await response.json();
-			return Promise.reject(error);
+			throw new TMDBError("Request failed", 0, url);
+		} finally {
+			clearTimeout(timeout);
 		}
-		return await response.json();
 	}
 };
-const parseOptions = (options) => {
-	if (!options) return "";
-	const entries = [];
-	for (const [key, value] of Object.entries(options)) {
-		if (value === void 0 || value === null) continue;
-		if (Array.isArray(value)) for (const item of value) entries.push([key, String(item)]);
-		else entries.push([key, String(value)]);
-	}
-	return new URLSearchParams(entries).toString();
-};
 
 //#endregion
 //#region src/utils/getimagePath.ts
@@ -215,8 +262,23 @@ const formImage = (image, fileSize, format) => {
 
 //#endregion
 //#region src/@types/models/baseEndpoint.ts
+/**
+* Base class for all TMDB API endpoints.
+*
+* Provides a configured {@link API} client instance to subclasses.
+*/
 var BaseEndpoint = class {
+	/**
+	* Low-level HTTP client wrapper used by all endpoints.
+	*/
 	api;
+	/**
+	* Create a new endpoint instance.
+	*
+	* @param {TokenType} auth - Authentication information.
+	* - If a string: treated as a v4 API Read Access Token (Bearer token).
+	* - If an object: can include an API key and/or access token.
+	*/
 	constructor(auth) {
 		this.auth = auth;
 		this.api = new API(auth);
@@ -227,11 +289,20 @@ var BaseEndpoint = class {
 //#region src/endpoints/account.ts
 /**
 * Represents an endpoint for retrieving account details.
+*
+* TMDB v3 reference:
+* - GET /account/{account_id}
+*
+* Note:
+* TMDB does not expose a generic "GET /account" for account details. You must
+* provide an `account_id`. Most apps obtain it from an auth flow and then cache
+* it for subsequent requests.
 */
 var AccountEndpoint = class extends BaseEndpoint {
 	/**
 	* Constructs a new AccountEndpoint instance.
-	* @param {string} access_token - The access token used for authentication.
+	*
+	* @param {TokenType} access_token - The access token used for authentication.
 	*/
 	constructor(access_token) {
 		super(access_token);
@@ -239,10 +310,14 @@ var AccountEndpoint = class extends BaseEndpoint {
 	}
 	/**
 	* Retrieves account details asynchronously.
+	*
+	* TMDB: GET /account/{account_id}
+	*
+	* @param {number} accountId - The TMDB account ID.
 	* @returns {Promise<AccountDetails>} A Promise that resolves with the account details.
 	*/
-	async details() {
-		return await this.api.get("/account");
+	details(accountId) {
+		return this.api.get(`/account/${accountId}`);
 	}
 };
 
@@ -250,11 +325,16 @@ var AccountEndpoint = class extends BaseEndpoint {
 //#region src/endpoints/certification.ts
 /**
 * Represents an endpoint for retrieving certifications for movies and TV shows.
+*
+* TMDB v3 reference:
+* - GET /certification/movie/list
+* - GET /certification/tv/list
 */
 var CertificationEndpoint = class extends BaseEndpoint {
 	/**
 	* Constructs a new CertificationEndpoint instance.
-	* @param {string} access_token - The access token used for authentication.
+	*
+	* @param {TokenType} access_token - The access token used for authentication.
 	*/
 	constructor(access_token) {
 		super(access_token);
@@ -262,17 +342,23 @@ var CertificationEndpoint = class extends BaseEndpoint {
 	}
 	/**
 	* Retrieves certifications for movies asynchronously.
+	*
+	* TMDB: GET /certification/movie/list
+	*
 	* @returns {Promise<Certifications>} A Promise that resolves with the certifications for movies.
 	*/
-	async movies() {
-		return await this.api.get("/certification/movie/list");
+	movies() {
+		return this.api.get("/certification/movie/list");
 	}
 	/**
 	* Retrieves certifications for TV shows asynchronously.
+	*
+	* TMDB: GET /certification/tv/list
+	*
 	* @returns {Promise<Certifications>} A Promise that resolves with the certifications for TV shows.
 	*/
-	async tv() {
-		return await this.api.get("/certification/tv/list");
+	tv() {
+		return this.api.get("/certification/tv/list");
 	}
 };
 
@@ -280,11 +366,17 @@ var CertificationEndpoint = class extends BaseEndpoint {
 //#region src/endpoints/changes.ts
 /**
 * Represents an endpoint for retrieving changes in movies, TV shows, and persons.
+*
+* TMDB v3 reference:
+* - GET /movie/changes
+* - GET /tv/changes
+* - GET /person/changes
 */
 var ChangeEndpoint = class extends BaseEndpoint {
 	/**
 	* Constructs a new ChangeEndpoint instance.
-	* @param {string} access_token - The access token used for authentication.
+	*
+	* @param {TokenType} access_token - The access token used for authentication.
 	*/
 	constructor(access_token) {
 		super(access_token);
@@ -292,27 +384,36 @@ var ChangeEndpoint = class extends BaseEndpoint {
 	}
 	/**
 	* Retrieves changes in movies asynchronously.
+	*
+	* TMDB: GET /movie/changes
+	*
 	* @param {ChangeOption} [options] - Optional parameters for filtering the changes.
 	* @returns {Promise<MediaChanges>} A Promise that resolves with the changes in movies.
 	*/
-	async movies(options) {
-		return await this.api.get("/movie/changes", options);
+	movies(options) {
+		return this.api.get("/movie/changes", { query: options });
 	}
 	/**
 	* Retrieves changes in TV shows asynchronously.
+	*
+	* TMDB: GET /tv/changes
+	*
 	* @param {ChangeOption} [options] - Optional parameters for filtering the changes.
 	* @returns {Promise<MediaChanges>} A Promise that resolves with the changes in TV shows.
 	*/
-	async tv(options) {
-		return await this.api.get("/tv/changes", options);
+	tv(options) {
+		return this.api.get("/tv/changes", { query: options });
 	}
 	/**
 	* Retrieves changes related to persons asynchronously.
+	*
+	* TMDB: GET /person/changes
+	*
 	* @param {ChangeOption} [options] - Optional parameters for filtering the changes.
 	* @returns {Promise<MediaChanges>} A Promise that resolves with the changes related to persons.
 	*/
-	async person(options) {
-		return await this.api.get("/person/changes", options);
+	person(options) {
+		return this.api.get("/person/changes", { query: options });
 	}
 };
 
@@ -338,7 +439,7 @@ var CollectionsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<DetailedCollection>} A Promise that resolves with the detailed information of the collection.
 	*/
 	async details(id, options) {
-		return await this.api.get(`${BASE_COLLECTION}/${id}`, options);
+		return await this.api.get(`${BASE_COLLECTION}/${id}`, { query: options });
 	}
 	/**
 	* Retrieves images associated with a specific collection asynchronously.
@@ -351,7 +452,7 @@ var CollectionsEndpoint = class extends BaseEndpoint {
 			include_image_language: options?.include_image_language?.join(","),
 			language: options?.language
 		};
-		return await this.api.get(`${BASE_COLLECTION}/${id}/images`, computedOptions);
+		return await this.api.get(`${BASE_COLLECTION}/${id}/images`, { query: computedOptions });
 	}
 	/**
 	* Retrieves translations for a specific collection asynchronously.
@@ -360,7 +461,7 @@ var CollectionsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Translations>} A Promise that resolves with the translations of the collection.
 	*/
 	async translations(id, options) {
-		return await this.api.get(`${BASE_COLLECTION}/${id}/translations`, options);
+		return await this.api.get(`${BASE_COLLECTION}/${id}/translations`, { query: options });
 	}
 };
 
@@ -456,11 +557,16 @@ var CreditsEndpoint = class extends BaseEndpoint {
 const BASE_DISCOVER = "/discover";
 /**
 * Represents an endpoint for discovering movies and TV shows based on various criteria.
+*
+* TMDB v3 reference:
+* - GET /discover/movie
+* - GET /discover/tv
 */
 var DiscoverEndpoint = class extends BaseEndpoint {
 	/**
 	* Constructs a new DiscoverEndpoint instance.
-	* @param {string} access_token - The access token used for authentication.
+	*
+	* @param {TokenType} access_token - The access token used for authentication.
 	*/
 	constructor(access_token) {
 		super(access_token);
@@ -468,19 +574,25 @@ var DiscoverEndpoint = class extends BaseEndpoint {
 	}
 	/**
 	* Retrieves a list of movies based on the provided query options asynchronously.
+	*
+	* TMDB: GET /discover/movie
+	*
 	* @param {MovieQueryOptions} [options] - Optional parameters for refining the movie discovery.
 	* @returns {Promise<MovieDiscoverResult>} A Promise that resolves with the movie discovery results.
 	*/
-	async movie(options) {
-		return await this.api.get(`${BASE_DISCOVER}/movie`, options);
+	movie(options) {
+		return this.api.get(`${BASE_DISCOVER}/movie`, { query: options });
 	}
 	/**
 	* Retrieves a list of TV shows based on the provided query options asynchronously.
+	*
+	* TMDB: GET /discover/tv
+	*
 	* @param {TvShowQueryOptions} [options] - Optional parameters for refining the TV show discovery.
 	* @returns {Promise<TvShowDiscoverResult>} A Promise that resolves with the TV show discovery results.
 	*/
-	async tvShow(options) {
-		return await this.api.get(`${BASE_DISCOVER}/tv`, options);
+	tvShow(options) {
+		return this.api.get(`${BASE_DISCOVER}/tv`, { query: options });
 	}
 };
 
@@ -505,7 +617,7 @@ var FindEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<FindResult>} A Promise that resolves with the result of the find operation.
 	*/
 	async byId(externalId, options) {
-		return await this.api.get(`/find/${externalId}`, options);
+		return await this.api.get(`/find/${externalId}`, { query: options });
 	}
 };
 
@@ -529,7 +641,7 @@ var GenreEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Genres>} A Promise that resolves with the genre information for movies.
 	*/
 	async movies(options) {
-		return await this.api.get("/genre/movie/list", options);
+		return await this.api.get("/genre/movie/list", { query: options });
 	}
 	/**
 	* Retrieves genre information for TV shows asynchronously.
@@ -537,7 +649,7 @@ var GenreEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Genres>} A Promise that resolves with the genre information for TV shows.
 	*/
 	async tv(options) {
-		return await this.api.get("/genre/tv/list", options);
+		return await this.api.get("/genre/tv/list", { query: options });
 	}
 };
 
@@ -571,7 +683,7 @@ var KeywordsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<BelongingMovies>} A Promise that resolves with the movies belonging to the keyword.
 	*/
 	async belongingMovies(keywordId, options) {
-		return await this.api.get(`${BASE_KEYWORD}/${keywordId}/movies`, options);
+		return await this.api.get(`${BASE_KEYWORD}/${keywordId}/movies`, { query: options });
 	}
 };
 
@@ -598,11 +710,11 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<AppendToResponse<MovieDetails, AppendToResponseMovieKey[], 'movie'>>} A Promise that resolves with the details of the movie.
 	*/
 	async details(id, appendToResponse, language) {
-		const options = {
+		const query = {
 			append_to_response: appendToResponse ? appendToResponse.join(",") : void 0,
 			language
 		};
-		return await this.api.get(`${BASE_MOVIE}/${id}`, options);
+		return await this.api.get(`${BASE_MOVIE}/${id}`, { query });
 	}
 	/**
 	* Retrieves alternative titles of a specific movie asynchronously.
@@ -619,7 +731,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Changes<MovieChangeValue>>} A Promise that resolves with the changes made to the movie.
 	*/
 	async changes(id, options) {
-		return await this.api.get(`${BASE_MOVIE}/${id}/changes`, options);
+		return await this.api.get(`${BASE_MOVIE}/${id}/changes`, { query: options });
 	}
 	/**
 	* Retrieves credits of a specific movie asynchronously.
@@ -628,7 +740,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Credits>} A Promise that resolves with the credits of the movie.
 	*/
 	async credits(id, options) {
-		return await this.api.get(`${BASE_MOVIE}/${id}/credits`, options);
+		return await this.api.get(`${BASE_MOVIE}/${id}/credits`, { query: options });
 	}
 	/**
 	* Retrieves external IDs of a specific movie asynchronously.
@@ -649,7 +761,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 			include_image_language: options?.include_image_language?.join(","),
 			language: options?.language
 		};
-		return await this.api.get(`${BASE_MOVIE}/${id}/images`, computedOptions);
+		return await this.api.get(`${BASE_MOVIE}/${id}/images`, { query: computedOptions });
 	}
 	/**
 	* Retrieves keywords of a specific movie asynchronously.
@@ -666,7 +778,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<MovieLists>} A Promise that resolves with the lists containing the movie.
 	*/
 	async lists(id, options) {
-		return await this.api.get(`${BASE_MOVIE}/${id}/lists`, options);
+		return await this.api.get(`${BASE_MOVIE}/${id}/lists`, { query: options });
 	}
 	/**
 	* Retrieves recommendations for a specific movie asynchronously.
@@ -675,7 +787,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Recommendations>} A Promise that resolves with the recommendations for the movie.
 	*/
 	async recommendations(id, options) {
-		return await this.api.get(`${BASE_MOVIE}/${id}/recommendations`, options);
+		return await this.api.get(`${BASE_MOVIE}/${id}/recommendations`, { query: options });
 	}
 	/**
 	* Retrieves release dates of a specific movie asynchronously.
@@ -692,7 +804,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Reviews>} A Promise that resolves with the reviews for the movie.
 	*/
 	async reviews(id, options) {
-		return await this.api.get(`${BASE_MOVIE}/${id}/reviews`, options);
+		return await this.api.get(`${BASE_MOVIE}/${id}/reviews`, { query: options });
 	}
 	/**
 	* Retrieves similar movies for a specific movie asynchronously.
@@ -701,7 +813,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<SimilarMovies>} A Promise that resolves with the similar movies for the movie.
 	*/
 	async similar(id, options) {
-		return await this.api.get(`${BASE_MOVIE}/${id}/similar`, options);
+		return await this.api.get(`${BASE_MOVIE}/${id}/similar`, { query: options });
 	}
 	/**
 	* Retrieves translations of a specific movie asynchronously.
@@ -718,7 +830,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Videos>} A Promise that resolves with the videos of the movie.
 	*/
 	async videos(id, options) {
-		return await this.api.get(`${BASE_MOVIE}/${id}/videos`, options);
+		return await this.api.get(`${BASE_MOVIE}/${id}/videos`, { query: options });
 	}
 	/**
 	* Retrieves watch providers of a specific movie asynchronously.
@@ -741,7 +853,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<MoviesPlayingNow>} A Promise that resolves with the movies playing now.
 	*/
 	async nowPlaying(options) {
-		return await this.api.get(`${BASE_MOVIE}/now_playing`, options);
+		return await this.api.get(`${BASE_MOVIE}/now_playing`, { query: options });
 	}
 	/**
 	* Retrieves popular movies asynchronously.
@@ -749,7 +861,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<PopularMovies>} A Promise that resolves with the popular movies.
 	*/
 	async popular(options) {
-		return await this.api.get(`${BASE_MOVIE}/popular`, options);
+		return await this.api.get(`${BASE_MOVIE}/popular`, { query: options });
 	}
 	/**
 	* Retrieves top rated movies asynchronously.
@@ -757,7 +869,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<TopRatedMovies>} A Promise that resolves with the top rated movies.
 	*/
 	async topRated(options) {
-		return await this.api.get(`${BASE_MOVIE}/top_rated`, options);
+		return await this.api.get(`${BASE_MOVIE}/top_rated`, { query: options });
 	}
 	/**
 	* Retrieves upcoming movies asynchronously.
@@ -765,7 +877,7 @@ var MoviesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<UpcomingMovies>} A Promise that resolves with the upcoming movies.
 	*/
 	async upcoming(options) {
-		return await this.api.get(`${BASE_MOVIE}/upcoming`, options);
+		return await this.api.get(`${BASE_MOVIE}/upcoming`, { query: options });
 	}
 };
 
@@ -836,7 +948,7 @@ var PeopleEndpoint = class extends BaseEndpoint {
 			append_to_response: appendToResponse ? appendToResponse.join(",") : void 0,
 			language
 		};
-		return await this.api.get(`${BASE_PERSON}/${id}`, options);
+		return await this.api.get(`${BASE_PERSON}/${id}`, { query: options });
 	}
 	/**
 	* Retrieves changes made to a specific person asynchronously.
@@ -845,7 +957,7 @@ var PeopleEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Changes<PersonChangeValue>>} A Promise that resolves with the changes made to the person.
 	*/
 	async changes(id, options) {
-		return await this.api.get(`${BASE_PERSON}/${id}/changes`, options);
+		return await this.api.get(`${BASE_PERSON}/${id}/changes`, { query: options });
 	}
 	/**
 	* Retrieves movie credits of a specific person asynchronously.
@@ -854,7 +966,7 @@ var PeopleEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<PersonMovieCredit>} A Promise that resolves with the movie credits of the person.
 	*/
 	async movieCredits(id, options) {
-		return await this.api.get(`${BASE_PERSON}/${id}/movie_credits`, options);
+		return await this.api.get(`${BASE_PERSON}/${id}/movie_credits`, { query: options });
 	}
 	/**
 	* Retrieves TV show credits of a specific person asynchronously.
@@ -863,7 +975,7 @@ var PeopleEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<PersonTvShowCredit>} A Promise that resolves with the TV show credits of the person.
 	*/
 	async tvShowCredits(id, options) {
-		return await this.api.get(`${BASE_PERSON}/${id}/tv_credits`, options);
+		return await this.api.get(`${BASE_PERSON}/${id}/tv_credits`, { query: options });
 	}
 	/**
 	* Retrieves combined credits of a specific person asynchronously.
@@ -872,7 +984,7 @@ var PeopleEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<PersonCombinedCredits>} A Promise that resolves with the combined credits of the person.
 	*/
 	async combinedCredits(id, options) {
-		return await this.api.get(`${BASE_PERSON}/${id}/combined_credits`, options);
+		return await this.api.get(`${BASE_PERSON}/${id}/combined_credits`, { query: options });
 	}
 	/**
 	* Retrieves external IDs of a specific person asynchronously.
@@ -897,7 +1009,7 @@ var PeopleEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<TaggedImages>} A Promise that resolves with the tagged images of the person.
 	*/
 	async taggedImages(id, options) {
-		return await this.api.get(`${BASE_PERSON}/${id}/tagged_images`, options);
+		return await this.api.get(`${BASE_PERSON}/${id}/tagged_images`, { query: options });
 	}
 	/**
 	* Retrieves translations of a specific person asynchronously.
@@ -920,7 +1032,7 @@ var PeopleEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<PopularPersons>} A Promise that resolves with the popular persons.
 	*/
 	async popular(options) {
-		return await this.api.get(`${BASE_PERSON}/popular`, options);
+		return await this.api.get(`${BASE_PERSON}/popular`, { query: options });
 	}
 };
 
@@ -969,7 +1081,7 @@ var SearchEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Search<Company>>} A Promise that resolves with the search results for companies.
 	*/
 	async companies(options) {
-		return await this.api.get(`${BASE_SEARCH}/company`, options);
+		return await this.api.get(`${BASE_SEARCH}/company`, { query: options });
 	}
 	/**
 	* Searches for collections asynchronously.
@@ -977,7 +1089,7 @@ var SearchEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Search<Collection>>} A Promise that resolves with the search results for collections.
 	*/
 	async collections(options) {
-		return await this.api.get(`${BASE_SEARCH}/collection`, options);
+		return await this.api.get(`${BASE_SEARCH}/collection`, { query: options });
 	}
 	/**
 	* Searches for keywords asynchronously.
@@ -985,7 +1097,7 @@ var SearchEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Search<{ id: string; name: string }>>} A Promise that resolves with the search results for keywords.
 	*/
 	async keywords(options) {
-		return await this.api.get(`${BASE_SEARCH}/keyword`, options);
+		return await this.api.get(`${BASE_SEARCH}/keyword`, { query: options });
 	}
 	/**
 	* Searches for movies asynchronously.
@@ -993,7 +1105,7 @@ var SearchEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Search<Movie>>} A Promise that resolves with the search results for movies.
 	*/
 	async movies(options) {
-		return await this.api.get(`${BASE_SEARCH}/movie`, options);
+		return await this.api.get(`${BASE_SEARCH}/movie`, { query: options });
 	}
 	/**
 	* Searches for people asynchronously.
@@ -1001,7 +1113,7 @@ var SearchEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Search<Person>>} A Promise that resolves with the search results for people.
 	*/
 	async people(options) {
-		return await this.api.get(`${BASE_SEARCH}/person`, options);
+		return await this.api.get(`${BASE_SEARCH}/person`, { query: options });
 	}
 	/**
 	* Searches for TV shows asynchronously.
@@ -1009,7 +1121,7 @@ var SearchEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Search<TV>>} A Promise that resolves with the search results for TV shows.
 	*/
 	async tv(options) {
-		return await this.api.get(`${BASE_SEARCH}/tv`, options);
+		return await this.api.get(`${BASE_SEARCH}/tv`, { query: options });
 	}
 	/**
 	* Performs a multi-search asynchronously.
@@ -1017,7 +1129,7 @@ var SearchEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Search<MultiSearchResult>>} A Promise that resolves with the multi-search results.
 	*/
 	async multi(options) {
-		return await this.api.get(`${BASE_SEARCH}/multi`, options);
+		return await this.api.get(`${BASE_SEARCH}/multi`, { query: options });
 	}
 };
 
@@ -1044,7 +1156,7 @@ var TrendingEndpoint = class extends BaseEndpoint {
 	* @template T - The type of media being searched for (e.g., 'movie', 'tv').
 	*/
 	async trending(mediaType, timeWindow, options) {
-		return await this.api.get(`/trending/${mediaType}/${timeWindow}`, options);
+		return await this.api.get(`/trending/${mediaType}/${timeWindow}`, { query: options });
 	}
 };
 
@@ -1078,7 +1190,7 @@ var TvEpisodesEndpoint = class extends BaseEndpoint {
 			append_to_response: appendToResponse ? appendToResponse.join(",") : void 0,
 			...options
 		};
-		return await this.api.get(`${BASE_EPISODE(episodeSelection)}`, combinedOptions);
+		return await this.api.get(`${BASE_EPISODE(episodeSelection)}`, { query: combinedOptions });
 	}
 	/**
 	* Retrieves changes related to a specific TV episode asynchronously.
@@ -1087,7 +1199,7 @@ var TvEpisodesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Changes<TvEpisodeChangeValue>>} A Promise that resolves with the changes related to the TV episode.
 	*/
 	async changes(episodeID, options) {
-		return await this.api.get(`/tv/episode/${episodeID}/changes`, options);
+		return await this.api.get(`/tv/episode/${episodeID}/changes`, { query: options });
 	}
 	/**
 	* Retrieves credits for a specific TV episode asynchronously.
@@ -1096,7 +1208,7 @@ var TvEpisodesEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<TvEpisodeCredit>} A Promise that resolves with the credits for the TV episode.
 	*/
 	async credits(episodeSelection, options) {
-		return await this.api.get(`${BASE_EPISODE(episodeSelection)}/credits`, options);
+		return await this.api.get(`${BASE_EPISODE(episodeSelection)}/credits`, { query: options });
 	}
 	/**
 	* Retrieves external IDs for a specific TV episode asynchronously.
@@ -1117,7 +1229,7 @@ var TvEpisodesEndpoint = class extends BaseEndpoint {
 			include_image_language: options?.include_image_language?.join(","),
 			language: options?.language
 		};
-		return await this.api.get(`${BASE_EPISODE(episodeSelection)}/images`, computedOptions);
+		return await this.api.get(`${BASE_EPISODE(episodeSelection)}/images`, { query: computedOptions });
 	}
 	/**
 	* Retrieves translations for a specific TV episode asynchronously.
@@ -1138,7 +1250,7 @@ var TvEpisodesEndpoint = class extends BaseEndpoint {
 			include_video_language: options?.include_video_language?.join(","),
 			language: options?.language
 		};
-		return await this.api.get(`${BASE_EPISODE(episodeSelection)}/videos`, computedOptions);
+		return await this.api.get(`${BASE_EPISODE(episodeSelection)}/videos`, { query: computedOptions });
 	}
 };
 
@@ -1172,7 +1284,7 @@ var TvSeasonsEndpoint = class extends BaseEndpoint {
 			append_to_response: appendToResponse ? appendToResponse.join(",") : void 0,
 			...options
 		};
-		return await this.api.get(`${BASE_SEASON(seasonSelection)}`, combinedOptions);
+		return await this.api.get(`${BASE_SEASON(seasonSelection)}`, { query: combinedOptions });
 	}
 	/**
 	* Retrieves aggregate credits for a specific TV season asynchronously.
@@ -1181,7 +1293,7 @@ var TvSeasonsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<AggregateCredits>} A Promise that resolves with the aggregate credits for the TV season.
 	*/
 	async aggregateCredits(seasonSelection, options) {
-		return await this.api.get(`${BASE_SEASON(seasonSelection)}/aggregate_credits`, options);
+		return await this.api.get(`${BASE_SEASON(seasonSelection)}/aggregate_credits`, { query: options });
 	}
 	/**
 	* Retrieves changes related to a specific TV season asynchronously.
@@ -1190,7 +1302,7 @@ var TvSeasonsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Changes<TvSeasonChangeValue>>} A Promise that resolves with the changes related to the TV season.
 	*/
 	async changes(seasonId, options) {
-		return await this.api.get(`/tv/season/${seasonId}/changes`, options);
+		return await this.api.get(`/tv/season/${seasonId}/changes`, { query: options });
 	}
 	/**
 	* Retrieves credits for a specific TV season asynchronously.
@@ -1199,7 +1311,7 @@ var TvSeasonsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Credits>} A Promise that resolves with the credits for the TV season.
 	*/
 	async credits(seasonSelection, options) {
-		return await this.api.get(`${BASE_SEASON(seasonSelection)}/credits`, options);
+		return await this.api.get(`${BASE_SEASON(seasonSelection)}/credits`, { query: options });
 	}
 	/**
 	* Retrieves external IDs for a specific TV season asynchronously.
@@ -1208,7 +1320,7 @@ var TvSeasonsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<ExternalIds>} A Promise that resolves with the external IDs for the TV season.
 	*/
 	async externalIds(seasonSelection, options) {
-		return await this.api.get(`${BASE_SEASON(seasonSelection)}/external_ids`, options);
+		return await this.api.get(`${BASE_SEASON(seasonSelection)}/external_ids`, { query: options });
 	}
 	/**
 	* Retrieves images for a specific TV season asynchronously.
@@ -1221,7 +1333,7 @@ var TvSeasonsEndpoint = class extends BaseEndpoint {
 			include_image_language: options?.include_image_language?.join(","),
 			language: options?.language
 		};
-		return await this.api.get(`${BASE_SEASON(seasonSelection)}/images`, computedOptions);
+		return await this.api.get(`${BASE_SEASON(seasonSelection)}/images`, { query: computedOptions });
 	}
 	/**
 	* Retrieves videos for a specific TV season asynchronously.
@@ -1234,7 +1346,7 @@ var TvSeasonsEndpoint = class extends BaseEndpoint {
 			include_video_language: options?.include_video_language?.join(","),
 			language: options?.language
 		};
-		return await this.api.get(`${BASE_SEASON(seasonSelection)}/videos`, computedOptions);
+		return await this.api.get(`${BASE_SEASON(seasonSelection)}/videos`, { query: computedOptions });
 	}
 	/**
 	* Retrieves translations for a specific TV season asynchronously.
@@ -1243,7 +1355,7 @@ var TvSeasonsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Translations>} A Promise that resolves with the translations for the TV season.
 	*/
 	async translations(seasonSelection, options) {
-		return await this.api.get(`${BASE_SEASON(seasonSelection)}/translations`, options);
+		return await this.api.get(`${BASE_SEASON(seasonSelection)}/translations`, { query: options });
 	}
 };
 
@@ -1275,7 +1387,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 			append_to_response: appendToResponse ? appendToResponse.join(",") : void 0,
 			language
 		};
-		return await this.api.get(`${BASE_TV}/${id}`, options);
+		return await this.api.get(`${BASE_TV}/${id}`, { query: options });
 	}
 	/**
 	* Retrieves alternative titles of a specific TV show asynchronously.
@@ -1293,7 +1405,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* A Promise that resolves with the changes for the TV show.
 	*/
 	async changes(id, options) {
-		return await this.api.get(`${BASE_TV}/${id}/changes`, options);
+		return await this.api.get(`${BASE_TV}/${id}/changes`, { query: options });
 	}
 	/**
 	* Retrieves content ratings for a specific TV show asynchronously.
@@ -1310,7 +1422,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<AggregateCredits>} A Promise that resolves with the aggregate credits of the TV show.
 	*/
 	async aggregateCredits(id, options) {
-		return await this.api.get(`${BASE_TV}/${id}/aggregate_credits`, options);
+		return await this.api.get(`${BASE_TV}/${id}/aggregate_credits`, { query: options });
 	}
 	/**
 	* Retrieves credits for a specific TV show asynchronously.
@@ -1319,7 +1431,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Credits>} A Promise that resolves with the credits of the TV show.
 	*/
 	async credits(id, options) {
-		return await this.api.get(`${BASE_TV}/${id}/credits`, options);
+		return await this.api.get(`${BASE_TV}/${id}/credits`, { query: options });
 	}
 	/**
 	* Retrieves details of a specific season of a TV show asynchronously.
@@ -1357,7 +1469,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 			include_image_language: options?.include_image_language?.join(","),
 			language: options?.language
 		};
-		return await this.api.get(`${BASE_TV}/${id}/images`, computedOptions);
+		return await this.api.get(`${BASE_TV}/${id}/images`, { query: computedOptions });
 	}
 	/**
 	* Retrieves keywords for a specific TV show asynchronously.
@@ -1374,7 +1486,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Recommendations>} A Promise that resolves with the recommendations for the TV show.
 	*/
 	async recommendations(id, options) {
-		return await this.api.get(`${BASE_TV}/${id}/recommendations`, options);
+		return await this.api.get(`${BASE_TV}/${id}/recommendations`, { query: options });
 	}
 	/**
 	* Retrieves reviews for a specific TV show asynchronously.
@@ -1383,7 +1495,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Reviews>} A Promise that resolves with the reviews of the TV show.
 	*/
 	async reviews(id, options) {
-		return await this.api.get(`${BASE_TV}/${id}/reviews`, options);
+		return await this.api.get(`${BASE_TV}/${id}/reviews`, { query: options });
 	}
 	/**
 	* Retrieves information about whether the TV show was screened theatrically asynchronously.
@@ -1400,7 +1512,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Similartv>} A Promise that resolves with the similar TV shows.
 	*/
 	async similar(id, options) {
-		return await this.api.get(`${BASE_TV}/${id}/similar`, options);
+		return await this.api.get(`${BASE_TV}/${id}/similar`, { query: options });
 	}
 	/**
 	* Retrieves translations for a specific TV show asynchronously.
@@ -1421,7 +1533,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 			include_video_language: options?.include_video_language?.join(","),
 			language: options?.language
 		};
-		return await this.api.get(`${BASE_TV}/${id}/videos`, computedOptions);
+		return await this.api.get(`${BASE_TV}/${id}/videos`, { query: computedOptions });
 	}
 	/**
 	* Retrieves watch providers for a specific TV show asynchronously.
@@ -1445,7 +1557,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<OnTheAir>} A Promise that resolves with TV shows currently on the air.
 	*/
 	async onTheAir(options) {
-		return await this.api.get(`${BASE_TV}/on_the_air`, options);
+		return await this.api.get(`${BASE_TV}/on_the_air`, { query: options });
 	}
 	/**
 	* Retrieves TV shows that are airing today asynchronously.
@@ -1453,7 +1565,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<tvAiringToday>} A Promise that resolves with TV shows airing today.
 	*/
 	async airingToday(options) {
-		return await this.api.get(`${BASE_TV}/airing_today`, options);
+		return await this.api.get(`${BASE_TV}/airing_today`, { query: options });
 	}
 	/**
 	* Retrieves popular TV shows asynchronously.
@@ -1461,7 +1573,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<Populartv>} A Promise that resolves with popular TV shows.
 	*/
 	async popular(options) {
-		return await this.api.get(`${BASE_TV}/popular`, options);
+		return await this.api.get(`${BASE_TV}/popular`, { query: options });
 	}
 	/**
 	* Retrieves top-rated TV shows asynchronously.
@@ -1469,7 +1581,7 @@ var TvShowsEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<TopRatedtv>} A Promise that resolves with top-rated TV shows.
 	*/
 	async topRated(options) {
-		return await this.api.get(`${BASE_TV}/top_rated`, options);
+		return await this.api.get(`${BASE_TV}/top_rated`, { query: options });
 	}
 };
 
@@ -1488,33 +1600,26 @@ var WatchProvidersEndpoint = class extends BaseEndpoint {
 		this.access_token = access_token;
 	}
 	/**
-	* Retrieves a list of all available watch providers (streaming services).
-	* @returns {Promise<WatchProviders>} A Promise that resolves with the list of watch providers.
-	*/
-	async available() {
-		return await this.api.get("/watch/providers/movie");
-	}
-	/**
-	* Retrieves a list of available regions for watch providers.
-	* @returns {Promise<WatchRegionsResponse>} A Promise that resolves with the list of available regions.
-	*/
-	async regions() {
-		return await this.api.get("/watch/providers/regions");
-	}
-	/**
 	* Retrieves a list of watch providers for movies.
-	* @returns {Promise<WatchProviders>} A Promise that resolves with the list of movie watch providers.
+	* @returns {Promise<WatchProviderListResponse>} A Promise that resolves with the list of movie watch providers.
 	*/
 	async movie() {
 		return await this.api.get("/watch/providers/movie");
 	}
 	/**
 	* Retrieves a list of watch providers for TV shows.
-	* @returns {Promise<WatchProviders>} A Promise that resolves with the list of TV watch providers.
+	* @returns {Promise<WatchProviderListResponse>} A Promise that resolves with the list of TV watch providers.
 	*/
 	async tv() {
 		return await this.api.get("/watch/providers/tv");
 	}
+	/**
+	* Retrieves a list of available regions for watch providers.
+	* @returns {Promise<WatchProviderListResponse>} A Promise that resolves with the list of available regions.
+	*/
+	async regions() {
+		return await this.api.get("/watch/providers/regions");
+	}
 };
 
 //#endregion
@@ -1579,6 +1684,7 @@ exports.ProfileSizes = ProfileSizes;
 exports.ReleaseDateType = ReleaseDateType;
 exports.StillSizes = StillSizes;
 exports.TMDB = TMDB;
+exports.TMDBError = TMDBError;
 exports.TMDB_IMAGE_BASE_URL = TMDB_IMAGE_BASE_URL;
 exports.formImage = formImage;
 exports.getFullImagePath = getFullImagePath;