@tdanks2000/tmdb-wrapper 1.4.0 → 1.6.0

package/dist/index.mjs

@@ -113,6 +113,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;
@@ -123,41 +156,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
@@ -214,8 +261,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);
@@ -226,11 +288,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);
@@ -238,10 +309,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}`);
 	}
 };
 
@@ -249,11 +324,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);
@@ -261,17 +341,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");
 	}
 };
 
@@ -279,11 +365,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);
@@ -291,27 +383,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 });
 	}
 };
 
@@ -337,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.
@@ -350,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.
@@ -359,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 });
 	}
 };
 
@@ -455,11 +556,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);
@@ -467,19 +573,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 });
 	}
 };
 
@@ -504,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 });
 	}
 };
 
@@ -528,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.
@@ -536,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 });
 	}
 };
 
@@ -570,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 });
 	}
 };
 
@@ -597,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.
@@ -618,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.
@@ -627,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.
@@ -648,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.
@@ -665,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.
@@ -674,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.
@@ -691,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.
@@ -700,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.
@@ -717,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.
@@ -740,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.
@@ -748,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.
@@ -756,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.
@@ -764,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 });
 	}
 };
 
@@ -835,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.
@@ -844,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.
@@ -853,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.
@@ -862,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.
@@ -871,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.
@@ -896,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.
@@ -919,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 });
 	}
 };
 
@@ -968,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.
@@ -976,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.
@@ -984,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.
@@ -992,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.
@@ -1000,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.
@@ -1008,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.
@@ -1016,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 });
 	}
 };
 
@@ -1043,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 });
 	}
 };
 
@@ -1077,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.
@@ -1086,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.
@@ -1095,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.
@@ -1116,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.
@@ -1137,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 });
 	}
 };
 
@@ -1171,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.
@@ -1180,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.
@@ -1189,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.
@@ -1198,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.
@@ -1207,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.
@@ -1220,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.
@@ -1233,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.
@@ -1242,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 });
 	}
 };
 
@@ -1274,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.
@@ -1292,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.
@@ -1309,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.
@@ -1318,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.
@@ -1356,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.
@@ -1373,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.
@@ -1382,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.
@@ -1399,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.
@@ -1420,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.
@@ -1444,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.
@@ -1452,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.
@@ -1460,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.
@@ -1468,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 });
 	}
 };
 
@@ -1487,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
@@ -1566,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