tmdb-kit 1.0.0 → 1.2.0

package/dist/index.js

@@ -1,798 +1,1128 @@
-//#region src/errors.ts
-/** Base class for all SDK-originated errors. */
-var TMDBError = class extends Error {
-	constructor(message, options) {
-		super(message, options);
-		this.name = "TMDBError";
-	}
-};
-/** Thrown before a request is sent or when fetch itself rejects. */
-var TMDBRequestError = class extends TMDBError {
-	constructor(message, options) {
-		super(message, options);
-		this.name = "TMDBRequestError";
-	}
-};
-/** Thrown when TMDB returns a non-2xx response. */
-var TMDBResponseError = class extends TMDBError {
-	body;
-	headers;
-	requestId;
-	status;
-	statusCode;
-	statusMessage;
-	statusText;
-	url;
-	constructor(message, options) {
-		super(message);
-		this.name = "TMDBResponseError";
-		this.body = options.body;
-		this.headers = options.headers;
-		this.requestId = options.headers.get("x-request-id");
-		this.status = options.status;
-		this.statusText = options.statusText;
-		this.url = options.url;
-		const body = isErrorResponseBody(options.body) ? options.body : void 0;
-		this.statusCode = body?.status_code;
-		this.statusMessage = body?.status_message;
-	}
-	/** True when TMDB has asked the caller to back off (HTTP 429). */
-	get isRateLimit() {
-		return this.status === 429;
-	}
-	/** True when the resource was not found (HTTP 404). */
-	get isNotFound() {
-		return this.status === 404;
-	}
-	/** True when the request was rejected as unauthenticated (HTTP 401). */
-	get isUnauthorized() {
-		return this.status === 401;
-	}
-	/** True when the request was rejected as forbidden (HTTP 403). */
-	get isForbidden() {
-		return this.status === 403;
-	}
-	/** True when the upstream returned a 5xx server error. */
-	get isServerError() {
-		return this.status >= 500 && this.status < 600;
-	}
-};
-/**
-* Thrown when TMDB returns HTTP 429.
-*
-* The SDK does NOT retry automatically — that decision is left to the
-* caller, since retry policies vary widely. Inspect `retryAfter` to
-* implement your own backoff.
-*/
-var TMDBRateLimitError = class extends TMDBResponseError {
-	retryAfter;
-	constructor(message, options) {
-		super(message, options);
-		this.name = "TMDBRateLimitError";
-		this.retryAfter = options.retryAfter;
-	}
-};
-/**
-* Create the appropriate error instance for a non-2xx TMDB response.
-*
-* Returns a {@link TMDBRateLimitError} when the status is 429, otherwise
-* a generic {@link TMDBResponseError}. The error message is extracted from
-* the TMDB `status_message` field when available.
-*/
+// src/errors.ts
+class TMDBError extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "TMDBError";
+  }
+}
+
+class TMDBRequestError extends TMDBError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "TMDBRequestError";
+  }
+}
+
+class TMDBTimeoutError extends TMDBError {
+  timeoutMs;
+  constructor(timeoutMs, message = `TMDB request timed out after ${timeoutMs}ms`) {
+    super(message);
+    this.name = "TMDBTimeoutError";
+    this.timeoutMs = timeoutMs;
+  }
+}
+
+class TMDBResponseError extends TMDBError {
+  body;
+  headers;
+  requestId;
+  status;
+  statusCode;
+  statusMessage;
+  statusText;
+  url;
+  constructor(message, options) {
+    super(message);
+    this.name = "TMDBResponseError";
+    this.body = options.body;
+    this.headers = options.headers;
+    this.requestId = options.headers.get("x-request-id");
+    this.status = options.status;
+    this.statusText = options.statusText;
+    this.url = options.url;
+    const body = isErrorResponseBody(options.body) ? options.body : undefined;
+    this.statusCode = body?.status_code;
+    this.statusMessage = body?.status_message;
+  }
+  get isRateLimit() {
+    return this.status === 429;
+  }
+  get isNotFound() {
+    return this.status === 404;
+  }
+  get isUnauthorized() {
+    return this.status === 401;
+  }
+  get isForbidden() {
+    return this.status === 403;
+  }
+  get isServerError() {
+    return this.status >= 500 && this.status < 600;
+  }
+}
+
+class TMDBRateLimitError extends TMDBResponseError {
+  retryAfter;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "TMDBRateLimitError";
+    this.retryAfter = options.retryAfter;
+  }
+}
 function createResponseError(options) {
-	const message = (isErrorResponseBody(options.body) ? options.body : void 0)?.status_message ?? `${options.status} ${options.statusText}`.trim();
-	if (options.status === 429) return new TMDBRateLimitError(message, {
-		...options,
-		retryAfter: parseRetryAfter(options.headers.get("retry-after"))
-	});
-	return new TMDBResponseError(message, options);
-}
-/**
-* Parse the `Retry-After` header into seconds. Accepts both delta-seconds
-* (e.g. "5") and HTTP-date forms (e.g. "Wed, 21 Oct 2026 07:28:00 GMT").
-* Falls back to 1 second when the header is missing or unparseable.
-*/
+  const body = isErrorResponseBody(options.body) ? options.body : undefined;
+  const message = body?.status_message ?? `${options.status} ${options.statusText}`.trim();
+  if (options.status === 429) {
+    return new TMDBRateLimitError(message, {
+      ...options,
+      retryAfter: parseRetryAfter(options.headers.get("retry-after"))
+    });
+  }
+  return new TMDBResponseError(message, options);
+}
 function parseRetryAfter(value) {
-	if (value === null || value === void 0) return 1;
-	const trimmed = value.trim();
-	if (trimmed === "") return 1;
-	const seconds = Number(trimmed);
-	if (Number.isFinite(seconds) && seconds >= 0) return seconds;
-	const date = Date.parse(trimmed);
-	if (Number.isFinite(date)) {
-		const deltaMs = date - Date.now();
-		return Math.max(1, Math.ceil(deltaMs / 1e3));
-	}
-	return 1;
-}
-/** Check if a value has the shape of a TMDB error response body. */
+  if (value === null || value === undefined) {
+    return 1;
+  }
+  const trimmed = value.trim();
+  if (trimmed === "") {
+    return 1;
+  }
+  const seconds = Number(trimmed);
+  if (Number.isFinite(seconds) && seconds >= 0) {
+    return seconds;
+  }
+  const date = Date.parse(trimmed);
+  if (Number.isFinite(date)) {
+    const deltaMs = date - Date.now();
+    return Math.max(1, Math.ceil(deltaMs / 1000));
+  }
+  return 1;
+}
 function isErrorResponseBody(value) {
-	return typeof value === "object" && value !== null;
-}
-/**
-* Append query parameters to a URL object.
-*
-* - `undefined` and `null` values are skipped.
-* - Arrays are joined with commas (TMDB convention).
-* - All values are converted to strings.
-*/
+  return typeof value === "object" && value !== null;
+}
+
+// src/query.ts
+var DEFAULT_API_BASE_URL = "https://api.themoviedb.org/3";
+var DEFAULT_IMAGE_BASE_URL = "https://image.tmdb.org/t/p";
 function appendQuery(url, query) {
-	for (const [key, value] of Object.entries(query)) {
-		if (value === void 0 || value === null) continue;
-		if (Array.isArray(value)) {
-			url.searchParams.set(key, value.map(String).join(","));
-			continue;
-		}
-		url.searchParams.set(key, String(value));
-	}
-}
-/**
-* Merge a language query parameter with client defaults.
-*
-* If `query.language` is set it takes precedence; otherwise the client's
-* default language is used.
-*/
+  for (const [key, value] of Object.entries(query)) {
+    if (value === undefined || value === null) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      url.searchParams.set(key, value.map(String).join(","));
+      continue;
+    }
+    url.searchParams.set(key, String(value));
+  }
+}
 function withLanguage(defaults, query) {
-	const language = typeof query.language === "string" ? query.language : defaults.language;
-	return {
-		...query,
-		language
-	};
-}
-/**
-* Merge language and region defaults for list endpoints.
-*
-* Combines {@link withLanguage} with region fallback from client defaults.
-*/
+  const language = typeof query.language === "string" ? query.language : defaults.language;
+  return {
+    ...query,
+    language
+  };
+}
 function withListDefaults(defaults, query) {
-	const region = typeof query.region === "string" ? query.region : defaults.region;
-	return {
-		...withLanguage(defaults, query),
-		region
-	};
-}
-/**
-* Convert a string or string array to a comma-separated list.
-*
-* Returns `undefined` if the input is `undefined` (skips the parameter).
-* TMDB uses comma-separated values for multi-value query parameters.
-*/
+  const region = typeof query.region === "string" ? query.region : defaults.region;
+  return {
+    ...withLanguage(defaults, query),
+    region
+  };
+}
 function toCommaList(value) {
-	if (value === void 0) return;
-	return typeof value === "string" ? value : value.join(",");
-}
-/**
-* Validate and convert a numeric ID to a string for use in URL paths.
-*
-* @throws {TMDBRequestError} If `value` is not a positive integer.
-*/
+  if (value === undefined) {
+    return;
+  }
+  return typeof value === "string" ? value : value.join(",");
+}
 function toId(value, name) {
-	if (!Number.isInteger(value) || value <= 0) throw new TMDBRequestError(`${name} must be a positive integer`);
-	return String(value);
-}
-/**
-* Validate and trim a search query string.
-*
-* @throws {TMDBRequestError} If the query is empty after trimming.
-*/
+  if (!Number.isInteger(value) || value <= 0) {
+    throw new TMDBRequestError(`${name} must be a positive integer`);
+  }
+  return String(value);
+}
+function toSeasonNumber(value) {
+  if (!Number.isInteger(value) || value < 0) {
+    throw new TMDBRequestError("seasonNumber must be a non-negative integer");
+  }
+  return String(value);
+}
+function toGroupId(value) {
+  const groupId = value.trim();
+  if (!/^[A-Za-z0-9_-]+$/.test(groupId)) {
+    throw new TMDBRequestError("groupId must be a non-empty identifier");
+  }
+  return groupId;
+}
 function toSearchQuery(value) {
-	const query = value.trim();
-	if (query.length === 0) throw new TMDBRequestError("search query must not be empty");
-	return query;
-}
-/**
-* Validate a trending time window value.
-*
-* @throws {TMDBRequestError} If `value` is not `"day"` or `"week"`.
-*/
+  const query = value.trim();
+  if (query.length === 0) {
+    throw new TMDBRequestError("search query must not be empty");
+  }
+  return query;
+}
 function toTimeWindow(value) {
-	if (value !== "day" && value !== "week") throw new TMDBRequestError("timeWindow must be either \"day\" or \"week\"");
-	return value;
+  if (value !== "day" && value !== "week") {
+    throw new TMDBRequestError('timeWindow must be either "day" or "week"');
+  }
+  return value;
 }
-/**
-* Build a full TMDB image URL from the path returned by API payloads.
-* Returns null for nullish image paths so UI code can branch naturally.
-*/
 function buildImageUrl(path, size = "original", options = {}) {
-	if (path === void 0 || path === null || path.trim() === "") return null;
-	const url = `${normalizeBaseUrl(options.baseUrl ?? "https://image.tmdb.org/t/p")}/${size}${path.startsWith("/") ? path : `/${path}`}`;
-	return options.transform ? options.transform(url) : url;
+  if (path === undefined || path === null || path.trim() === "") {
+    return null;
+  }
+  const baseUrl = normalizeBaseUrl(options.baseUrl ?? DEFAULT_IMAGE_BASE_URL);
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  const url = `${baseUrl}/${size}${normalizedPath}`;
+  return options.transform ? options.transform(url) : url;
 }
-/**
-* Strip trailing slashes from a base URL to ensure consistent path joining.
-*/
 function normalizeBaseUrl(baseUrl) {
-	return baseUrl.replace(/\/+$/, "");
-}
-//#endregion
-//#region src/http.ts
-/**
-* Built-in HTTP transport that uses the Fetch API.
-*
-* Handles authentication (API key or access token), URL construction,
-* request headers, and response parsing. Use the factory function
-* {@link createTMDB} instead of instantiating this directly.
-*/
-var TMDBHttpClient = class {
-	defaults;
-	imageTransform;
-	#apiKey;
-	#accessToken;
-	#baseUrl;
-	#fetch;
-	#headers;
-	constructor(options) {
-		const accessToken = normalizeSecret("accessToken" in options ? options.accessToken : void 0);
-		const apiKey = normalizeSecret("apiKey" in options ? options.apiKey : void 0);
-		if (Boolean(accessToken) === Boolean(apiKey)) throw new TMDBRequestError("Provide exactly one of accessToken or apiKey");
-		this.#accessToken = accessToken;
-		this.#apiKey = apiKey;
-		this.#baseUrl = normalizeBaseUrl(options.baseUrl ?? "https://api.themoviedb.org/3");
-		this.#fetch = options.fetch;
-		this.#headers = options.headers;
-		this.defaults = {
-			imageBaseUrl: normalizeBaseUrl(options.imageBaseUrl ?? "https://image.tmdb.org/t/p"),
-			language: options.defaultLanguage,
-			region: options.defaultRegion
-		};
-		this.imageTransform = options.images?.transform;
-	}
-	async get(path, options = {}) {
-		const url = this.#createUrl(path, options.query ?? {});
-		const headers = this.#createHeaders(options.headers);
-		const fetchImpl = this.#resolveFetch();
-		let response;
-		try {
-			response = await fetchImpl(url, {
-				headers,
-				method: "GET",
-				signal: options.signal
-			});
-		} catch (error) {
-			throw new TMDBRequestError(`TMDB request failed: ${String(error)}`, { cause: error });
-		}
-		const body = await readJson(response);
-		if (!response.ok) throw createResponseError({
-			body,
-			headers: response.headers,
-			status: response.status,
-			statusText: response.statusText,
-			url
-		});
-		return body;
-	}
-	#resolveFetch() {
-		if (this.#fetch !== void 0) return this.#fetch;
-		const globalFetch = globalThis.fetch;
-		if (typeof globalFetch !== "function") throw new TMDBRequestError("No fetch implementation found. Pass options.fetch in this runtime.");
-		return globalFetch.bind(globalThis);
-	}
-	#createHeaders(headersInit) {
-		const headers = new Headers(this.#headers);
-		const requestHeaders = new Headers(headersInit);
-		headers.set("Accept", "application/json");
-		for (const [key, value] of requestHeaders) headers.set(key, value);
-		if (this.#accessToken !== void 0) headers.set("Authorization", `Bearer ${this.#accessToken}`);
-		return headers;
-	}
-	#createUrl(path, query) {
-		const relativePath = path.replace(/^\/+/, "");
-		const url = new URL(relativePath, `${this.#baseUrl}/`);
-		appendQuery(url, {
-			...query,
-			api_key: this.#apiKey
-		});
-		return url.toString();
-	}
-};
-/**
-* Read and parse a JSON response body.
-*
-* Returns `undefined` for empty responses. If the body is not valid JSON,
-* the raw text string is returned as-is (TMDB occasionally returns plain
-* text for certain error conditions).
-*/
+  return baseUrl.replace(/\/+$/, "");
+}
+
+// src/http.ts
+class TMDBHttpClient {
+  defaults;
+  imageTransform;
+  #apiKey;
+  #accessToken;
+  #baseUrl;
+  #fetch;
+  #headers;
+  constructor(options) {
+    const accessToken = normalizeSecret("accessToken" in options ? options.accessToken : undefined);
+    const apiKey = normalizeSecret("apiKey" in options ? options.apiKey : undefined);
+    if (Boolean(accessToken) === Boolean(apiKey)) {
+      throw new TMDBRequestError("Provide exactly one of accessToken or apiKey");
+    }
+    this.#accessToken = accessToken;
+    this.#apiKey = apiKey;
+    this.#baseUrl = normalizeBaseUrl(options.baseUrl ?? DEFAULT_API_BASE_URL);
+    this.#fetch = options.fetch;
+    this.#headers = options.headers;
+    this.defaults = {
+      imageBaseUrl: normalizeBaseUrl(options.imageBaseUrl ?? DEFAULT_IMAGE_BASE_URL),
+      language: options.defaultLanguage,
+      region: options.defaultRegion
+    };
+    this.imageTransform = options.images?.transform;
+  }
+  async get(path, options = {}) {
+    const url = this.#createUrl(path, options.query ?? {});
+    const headers = this.#createHeaders(options.headers);
+    const fetchImpl = this.#resolveFetch();
+    let response;
+    try {
+      response = await fetchImpl(url, {
+        headers,
+        method: "GET",
+        signal: options.signal
+      });
+    } catch (error) {
+      throw new TMDBRequestError(`TMDB request failed: ${String(error)}`, { cause: error });
+    }
+    const body = await readJson(response);
+    if (!response.ok) {
+      throw createResponseError({
+        body,
+        headers: response.headers,
+        status: response.status,
+        statusText: response.statusText,
+        url
+      });
+    }
+    return body;
+  }
+  #resolveFetch() {
+    if (this.#fetch !== undefined) {
+      return this.#fetch;
+    }
+    const globalFetch = globalThis.fetch;
+    if (typeof globalFetch !== "function") {
+      throw new TMDBRequestError("No fetch implementation found. Pass options.fetch in this runtime.");
+    }
+    return globalFetch.bind(globalThis);
+  }
+  #createHeaders(headersInit) {
+    const headers = new Headers(this.#headers);
+    const requestHeaders = new Headers(headersInit);
+    headers.set("Accept", "application/json");
+    for (const [key, value] of requestHeaders) {
+      headers.set(key, value);
+    }
+    if (this.#accessToken !== undefined) {
+      headers.set("Authorization", `Bearer ${this.#accessToken}`);
+    }
+    return headers;
+  }
+  #createUrl(path, query) {
+    const relativePath = path.replace(/^\/+/, "");
+    const url = new URL(relativePath, `${this.#baseUrl}/`);
+    appendQuery(url, {
+      ...query,
+      api_key: this.#apiKey
+    });
+    return url.toString();
+  }
+}
 async function readJson(response) {
-	const text = await response.text();
-	if (text.length === 0) return;
-	try {
-		return JSON.parse(text);
-	} catch {
-		return text;
-	}
-}
-/**
-* Normalize a secret value by trimming whitespace and treating empty
-* strings as undefined (not provided).
-*/
+  const text = await response.text();
+  if (text.length === 0) {
+    return;
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
 function normalizeSecret(value) {
-	const secret = value?.trim();
-	return secret === "" ? void 0 : secret;
-}
-//#endregion
-//#region src/resources/configuration.ts
-/**
-* Access TMDB configuration data (image sizes, countries, languages, etc.).
-*
-* Obtained via `client.configuration`.
-*/
-var ConfigurationResource = class {
-	#transport;
-	constructor(transport) {
-		this.#transport = transport;
-	}
-	details() {
-		return this.#transport.get("/configuration");
-	}
-	countries() {
-		return this.#transport.get("/configuration/countries");
-	}
-	jobs() {
-		return this.#transport.get("/configuration/jobs");
-	}
-	languages() {
-		return this.#transport.get("/configuration/languages");
-	}
-	primaryTranslations() {
-		return this.#transport.get("/configuration/primary_translations");
-	}
-	timezones() {
-		return this.#transport.get("/configuration/timezones");
-	}
-};
-//#endregion
-//#region src/resources/genres.ts
-/**
-* Access TMDB genre lists for movies and TV shows.
-*
-* Obtained via `client.genres`.
-*/
-var GenresResource = class {
-	#transport;
-	constructor(transport) {
-		this.#transport = transport;
-	}
-	movies(options = {}) {
-		return this.#transport.get("/genre/movie/list", { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-	tv(options = {}) {
-		return this.#transport.get("/genre/tv/list", { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-};
-//#endregion
-//#region src/resources/images.ts
-/**
-* Helper for constructing TMDB image URLs from API path values.
-*
-* Obtained via `client.images`. Supports optional URL transforms for
-* routing image requests through a CDN or proxy.
-*/
-var ImagesHelper = class {
-	#transport;
-	#transform;
-	constructor(transport, transform) {
-		this.#transport = transport;
-		this.#transform = transform;
-	}
-	url(path, size = "original", options = {}) {
-		return buildImageUrl(path, size, {
-			baseUrl: this.#transport.defaults.imageBaseUrl,
-			transform: options.transform ?? this.#transform
-		});
-	}
-};
-//#endregion
-//#region src/resources/movies.ts
-/**
-* Access TMDB movie endpoints (popular, top-rated, details, credits, etc.).
-*
-* Obtained via `client.movies`.
-*/
-var MoviesResource = class {
-	#transport;
-	constructor(transport) {
-		this.#transport = transport;
-	}
-	popular(options = {}) {
-		return this.#transport.get("/movie/popular", { query: movieListQuery(this.#transport, options) });
-	}
-	topRated(options = {}) {
-		return this.#transport.get("/movie/top_rated", { query: movieListQuery(this.#transport, options) });
-	}
-	nowPlaying(options = {}) {
-		return this.#transport.get("/movie/now_playing", { query: movieListQuery(this.#transport, options) });
-	}
-	upcoming(options = {}) {
-		return this.#transport.get("/movie/upcoming", { query: movieListQuery(this.#transport, options) });
-	}
-	details(movieId, options = {}) {
-		return this.#transport.get(`/movie/${toId(movieId, "movieId")}`, { query: withLanguage(this.#transport.defaults, {
-			append_to_response: toCommaList(options.appendToResponse),
-			language: options.language
-		}) });
-	}
-	credits(movieId, options = {}) {
-		return this.#transport.get(`/movie/${toId(movieId, "movieId")}/credits`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-	images(movieId, options = {}) {
-		return this.#transport.get(`/movie/${toId(movieId, "movieId")}/images`, { query: withLanguage(this.#transport.defaults, {
-			include_image_language: toCommaList(options.includeImageLanguage),
-			language: options.language
-		}) });
-	}
-	recommendations(movieId, options = {}) {
-		return this.#transport.get(`/movie/${toId(movieId, "movieId")}/recommendations`, { query: movieListQuery(this.#transport, options) });
-	}
-	similar(movieId, options = {}) {
-		return this.#transport.get(`/movie/${toId(movieId, "movieId")}/similar`, { query: movieListQuery(this.#transport, options) });
-	}
-	videos(movieId, options = {}) {
-		return this.#transport.get(`/movie/${toId(movieId, "movieId")}/videos`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-};
-/** Build query parameters for movie list endpoints. */
+  const secret = value?.trim();
+  return secret === "" ? undefined : secret;
+}
+
+// src/resources/configuration.ts
+class ConfigurationResource {
+  #transport;
+  constructor(transport) {
+    this.#transport = transport;
+  }
+  details(options = {}) {
+    return this.#transport.get("/configuration", { signal: options.signal });
+  }
+  countries(options = {}) {
+    return this.#transport.get("/configuration/countries", { signal: options.signal });
+  }
+  jobs(options = {}) {
+    return this.#transport.get("/configuration/jobs", { signal: options.signal });
+  }
+  languages(options = {}) {
+    return this.#transport.get("/configuration/languages", { signal: options.signal });
+  }
+  primaryTranslations(options = {}) {
+    return this.#transport.get("/configuration/primary_translations", {
+      signal: options.signal
+    });
+  }
+  timezones(options = {}) {
+    return this.#transport.get("/configuration/timezones", { signal: options.signal });
+  }
+}
+
+// src/resources/genres.ts
+class GenresResource {
+  #transport;
+  constructor(transport) {
+    this.#transport = transport;
+  }
+  movies(options = {}) {
+    return this.#transport.get("/genre/movie/list", {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  tv(options = {}) {
+    return this.#transport.get("/genre/tv/list", {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+}
+
+// src/resources/images.ts
+class ImagesHelper {
+  #transport;
+  #transform;
+  constructor(transport, transform) {
+    this.#transport = transport;
+    this.#transform = transform;
+  }
+  url(path, size = "original", options = {}) {
+    return buildImageUrl(path, size, {
+      baseUrl: this.#transport.defaults.imageBaseUrl,
+      transform: options.transform ?? this.#transform
+    });
+  }
+}
+
+// src/resources/movies.ts
+class MoviesResource {
+  #transport;
+  constructor(transport) {
+    this.#transport = transport;
+  }
+  popular(options = {}) {
+    return this.#transport.get("/movie/popular", {
+      query: movieListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  topRated(options = {}) {
+    return this.#transport.get("/movie/top_rated", {
+      query: movieListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  nowPlaying(options = {}) {
+    return this.#transport.get("/movie/now_playing", {
+      query: movieListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  upcoming(options = {}) {
+    return this.#transport.get("/movie/upcoming", {
+      query: movieListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  details(movieId, options = {}) {
+    return this.#transport.get(`/movie/${toId(movieId, "movieId")}`, {
+      query: withLanguage(this.#transport.defaults, {
+        append_to_response: toCommaList(options.appendToResponse),
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  credits(movieId, options = {}) {
+    return this.#transport.get(`/movie/${toId(movieId, "movieId")}/credits`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  images(movieId, options = {}) {
+    return this.#transport.get(`/movie/${toId(movieId, "movieId")}/images`, {
+      query: withLanguage(this.#transport.defaults, {
+        include_image_language: toCommaList(options.includeImageLanguage),
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  recommendations(movieId, options = {}) {
+    return this.#transport.get(`/movie/${toId(movieId, "movieId")}/recommendations`, {
+      query: movieListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  similar(movieId, options = {}) {
+    return this.#transport.get(`/movie/${toId(movieId, "movieId")}/similar`, {
+      query: movieListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  videos(movieId, options = {}) {
+    return this.#transport.get(`/movie/${toId(movieId, "movieId")}/videos`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+}
 function movieListQuery(transport, options) {
-	return withListDefaults(transport.defaults, {
-		language: options.language,
-		page: options.page,
-		region: options.region
-	});
-}
-//#endregion
-//#region src/resources/people.ts
-/**
-* Access TMDB person (actor, director, etc.) endpoints.
-*
-* Obtained via `client.people`.
-*/
-var PeopleResource = class {
-	#transport;
-	constructor(transport) {
-		this.#transport = transport;
-	}
-	popular(options = {}) {
-		return this.#transport.get("/person/popular", { query: peopleListQuery(this.#transport, options) });
-	}
-	details(personId, options = {}) {
-		return this.#transport.get(`/person/${toId(personId, "personId")}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-};
-/** Build query parameters for person list endpoints. */
+  return withListDefaults(transport.defaults, {
+    language: options.language,
+    page: options.page,
+    region: options.region
+  });
+}
+
+// src/resources/people.ts
+class PeopleResource {
+  #transport;
+  constructor(transport) {
+    this.#transport = transport;
+  }
+  popular(options = {}) {
+    return this.#transport.get("/person/popular", {
+      query: peopleListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  details(personId, options = {}) {
+    return this.#transport.get(`/person/${toId(personId, "personId")}`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  combinedCredits(personId, options = {}) {
+    return this.#transport.get(`/person/${toId(personId, "personId")}/combined_credits`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+}
 function peopleListQuery(transport, options) {
-	return withLanguage(transport.defaults, {
-		language: options.language,
-		page: options.page
-	});
-}
-//#endregion
-//#region src/resources/search.ts
-/**
-* Search TMDB for movies, TV shows, people, or all media types.
-*
-* Obtained via `client.search`.
-*/
-var SearchResource = class {
-	#transport;
-	constructor(transport) {
-		this.#transport = transport;
-	}
-	movies(query, options = {}) {
-		return this.#transport.get("/search/movie", { query: movieSearchQuery(this.#transport, query, options) });
-	}
-	tv(query, options = {}) {
-		return this.#transport.get("/search/tv", { query: tvSearchQuery(this.#transport, query, options) });
-	}
-	people(query, options = {}) {
-		return this.#transport.get("/search/person", { query: commonSearchQuery(this.#transport, query, options) });
-	}
-	async multi(query, options = {}) {
-		const response = await this.#transport.get("/search/multi", { query: commonSearchQuery(this.#transport, query, options) });
-		const excluded = options.exclude;
-		if (excluded === void 0 || excluded.length === 0) return response;
-		const excludedSet = new Set(excluded);
-		return {
-			...response,
-			results: response.results.filter((result) => !excludedSet.has(result.media_type))
-		};
-	}
-};
-/** Build query parameters for movie search. */
+  return withLanguage(transport.defaults, {
+    language: options.language,
+    page: options.page
+  });
+}
+
+// src/resources/search.ts
+class SearchResource {
+  #transport;
+  constructor(transport) {
+    this.#transport = transport;
+  }
+  movies(query, options = {}) {
+    return this.#transport.get("/search/movie", {
+      query: movieSearchQuery(this.#transport, query, options),
+      signal: options.signal
+    });
+  }
+  tv(query, options = {}) {
+    return this.#transport.get("/search/tv", {
+      query: tvSearchQuery(this.#transport, query, options),
+      signal: options.signal
+    });
+  }
+  people(query, options = {}) {
+    return this.#transport.get("/search/person", {
+      query: commonSearchQuery(this.#transport, query, options),
+      signal: options.signal
+    });
+  }
+  async multi(query, options = {}) {
+    const response = await this.#transport.get("/search/multi", {
+      query: commonSearchQuery(this.#transport, query, options),
+      signal: options.signal
+    });
+    const excluded = options.exclude;
+    if (excluded === undefined || excluded.length === 0) {
+      return response;
+    }
+    const excludedSet = new Set(excluded);
+    return {
+      ...response,
+      results: response.results.filter((result) => !excludedSet.has(result.media_type))
+    };
+  }
+}
 function movieSearchQuery(transport, query, options) {
-	return withListDefaults(transport.defaults, {
-		include_adult: options.includeAdult,
-		language: options.language,
-		page: options.page,
-		primary_release_year: options.primaryReleaseYear,
-		query: toSearchQuery(query),
-		region: options.region,
-		year: options.year
-	});
-}
-/** Build query parameters for TV search. */
+  return withListDefaults(transport.defaults, {
+    include_adult: options.includeAdult,
+    language: options.language,
+    page: options.page,
+    primary_release_year: options.primaryReleaseYear,
+    query: toSearchQuery(query),
+    region: options.region,
+    year: options.year
+  });
+}
 function tvSearchQuery(transport, query, options) {
-	return withLanguage(transport.defaults, {
-		first_air_date_year: options.firstAirDateYear,
-		include_adult: options.includeAdult,
-		language: options.language,
-		page: options.page,
-		query: toSearchQuery(query),
-		year: options.year
-	});
-}
-/** Build query parameters for person and multi-search. */
+  return withLanguage(transport.defaults, {
+    first_air_date_year: options.firstAirDateYear,
+    include_adult: options.includeAdult,
+    language: options.language,
+    page: options.page,
+    query: toSearchQuery(query),
+    year: options.year
+  });
+}
 function commonSearchQuery(transport, query, options) {
-	return withLanguage(transport.defaults, {
-		include_adult: options.includeAdult,
-		language: options.language,
-		page: options.page,
-		query: toSearchQuery(query)
-	});
-}
-//#endregion
-//#region src/resources/trending.ts
-/**
-* Access TMDB trending content (movies, TV, people) for day/week windows.
-*
-* Obtained via `client.trending`.
-*/
-var TrendingResource = class {
-	#transport;
-	constructor(transport) {
-		this.#transport = transport;
-	}
-	all(timeWindow = "day", options = {}) {
-		return this.#transport.get(`/trending/all/${toTimeWindow(timeWindow)}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-	movies(timeWindow = "day", options = {}) {
-		return this.#transport.get(`/trending/movie/${toTimeWindow(timeWindow)}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-	tv(timeWindow = "day", options = {}) {
-		return this.#transport.get(`/trending/tv/${toTimeWindow(timeWindow)}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-	people(timeWindow = "day", options = {}) {
-		return this.#transport.get(`/trending/person/${toTimeWindow(timeWindow)}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-};
-//#endregion
-//#region src/resources/tv.ts
-/**
-* Access TMDB TV show endpoints (popular, top-rated, details, seasons, etc.).
-*
-* Obtained via `client.tv`.
-*/
-var TVResource = class {
-	#transport;
-	constructor(transport) {
-		this.#transport = transport;
-	}
-	popular(options = {}) {
-		return this.#transport.get("/tv/popular", { query: tvListQuery(this.#transport, options) });
-	}
-	topRated(options = {}) {
-		return this.#transport.get("/tv/top_rated", { query: tvListQuery(this.#transport, options) });
-	}
-	airingToday(options = {}) {
-		return this.#transport.get("/tv/airing_today", { query: tvListQuery(this.#transport, options) });
-	}
-	onTheAir(options = {}) {
-		return this.#transport.get("/tv/on_the_air", { query: tvListQuery(this.#transport, options) });
-	}
-	details(seriesId, options = {}) {
-		return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}`, { query: withLanguage(this.#transport.defaults, {
-			append_to_response: toCommaList(options.appendToResponse),
-			language: options.language
-		}) });
-	}
-	credits(seriesId, options = {}) {
-		return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/credits`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-	images(seriesId, options = {}) {
-		return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/images`, { query: withLanguage(this.#transport.defaults, {
-			include_image_language: toCommaList(options.includeImageLanguage),
-			language: options.language
-		}) });
-	}
-	recommendations(seriesId, options = {}) {
-		return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/recommendations`, { query: tvListQuery(this.#transport, options) });
-	}
-	similar(seriesId, options = {}) {
-		return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/similar`, { query: tvListQuery(this.#transport, options) });
-	}
-	videos(seriesId, options = {}) {
-		return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/videos`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
-	}
-	seasonDetails(seriesId, seasonNumber, options = {}) {
-		return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toId(seasonNumber, "seasonNumber")}`, { query: withLanguage(this.#transport.defaults, {
-			append_to_response: toCommaList(options.appendToResponse),
-			language: options.language
-		}) });
-	}
-};
-/** Build query parameters for TV list endpoints. */
+  return withLanguage(transport.defaults, {
+    include_adult: options.includeAdult,
+    language: options.language,
+    page: options.page,
+    query: toSearchQuery(query)
+  });
+}
+
+// src/resources/trending.ts
+class TrendingResource {
+  #transport;
+  constructor(transport) {
+    this.#transport = transport;
+  }
+  all(timeWindow = "day", options = {}) {
+    return this.#transport.get(`/trending/all/${toTimeWindow(timeWindow)}`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language,
+        page: options.page
+      }),
+      signal: options.signal
+    });
+  }
+  movies(timeWindow = "day", options = {}) {
+    return this.#transport.get(`/trending/movie/${toTimeWindow(timeWindow)}`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language,
+        page: options.page
+      }),
+      signal: options.signal
+    });
+  }
+  tv(timeWindow = "day", options = {}) {
+    return this.#transport.get(`/trending/tv/${toTimeWindow(timeWindow)}`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language,
+        page: options.page
+      }),
+      signal: options.signal
+    });
+  }
+  people(timeWindow = "day", options = {}) {
+    return this.#transport.get(`/trending/person/${toTimeWindow(timeWindow)}`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language,
+        page: options.page
+      }),
+      signal: options.signal
+    });
+  }
+}
+
+// src/resources/tv.ts
+class TVResource {
+  #transport;
+  constructor(transport) {
+    this.#transport = transport;
+  }
+  popular(options = {}) {
+    return this.#transport.get("/tv/popular", {
+      query: tvListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  topRated(options = {}) {
+    return this.#transport.get("/tv/top_rated", {
+      query: tvListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  airingToday(options = {}) {
+    return this.#transport.get("/tv/airing_today", {
+      query: tvListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  onTheAir(options = {}) {
+    return this.#transport.get("/tv/on_the_air", {
+      query: tvListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  details(seriesId, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}`, {
+      query: withLanguage(this.#transport.defaults, {
+        append_to_response: toCommaList(options.appendToResponse),
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  credits(seriesId, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/credits`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  images(seriesId, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/images`, {
+      query: withLanguage(this.#transport.defaults, {
+        include_image_language: toCommaList(options.includeImageLanguage),
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  recommendations(seriesId, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/recommendations`, {
+      query: tvListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  similar(seriesId, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/similar`, {
+      query: tvListQuery(this.#transport, options),
+      signal: options.signal
+    });
+  }
+  videos(seriesId, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/videos`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  seasonDetails(seriesId, seasonNumber, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toSeasonNumber(seasonNumber)}`, {
+      query: withLanguage(this.#transport.defaults, {
+        append_to_response: toCommaList(options.appendToResponse),
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  seasonCredits(seriesId, seasonNumber, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toSeasonNumber(seasonNumber)}/credits`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  seasonAggregateCredits(seriesId, seasonNumber, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toSeasonNumber(seasonNumber)}/aggregate_credits`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  seasonImages(seriesId, seasonNumber, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toSeasonNumber(seasonNumber)}/images`, {
+      query: withLanguage(this.#transport.defaults, {
+        include_image_language: toCommaList(options.includeImageLanguage),
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  seasonVideos(seriesId, seasonNumber, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toSeasonNumber(seasonNumber)}/videos`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  episodeDetails(seriesId, seasonNumber, episodeNumber, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toSeasonNumber(seasonNumber)}/episode/${toId(episodeNumber, "episodeNumber")}`, {
+      query: withLanguage(this.#transport.defaults, {
+        append_to_response: toCommaList(options.appendToResponse),
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  aggregateCredits(seriesId, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/aggregate_credits`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  episodeGroups(seriesId, options = {}) {
+    return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/episode_groups`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+  episodeGroup(groupId, options = {}) {
+    return this.#transport.get(`/tv/episode_group/${toGroupId(groupId)}`, {
+      query: withLanguage(this.#transport.defaults, {
+        language: options.language
+      }),
+      signal: options.signal
+    });
+  }
+}
 function tvListQuery(transport, options) {
-	return withLanguage(transport.defaults, {
-		language: options.language,
-		page: options.page
-	});
-}
-//#endregion
-//#region src/client.ts
-/**
-* Main SDK entry point.
-*
-* Resource properties are intentionally small and explicit. The SDK focuses on
-* common TMDB workflows first, while request<T>() keeps uncommon endpoints easy
-* to call without waiting for a generated surface area.
-*/
-var TMDBClient = class {
-	configuration;
-	genres;
-	images;
-	movies;
-	people;
-	search;
-	trending;
-	tv;
-	#transport;
-	constructor(options) {
-		const { transport, images, ...httpOptions } = options;
-		const fallbackTransform = images?.transform;
-		const builtInClient = transport === void 0 ? new TMDBHttpClient({
-			...httpOptions,
-			images
-		}) : void 0;
-		this.#transport = builtInClient ?? transport;
-		this.configuration = new ConfigurationResource(this.#transport);
-		this.genres = new GenresResource(this.#transport);
-		this.images = new ImagesHelper(this.#transport, builtInClient ? builtInClient.imageTransform : fallbackTransform);
-		this.movies = new MoviesResource(this.#transport);
-		this.people = new PeopleResource(this.#transport);
-		this.search = new SearchResource(this.#transport);
-		this.trending = new TrendingResource(this.#transport);
-		this.tv = new TVResource(this.#transport);
-	}
-	/**
-	* Make a raw GET request to any TMDB endpoint.
-	*
-	* This is an escape hatch for endpoints not covered by the typed resource
-	* helpers. The `path` should be relative to the API base URL (e.g.
-	* `/movie/{id}/credits`). Response is parsed as JSON and cast to `T`.
-	*
-	* @param path - API path relative to the base URL (e.g. `/movie/123`)
-	* @param options - Optional request-level overrides (headers, query, signal)
-	* @returns Parsed JSON response typed as `T`
-	*/
-	request(path, options) {
-		return this.#transport.get(path, options);
-	}
-};
-/**
-* Create a new {@link TMDBClient} instance.
-*
-* @example
-* ```ts
-* const tmdb = createTMDB({ accessToken: 'YOUR_TOKEN' })
-* const { results } = await tmdb.search.movies('Inception')
-* ```
-*
-* @param options - Authentication and configuration options
-* @returns A configured TMDBClient ready to make API calls
-*/
+  return withLanguage(transport.defaults, {
+    language: options.language,
+    page: options.page
+  });
+}
+
+// src/client.ts
+class TMDBClient {
+  configuration;
+  genres;
+  images;
+  movies;
+  people;
+  search;
+  trending;
+  tv;
+  #transport;
+  constructor(options) {
+    let imageTransform = options.images?.transform;
+    if (options.transport === undefined) {
+      const builtInClient = new TMDBHttpClient(options);
+      this.#transport = builtInClient;
+      imageTransform = builtInClient.imageTransform;
+    } else {
+      this.#transport = options.transport;
+    }
+    this.configuration = new ConfigurationResource(this.#transport);
+    this.genres = new GenresResource(this.#transport);
+    this.images = new ImagesHelper(this.#transport, imageTransform);
+    this.movies = new MoviesResource(this.#transport);
+    this.people = new PeopleResource(this.#transport);
+    this.search = new SearchResource(this.#transport);
+    this.trending = new TrendingResource(this.#transport);
+    this.tv = new TVResource(this.#transport);
+  }
+  request(path, options) {
+    return this.#transport.get(path, options);
+  }
+}
 function createTMDB(options) {
-	return new TMDBClient(options);
+  return new TMDBClient(options);
 }
-//#endregion
-//#region src/search-guards.ts
+// src/helpers/cache.ts
+function withMemoryCache(transport, options = {}) {
+  const ttlMs = options.ttlMs ?? 5 * 60000;
+  const maxEntries = options.maxEntries ?? 100;
+  if (!Number.isFinite(ttlMs) || ttlMs <= 0) {
+    throw new RangeError("ttlMs must be a positive number");
+  }
+  if (!Number.isInteger(maxEntries) || maxEntries < 1) {
+    throw new RangeError("maxEntries must be a positive integer");
+  }
+  const entries = new Map;
+  return {
+    ...transport,
+    async get(path, requestOptions = {}) {
+      const key = cacheKey(path, requestOptions);
+      const cached = entries.get(key);
+      if (cached !== undefined) {
+        if (cached.expiresAt > Date.now()) {
+          entries.delete(key);
+          entries.set(key, cached);
+          return cached.value;
+        }
+        entries.delete(key);
+      }
+      const value = await transport.get(path, requestOptions);
+      entries.set(key, { expiresAt: Date.now() + ttlMs, value });
+      evictOverflow(entries, maxEntries);
+      return value;
+    },
+    clear() {
+      entries.clear();
+    }
+  };
+}
+function cacheKey(path, options) {
+  return `${path}?${serializeQuery(options.query)}|${serializeHeaders(options.headers)}`;
+}
+function serializeQuery(query) {
+  if (query === undefined) {
+    return "";
+  }
+  return Object.entries(query).filter(([, value]) => value !== undefined && value !== null).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}=${Array.isArray(value) ? value.map(String).join(",") : String(value)}`).join("&");
+}
+function serializeHeaders(headers) {
+  if (headers === undefined) {
+    return "";
+  }
+  return [...new Headers(headers)].sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}:${value}`).join("|");
+}
+function evictOverflow(entries, maxEntries) {
+  while (entries.size > maxEntries) {
+    entries.delete(entries.keys().next().value);
+  }
+}
+// src/helpers/pagination.ts
+async function* paginate(fetchPage, options = {}) {
+  const startPage = options.startPage ?? 1;
+  const endPage = options.endPage ?? 500;
+  assertPositiveInteger(startPage, "startPage");
+  assertPositiveInteger(endPage, "endPage");
+  for (let page = startPage;page <= endPage; page += 1) {
+    options.signal?.throwIfAborted();
+    const response = await fetchPage(page);
+    yield response;
+    if (response.results.length === 0 || page >= response.total_pages) {
+      return;
+    }
+  }
+}
+async function* paginateItems(fetchPage, options = {}) {
+  for await (const page of paginate(fetchPage, options)) {
+    yield* page.results;
+  }
+}
+function assertPositiveInteger(value, name) {
+  if (!Number.isInteger(value) || value < 1) {
+    throw new RangeError(`${name} must be a positive integer`);
+  }
+}
+// src/helpers/retry.ts
+var MAX_RETRY_AFTER_MS = 60000;
+async function retry(task, options = {}) {
+  const retries = options.retries ?? 2;
+  if (!Number.isInteger(retries) || retries < 0) {
+    throw new RangeError("retries must be a non-negative integer");
+  }
+  const retryOn = options.retryOn ?? shouldRetry;
+  const signal = options.signal;
+  if (signal?.aborted) {
+    throw signal.reason;
+  }
+  for (let attempt = 0;; attempt += 1) {
+    try {
+      return await task();
+    } catch (error) {
+      if (signal?.aborted) {
+        throw signal.reason;
+      }
+      if (attempt >= retries || !retryOn(error, attempt)) {
+        throw error;
+      }
+      const delayMs = retryDelay(error, attempt, options);
+      options.onRetry?.({ attempt, delayMs, error });
+      await sleep(delayMs, signal);
+    }
+  }
+}
+function withRetry(transport, options = {}) {
+  return {
+    ...transport,
+    get(path, requestOptions) {
+      const { cleanup, signal } = combineSignals(options.signal, requestOptions?.signal);
+      const effectiveOptions = signal === undefined ? requestOptions : { ...requestOptions, signal };
+      return retry(() => transport.get(path, effectiveOptions), {
+        ...options,
+        signal
+      }).finally(cleanup);
+    }
+  };
+}
+function shouldRetry(error) {
+  if (error instanceof TMDBRateLimitError) {
+    return true;
+  }
+  if (error instanceof TMDBResponseError) {
+    return error.isServerError || error.status === 408;
+  }
+  if (error instanceof TMDBTimeoutError) {
+    return false;
+  }
+  if (error instanceof TMDBRequestError) {
+    if (error.cause === undefined || error.cause instanceof TMDBTimeoutError) {
+      return false;
+    }
+    return !isAbortError(error.cause);
+  }
+  return false;
+}
+function retryDelay(error, attempt, options) {
+  const retryAfter = retryAfterMs(error);
+  if (retryAfter !== undefined) {
+    return Math.min(Math.max(retryAfter, 0), MAX_RETRY_AFTER_MS);
+  }
+  if (error instanceof TMDBRateLimitError) {
+    return Math.min(Math.max(error.retryAfter * 1000, 0), MAX_RETRY_AFTER_MS);
+  }
+  const baseDelayMs = options.baseDelayMs ?? 250;
+  const maxDelayMs = options.maxDelayMs ?? 1e4;
+  const factor = options.factor ?? 2;
+  const delay = Math.min(maxDelayMs, baseDelayMs * factor ** attempt);
+  return options.jitter === false ? delay : Math.random() * delay;
+}
+function retryAfterMs(error) {
+  if (!(error instanceof TMDBResponseError)) {
+    return;
+  }
+  const header = error.headers.get("retry-after");
+  if (header === null || header.trim() === "") {
+    return;
+  }
+  return parseRetryAfter(header) * 1000;
+}
+function combineSignals(first, second) {
+  if (first === undefined || second === undefined || first === second) {
+    return { cleanup: noop, signal: first ?? second };
+  }
+  const controller = new AbortController;
+  const onAbort = () => controller.abort((first.aborted ? first : second).reason);
+  first.addEventListener("abort", onAbort, { once: true });
+  second.addEventListener("abort", onAbort, { once: true });
+  if (first.aborted || second.aborted) {
+    onAbort();
+  }
+  return {
+    cleanup() {
+      first.removeEventListener("abort", onAbort);
+      second.removeEventListener("abort", onAbort);
+    },
+    signal: controller.signal
+  };
+}
+function noop() {}
+function isAbortError(error) {
+  return typeof error === "object" && error !== null && "name" in error && error.name === "AbortError";
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    const onAbort = () => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", onAbort);
+      reject(signal.reason);
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
+    if (signal?.aborted) {
+      onAbort();
+    }
+  });
+}
+// src/helpers/timeout.ts
+async function withTimeout(timeoutMs, task, options = {}) {
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw new RangeError("timeoutMs must be a positive number");
+  }
+  const parent = options.signal;
+  const controller = new AbortController;
+  const timeoutError = new TMDBTimeoutError(timeoutMs, options.message);
+  const onAbort = () => controller.abort(parent.reason);
+  parent?.addEventListener("abort", onAbort, { once: true });
+  if (parent?.aborted) {
+    parent.removeEventListener("abort", onAbort);
+    throw parent.reason;
+  }
+  const timer = setTimeout(() => controller.abort(timeoutError), timeoutMs);
+  try {
+    return await task(controller.signal);
+  } catch (error) {
+    if (controller.signal.reason === timeoutError) {
+      throw timeoutError;
+    }
+    if (parent?.aborted) {
+      throw parent.reason;
+    }
+    throw error;
+  } finally {
+    clearTimeout(timer);
+    parent?.removeEventListener("abort", onAbort);
+  }
+}
+// src/search-guards.ts
 function isMovieSearchResult(result) {
-	return isObjectWithMediaType(result, "movie");
+  return isObjectWithMediaType(result, "movie");
 }
 function isTVSearchResult(result) {
-	return isObjectWithMediaType(result, "tv");
+  return isObjectWithMediaType(result, "tv");
 }
 function isPersonSearchResult(result) {
-	return isObjectWithMediaType(result, "person");
+  return isObjectWithMediaType(result, "person");
 }
 function isMovie(result) {
-	return isObjectWithMediaType(result, "movie");
+  return isObjectWithMediaType(result, "movie");
 }
 function isTV(result) {
-	return isObjectWithMediaType(result, "tv");
+  return isObjectWithMediaType(result, "tv");
 }
 function isPerson(result) {
-	return isObjectWithMediaType(result, "person");
+  return isObjectWithMediaType(result, "person");
 }
-/** Internal helper: check if a value is an object with a matching `media_type` field. */
 function isObjectWithMediaType(value, mediaType) {
-	return typeof value === "object" && value !== null && "media_type" in value && value.media_type === mediaType;
-}
-//#endregion
-//#region src/types.ts
-/**
-* Public set of image sizes TMDB currently documents. The SDK does not
-* pin to a static copy of the TMDB docs — TMDB has added new sizes in
-* the past (e.g. `h632` for profile) without notice — but exposing the
-* canonical list lets callers:
-*
-* - iterate over the set to build a size picker
-* - validate user-supplied sizes with `isKnownBackdropSize(...)` etc.
-* - type a variable as a "known" size without giving up the
-*   `(string & {})` escape hatch for forward-compatibility
-*
-* If TMDB publishes a new size, the SDK will still accept it at runtime
-* (every helper is `(string & {})` permissive), but you will need to
-* add the literal to these constants to get autocomplete on it.
-*/
-const KNOWN_BACKDROP_SIZES = Object.freeze([
-	"w300",
-	"w780",
-	"w1280",
-	"original"
-]);
-const KNOWN_LOGO_SIZES = Object.freeze([
-	"w45",
-	"w92",
-	"w154",
-	"w185",
-	"w300",
-	"w500",
-	"original"
-]);
-const KNOWN_POSTER_SIZES = Object.freeze([
-	"w92",
-	"w154",
-	"w185",
-	"w342",
-	"w500",
-	"w780",
-	"original"
+  return typeof value === "object" && value !== null && "media_type" in value && value.media_type === mediaType;
+}
+// src/types.ts
+var KNOWN_BACKDROP_SIZES = Object.freeze([
+  "w300",
+  "w780",
+  "w1280",
+  "original"
 ]);
-const KNOWN_PROFILE_SIZES = Object.freeze([
-	"w45",
-	"w185",
-	"h632",
-	"original"
+var KNOWN_LOGO_SIZES = Object.freeze(["w45", "w92", "w154", "w185", "w300", "w500", "original"]);
+var KNOWN_POSTER_SIZES = Object.freeze(["w92", "w154", "w185", "w342", "w500", "w780", "original"]);
+var KNOWN_PROFILE_SIZES = Object.freeze([
+  "w45",
+  "w185",
+  "h632",
+  "original"
 ]);
-const KNOWN_STILL_SIZES = Object.freeze([
-	"w92",
-	"w185",
-	"w300",
-	"original"
+var KNOWN_STILL_SIZES = Object.freeze([
+  "w92",
+  "w185",
+  "w300",
+  "original"
 ]);
-/** Union of every documented image size. */
-const KNOWN_IMAGE_SIZES = Object.freeze([
-	...KNOWN_BACKDROP_SIZES,
-	...KNOWN_LOGO_SIZES,
-	...KNOWN_POSTER_SIZES,
-	...KNOWN_PROFILE_SIZES,
-	...KNOWN_STILL_SIZES
+var KNOWN_IMAGE_SIZES = Object.freeze([
+  ...KNOWN_BACKDROP_SIZES,
+  ...KNOWN_LOGO_SIZES,
+  ...KNOWN_POSTER_SIZES,
+  ...KNOWN_PROFILE_SIZES,
+  ...KNOWN_STILL_SIZES
 ]);
-/** O(1) membership check backed by a Set. */
-const KNOWN_BACKDROP_SET = new Set(KNOWN_BACKDROP_SIZES);
-const KNOWN_LOGO_SET = new Set(KNOWN_LOGO_SIZES);
-const KNOWN_POSTER_SET = new Set(KNOWN_POSTER_SIZES);
-const KNOWN_PROFILE_SET = new Set(KNOWN_PROFILE_SIZES);
-const KNOWN_STILL_SET = new Set(KNOWN_STILL_SIZES);
-const KNOWN_IMAGE_SET = new Set(KNOWN_IMAGE_SIZES);
+var KNOWN_BACKDROP_SET = new Set(KNOWN_BACKDROP_SIZES);
+var KNOWN_LOGO_SET = new Set(KNOWN_LOGO_SIZES);
+var KNOWN_POSTER_SET = new Set(KNOWN_POSTER_SIZES);
+var KNOWN_PROFILE_SET = new Set(KNOWN_PROFILE_SIZES);
+var KNOWN_STILL_SET = new Set(KNOWN_STILL_SIZES);
+var KNOWN_IMAGE_SET = new Set(KNOWN_IMAGE_SIZES);
 function isKnownBackdropSize(value) {
-	return KNOWN_BACKDROP_SET.has(value);
+  return KNOWN_BACKDROP_SET.has(value);
 }
 function isKnownLogoSize(value) {
-	return KNOWN_LOGO_SET.has(value);
+  return KNOWN_LOGO_SET.has(value);
 }
 function isKnownPosterSize(value) {
-	return KNOWN_POSTER_SET.has(value);
+  return KNOWN_POSTER_SET.has(value);
 }
 function isKnownProfileSize(value) {
-	return KNOWN_PROFILE_SET.has(value);
+  return KNOWN_PROFILE_SET.has(value);
 }
 function isKnownStillSize(value) {
-	return KNOWN_STILL_SET.has(value);
+  return KNOWN_STILL_SET.has(value);
 }
-/** True if `value` is in any documented size set. */
 function isKnownImageSize(value) {
-	return KNOWN_IMAGE_SET.has(value);
+  return KNOWN_IMAGE_SET.has(value);
 }
-//#endregion
-export { KNOWN_BACKDROP_SIZES, KNOWN_IMAGE_SIZES, KNOWN_LOGO_SIZES, KNOWN_POSTER_SIZES, KNOWN_PROFILE_SIZES, KNOWN_STILL_SIZES, TMDBClient, TMDBError, TMDBRateLimitError, TMDBRequestError, TMDBResponseError, buildImageUrl, createTMDB, isKnownBackdropSize, isKnownImageSize, isKnownLogoSize, isKnownPosterSize, isKnownProfileSize, isKnownStillSize, isMovie, isMovieSearchResult, isPerson, isPersonSearchResult, isTV, isTVSearchResult };
+export {
+  KNOWN_BACKDROP_SIZES,
+  KNOWN_IMAGE_SIZES,
+  KNOWN_LOGO_SIZES,
+  KNOWN_POSTER_SIZES,
+  KNOWN_PROFILE_SIZES,
+  KNOWN_STILL_SIZES,
+  TMDBClient,
+  TMDBError,
+  TMDBHttpClient,
+  TMDBRateLimitError,
+  TMDBRequestError,
+  TMDBResponseError,
+  TMDBTimeoutError,
+  buildImageUrl,
+  createTMDB,
+  isKnownBackdropSize,
+  isKnownImageSize,
+  isKnownLogoSize,
+  isKnownPosterSize,
+  isKnownProfileSize,
+  isKnownStillSize,
+  isMovie,
+  isMovieSearchResult,
+  isPerson,
+  isPersonSearchResult,
+  isTV,
+  isTVSearchResult,
+  paginate,
+  paginateItems,
+  retry,
+  withMemoryCache,
+  withRetry,
+  withTimeout
+};
 
-//# sourceMappingURL=index.js.map
+//# debugId=24603BBDC4DA497C64756E2164756E21
+//# sourceMappingURL=index.js.map