@tdanks2000/tmdb-wrapper 1.5.0 → 1.6.0

package/dist/index.cjs

@@ -114,32 +114,42 @@ let ReleaseDateType = /* @__PURE__ */ function(ReleaseDateType$1) {
 //#endregion
 //#region src/utils/api.ts
 const BASE_URL_V3 = "https://api.themoviedb.org/3";
-/**
-* Lightweight TMDB v3 API client.
-*
-* - Sends requests to `https://api.themoviedb.org/3`.
-* - Supports authentication via:
-*   - v4 API Read Access Token (Bearer), and/or
-*   - v3 API key via `api_key` query parameter.
-*
-* Notes:
-* - Many endpoints accept either method depending on your TMDB settings.
-* - When an API key is present, it is appended as `api_key` in the query string.
-*/
+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 {
-	/**
-	* Optional v3 API key (sent as `api_key` query param).
-	*/
 	apiKey;
-	/**
-	* Optional v4 read access token (sent as `Authorization: Bearer ...`).
-	*/
 	accessToken;
-	/**
-	* Create a new API client.
-	*
-	* @param {TokenType} auth - Authentication information.
-	*/
 	constructor(auth) {
 		if (typeof auth === "string") this.accessToken = auth;
 		else {
@@ -147,58 +157,55 @@ var API = class {
 			this.accessToken = auth.accessToken;
 		}
 	}
-	/**
-	* Generic HTTP GET request.
-	*
-	* @template T - Response JSON type.
-	* @template O - Query options (query params) type.
-	*
-	* @param {string} path - The TMDB path beginning with `/`, e.g. `/movie/550`.
-	* @param {O} [options] - Query parameters to serialize.
-	*
-	* @returns {Promise<T>} Resolves with parsed JSON typed as `T`.
-	* @throws {ErrorResponse} Rejects with parsed TMDB error payload when `response.ok` is false.
-	*/
-	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();
 	}
 };
-/**
-* Serializes an options object into a query string.
-*
-* - Skips `undefined` and `null`.
-* - Arrays are expanded into repeated keys:
-*   `{ with_genres: ["12", "16"] }` -> `with_genres=12&with_genres=16`
-*
-* @param {Record<string, unknown>} [options] - Options to serialize.
-* @returns {string} Query string without the leading `?`.
-*/
-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
@@ -270,7 +277,7 @@ var BaseEndpoint = class {
 	*
 	* @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, depending on your {@link TokenType}.
+	* - If an object: can include an API key and/or access token.
 	*/
 	constructor(auth) {
 		this.auth = auth;
@@ -384,7 +391,7 @@ var ChangeEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<MediaChanges>} A Promise that resolves with the changes in movies.
 	*/
 	movies(options) {
-		return this.api.get("/movie/changes", options);
+		return this.api.get("/movie/changes", { query: options });
 	}
 	/**
 	* Retrieves changes in TV shows asynchronously.
@@ -395,7 +402,7 @@ var ChangeEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<MediaChanges>} A Promise that resolves with the changes in TV shows.
 	*/
 	tv(options) {
-		return this.api.get("/tv/changes", options);
+		return this.api.get("/tv/changes", { query: options });
 	}
 	/**
 	* Retrieves changes related to persons asynchronously.
@@ -406,7 +413,7 @@ var ChangeEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<MediaChanges>} A Promise that resolves with the changes related to persons.
 	*/
 	person(options) {
-		return this.api.get("/person/changes", options);
+		return this.api.get("/person/changes", { query: options });
 	}
 };
 
@@ -432,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.
@@ -445,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.
@@ -454,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 });
 	}
 };
 
@@ -574,7 +581,7 @@ var DiscoverEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<MovieDiscoverResult>} A Promise that resolves with the movie discovery results.
 	*/
 	movie(options) {
-		return this.api.get(`${BASE_DISCOVER}/movie`, options);
+		return this.api.get(`${BASE_DISCOVER}/movie`, { query: options });
 	}
 	/**
 	* Retrieves a list of TV shows based on the provided query options asynchronously.
@@ -585,7 +592,7 @@ var DiscoverEndpoint = class extends BaseEndpoint {
 	* @returns {Promise<TvShowDiscoverResult>} A Promise that resolves with the TV show discovery results.
 	*/
 	tvShow(options) {
-		return this.api.get(`${BASE_DISCOVER}/tv`, options);
+		return this.api.get(`${BASE_DISCOVER}/tv`, { query: options });
 	}
 };
 
@@ -610,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 });
 	}
 };
 
@@ -634,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.
@@ -642,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 });
 	}
 };
 
@@ -676,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 });
 	}
 };
 
@@ -703,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.
@@ -724,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.
@@ -733,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.
@@ -754,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.
@@ -771,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.
@@ -780,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.
@@ -797,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.
@@ -806,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.
@@ -823,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.
@@ -846,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.
@@ -854,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.
@@ -862,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.
@@ -870,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 });
 	}
 };
 
@@ -941,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.
@@ -950,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.
@@ -959,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.
@@ -968,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.
@@ -977,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.
@@ -1002,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.
@@ -1025,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 });
 	}
 };
 
@@ -1074,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.
@@ -1082,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.
@@ -1090,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.
@@ -1098,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.
@@ -1106,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.
@@ -1114,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.
@@ -1122,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 });
 	}
 };
 
@@ -1149,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 });
 	}
 };
 
@@ -1183,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.
@@ -1192,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.
@@ -1201,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.
@@ -1222,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.
@@ -1243,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 });
 	}
 };
 
@@ -1277,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.
@@ -1286,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.
@@ -1295,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.
@@ -1304,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.
@@ -1313,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.
@@ -1326,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.
@@ -1339,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.
@@ -1348,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 });
 	}
 };
 
@@ -1380,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.
@@ -1398,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.
@@ -1415,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.
@@ -1424,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.
@@ -1462,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.
@@ -1479,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.
@@ -1488,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.
@@ -1505,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.
@@ -1526,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.
@@ -1550,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.
@@ -1558,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.
@@ -1566,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.
@@ -1574,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 });
 	}
 };
 
@@ -1593,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
@@ -1684,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;