@tdanks2000/tmdb-wrapper 1.5.0 → 1.6.0

package/dist/index.mjs

@@ -113,32 +113,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 {
@@ -146,58 +156,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
@@ -269,7 +276,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;
@@ -383,7 +390,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.
@@ -394,7 +401,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.
@@ -405,7 +412,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 });
 	}
 };
 
@@ -431,7 +438,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.
@@ -444,7 +451,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.
@@ -453,7 +460,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 });
 	}
 };
 
@@ -573,7 +580,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.
@@ -584,7 +591,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 });
 	}
 };
 
@@ -609,7 +616,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 });
 	}
 };
 
@@ -633,7 +640,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.
@@ -641,7 +648,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 });
 	}
 };
 
@@ -675,7 +682,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 });
 	}
 };
 
@@ -702,11 +709,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.
@@ -723,7 +730,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.
@@ -732,7 +739,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.
@@ -753,7 +760,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.
@@ -770,7 +777,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.
@@ -779,7 +786,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.
@@ -796,7 +803,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.
@@ -805,7 +812,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.
@@ -822,7 +829,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.
@@ -845,7 +852,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.
@@ -853,7 +860,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.
@@ -861,7 +868,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.
@@ -869,7 +876,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 });
 	}
 };
 
@@ -940,7 +947,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.
@@ -949,7 +956,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.
@@ -958,7 +965,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.
@@ -967,7 +974,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.
@@ -976,7 +983,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.
@@ -1001,7 +1008,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.
@@ -1024,7 +1031,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 });
 	}
 };
 
@@ -1073,7 +1080,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.
@@ -1081,7 +1088,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.
@@ -1089,7 +1096,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.
@@ -1097,7 +1104,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.
@@ -1105,7 +1112,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.
@@ -1113,7 +1120,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.
@@ -1121,7 +1128,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 });
 	}
 };
 
@@ -1148,7 +1155,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 });
 	}
 };
 
@@ -1182,7 +1189,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.
@@ -1191,7 +1198,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.
@@ -1200,7 +1207,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.
@@ -1221,7 +1228,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.
@@ -1242,7 +1249,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 });
 	}
 };
 
@@ -1276,7 +1283,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.
@@ -1285,7 +1292,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.
@@ -1294,7 +1301,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.
@@ -1303,7 +1310,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.
@@ -1312,7 +1319,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.
@@ -1325,7 +1332,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.
@@ -1338,7 +1345,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.
@@ -1347,7 +1354,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 });
 	}
 };
 
@@ -1379,7 +1386,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.
@@ -1397,7 +1404,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.
@@ -1414,7 +1421,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.
@@ -1423,7 +1430,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.
@@ -1461,7 +1468,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.
@@ -1478,7 +1485,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.
@@ -1487,7 +1494,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.
@@ -1504,7 +1511,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.
@@ -1525,7 +1532,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.
@@ -1549,7 +1556,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.
@@ -1557,7 +1564,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.
@@ -1565,7 +1572,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.
@@ -1573,7 +1580,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 });
 	}
 };
 
@@ -1592,33 +1599,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
@@ -1671,5 +1671,5 @@ var TMDB = class {
 };
 
 //#endregion
-export { API, BackdropSizes, BaseEndpoint, ChangeKeys, ImageFormats, ImageSizes, LogoSizes, PosterSizes, ProfileSizes, ReleaseDateType, StillSizes, TMDB, TMDB_IMAGE_BASE_URL, formImage, getFullImagePath, parseOptions };
+export { API, BackdropSizes, BaseEndpoint, ChangeKeys, ImageFormats, ImageSizes, LogoSizes, PosterSizes, ProfileSizes, ReleaseDateType, StillSizes, TMDB, TMDBError, TMDB_IMAGE_BASE_URL, formImage, getFullImagePath, parseOptions };
 //# sourceMappingURL=index.mjs.map