@lorenzopant/tmdb 1.18.0 → 1.18.1

package/dist/index.d.mts

@@ -477,6 +477,14 @@ type ImagesConfig = {
    * Provide default image size configuration for each type of images.
    */
   default_image_sizes?: Partial<DefaultImageSizesConfig>;
+  /**
+   * Automatically expand TMDB image paths found in API responses into full URLs
+   * using the configured default image sizes.
+   *
+   * This is disabled by default to preserve the existing response shape semantics,
+   * where fields like `poster_path` contain the original relative TMDB path.
+   */
+  autocomplete_paths?: boolean;
 };
 //#endregion
 //#region src/errors/tmdb.d.ts
@@ -3367,9 +3375,11 @@ declare class ApiClient {
   private requestInterceptors;
   private onSuccessInterceptor?;
   private onErrorInterceptor?;
+  private imageApi?;
   constructor(accessToken: string, options?: {
     logger?: boolean | TMDBLoggerFn;
     deduplication?: boolean;
+    images?: ImagesConfig;
     interceptors?: {
       request?: RequestInterceptor | RequestInterceptor[];
       response?: {
@@ -4459,6 +4469,26 @@ declare class ImageAPI {
   poster(path: string, size?: PosterSize): string;
   profile(path: string, size?: ProfileSize): string;
   still(path: string, size?: StillSize): string;
+  /**
+   * Recursively processes an object or array to autocomplete image paths by transforming string values
+   * and tracking the current image collection context.
+   *
+   * @template T - The type of the value being processed
+   * @param value - The value to process (can be an object, array, string, or primitive)
+   * @param collectionKey - Optional image collection key to maintain context during recursion
+   * @returns The processed value with autocompleted image paths, maintaining the original type
+   *
+   * @remarks
+   * - Arrays are recursively mapped over each entry
+   * - String values are transformed using {@link transformPathValue}
+   * - Object keys that match image collection keys update the collection context
+   * - Non-plain objects (e.g. Date/class instances) are returned unchanged
+   */
+  autocompleteImagePaths<T>(value: T, collectionKey?: ImageCollectionKey): T;
+  private isImageCollectionKey;
+  private isFullUrl;
+  private buildImageUrl;
+  private transformPathValue;
 }
 //#endregion
 //#region src/endpoints/networks.d.ts
@@ -5121,7 +5151,18 @@ declare class TMDB {
 //#region src/utils/jwt.d.ts
 declare function isJwt(token: string): boolean;
 //#endregion
-//#region src/utils/index.d.ts
+//#region src/utils/types.d.ts
+/**
+ * Typeguard that checks if a value is a record object.
+ * @param value - The value to check
+ * @returns `true` if the value is a non-null object that is not an array, `false` otherwise
+ */
+declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Typeguard that checks whether a value is a plain object.
+ * Plain objects are objects whose prototype is `Object.prototype` or `null`.
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
 /** Utility type guard to check if an object has a poster_path property */
 declare function hasPosterPath(data: unknown): data is {
   poster_path: string;
@@ -5143,4 +5184,4 @@ declare function hasLogoPath(data: unknown): data is {
   logo_path: string;
 };
 //#endregion
-export { AccountAPI, AccountAddFavoriteBody, AccountAddToWatchlistBody, AccountAvatar, AccountDetails, AccountDetailsParams, AccountListItem, AccountListsParams, AccountListsResponse, AccountMediaListParams, AccountMovieItem, AccountMovieListResponse, AccountMutationParams, AccountMutationResponse, AccountRatedEpisodeItem, AccountRatedEpisodesResponse, AccountRatedMovieItem, AccountRatedMoviesResponse, AccountRatedTVItem, AccountRatedTVResponse, AccountSortBy, AccountTVItem, AccountTVListResponse, AlternativeName, AlternativeNamesResult, AlternativeTitle, AuthCreateSessionBody, AuthCreateSessionResponse, AuthCreateSessionWithLoginBody, AuthDeleteSessionBody, AuthDeleteSessionResponse, AuthGuestSessionResponse, AuthRequestTokenResponse, AuthValidateKeyResponse, AuthenticationAPI, BACKDROP_SIZES, BackdropSize, Cast, CertificationItem, Certifications, CertificationsAPI, Change, ChangeItem, ChangeResultItem, Changes, ChangesAPI, Collection, CollectionBaseParam, CollectionDetailsParams, CollectionImages, CollectionImagesParams, CollectionItem, CollectionResultItem, CollectionTranslationData, CollectionTranslations, CollectionsAPI, CompaniesAPI, Company, CompanyAlternativeName, CompanyAlternativeNames, CompanyAlternativeNamesParams, CompanyBaseParam, CompanyDetailsParams, CompanyImages, CompanyImagesParams, CompanyResultItem, CompanySummary, ConfigurationAPI, ConfigurationCountriesParams, ConfigurationCountry, ConfigurationJob, ConfigurationLanguage, ConfigurationResponse, ConfigurationTimezone, ContentRating, CountryISO3166_1, Credit, CreditBaseParam, CreditDetails, CreditDetailsMedia, CreditDetailsMovieMedia, CreditDetailsParams, CreditDetailsPerson, CreditDetailsTVEpisode, CreditDetailsTVMedia, CreditDetailsTVSeason, CreditsAPI, Crew, DateRange, DefaultImageSizesConfig, DiscoverAPI, DiscoverFilterExpression, DiscoverMovieParams, DiscoverMovieSortBy, DiscoverTVParams, DiscoverTVResultItem, DiscoverTVSortBy, DiscoverTVStatus, DiscoverTVType, FileType, FindAPI, FindByIDParams, FindExternalSource, FindMovieResultItem, FindPersonResultItem, FindResults, FindTVEpisodeResultItem, FindTVResultItem, FindTVSeasonResultItem, Genre, GenresAPI, GenresResponse, IMAGE_BASE_URL, IMAGE_SECURE_BASE_URL, ImageCollectionKey, ImageConfiguration, ImageItem, ImageSize, ImageSizeTypes, ImagesConfig, ImagesResult, Keyword, KeywordBaseParam, KeywordDetailsParams, KeywordMoviesParams, KeywordResultItem, KeywordsAPI, KnownForItem, KnownForMovie, KnownForTV, LOGO_SIZES, Language, LanguageISO6391, LiteralUnion, LogoSize, MediaType, MediaWatchProviders, MovieAlternativeTitles, MovieAlternativeTitlesParams, MovieAppendToResponseNamespace, MovieAppendableMap, MovieChanges, MovieChangesParams, MovieCollection, MovieCredits, MovieCreditsParams, MovieDetails, MovieDetailsParams, MovieDetailsWithAppends, MovieExternalIDs, MovieExternalIDsParams, MovieImages, MovieImagesParams, MovieKeywords, MovieKeywordsParams, MovieListParams, MovieListsAPI, MovieRecommendations, MovieRecommendationsParams, MovieReleaseDate, MovieReleaseDateResult, MovieReleaseDates, MovieReleaseDatesParams, MovieResultItem, MovieReviews, MovieReviewsParams, MovieSimilar, MovieSimilarParams, MovieTranslationData, MovieTranslations, MovieTranslationsParams, MovieVideos, MovieVideosParams, MovieWatchProvidersParams, MoviesAPI, MultiSearchResultItem, Network, NetworkBaseParams, NetworkImages, NetworkItem, NetworksAPI, OrganizationImage, POSTER_SIZES, PROFILE_SIZES, PaginatedResponse, PeopleAPI, PeopleListParams, PeopleListsAPI, PersonAppendToResponseNamespace, PersonAppendableMap, PersonBaseParam, PersonChanges, PersonChangesParams, PersonCombinedCastCredit, PersonCombinedCredits, PersonCombinedCrewCredit, PersonCreditsParams, PersonDetails, PersonDetailsParams, PersonDetailsWithAppends, PersonExternalIDs, PersonExternalIDsParams, PersonImages, PersonImagesParams, PersonMovieCastCredit, PersonMovieCredits, PersonMovieCrewCredit, PersonResultItem, PersonTVCastCredit, PersonTVCredits, PersonTVCrewCredit, PersonTaggedImage, PersonTaggedImageMedia, PersonTaggedImages, PersonTaggedImagesParams, PersonTranslationData, PersonTranslations, PersonTranslationsParams, PosterSize, Prettify, PrimaryTranslations, ProductionCompany, ProductionCountry, ProfileSize, RequestInterceptor, RequestInterceptorContext, ResponseErrorInterceptor, ResponseSuccessInterceptor, Review, ReviewAuthorDetails, ReviewDetails, ReviewDetailsParams, ReviewsAPI, STILL_SIZES, SearchAPI, SearchCollectionsParams, SearchCompanyParams, SearchKeywordsParams, SearchMoviesParams, SearchMultiParams, SearchPersonParams, SearchTVSeriesParams, SpokenLanguage, StillSize, TMDB, TMDBCountries, TMDBError, TMDBLogger, TMDBLoggerEntry, TMDBLoggerFn, TMDBOptions, TMDBQueryParams, TVAggregateCredits, TVAggregateCreditsCastItem, TVAggregateCreditsCrewItem, TVAggregateCreditsParams, TVAlternativeTitles, TVAppendToResponseNamespace, TVAppendableMap, TVBaseParam, TVChangeParams, TVContentRatings, TVCreditJob, TVCreditRole, TVCredits, TVCreditsParams, TVDetailsParams, TVDetailsWithAppends, TVEpisode, TVEpisodeAppendToResponseNamespace, TVEpisodeAppendableMap, TVEpisodeBaseParams, TVEpisodeCredits, TVEpisodeCreditsParams, TVEpisodeDetailsParams, TVEpisodeDetailsWithAppends, TVEpisodeExternalIDs, TVEpisodeGroupDetails, TVEpisodeGroupDetailsItem, TVEpisodeGroupEpisode, TVEpisodeGroupItem, TVEpisodeGroupParams, TVEpisodeGroupType, TVEpisodeGroups, TVEpisodeGroupsAPI, TVEpisodeId, TVEpisodeImages, TVEpisodeImagesParams, TVEpisodeItem, TVEpisodeTranslationData, TVEpisodeTranslations, TVEpisodeVideos, TVEpisodesAPI, TVExternalIDs, TVImageItem, TVImages, TVImagesParams, TVKeywords, TVRecommendations, TVRecommendationsParams, TVReviews, TVReviewsParams, TVScreenedTheatrically, TVScreeningItem, TVSeason, TVSeasonAggregateCredits, TVSeasonAggregateCreditsParams, TVSeasonAppendToResponseNamespace, TVSeasonAppendableMap, TVSeasonBaseParams, TVSeasonChanges, TVSeasonChangesParams, TVSeasonCredits, TVSeasonCreditsParams, TVSeasonDetailsParams, TVSeasonDetailsWithAppends, TVSeasonEpisode, TVSeasonExternalIDs, TVSeasonId, TVSeasonImages, TVSeasonImagesParams, TVSeasonItem, TVSeasonTranslationData, TVSeasonTranslations, TVSeasonVideos, TVSeasonVideosParams, TVSeasonWatchProvidersParams, TVSeasonsAPI, TVSeriesAPI, TVSeriesChanges, TVSeriesDetails, TVSeriesListItem, TVSeriesListParams, TVSeriesLists, TVSeriesListsAPI, TVSeriesListsParams, TVSeriesResultItem, TVSimilar, TVSimilarParams, TVTranslationData, TVTranslations, TVVideos, Timezone, Translation, TranslationResults, TrendingAPI, TrendingAllResult, TrendingMovieResult, TrendingParams, TrendingPersonResult, TrendingTVResult, TrendingTimeWindow, VideoItem, VideoResults, WatchMonetizationType, WatchProvider, WatchProviderDisplayPriorities, WatchProviderItem, WatchProviderListItem, WatchProviderListParams, WatchProviderListResponse, WatchProviderRegionsParams, WatchProviderRegionsResponse, WatchProvidersAPI, WithLanguage, WithLanguagePage, WithPage, WithPageAndDateRange, WithParams, WithRegion, hasBackdropPath, hasLogoPath, hasPosterPath, hasProfilePath, hasStillPath, isJwt, isKnownForMovie, isKnownForTV };
+export { AccountAPI, AccountAddFavoriteBody, AccountAddToWatchlistBody, AccountAvatar, AccountDetails, AccountDetailsParams, AccountListItem, AccountListsParams, AccountListsResponse, AccountMediaListParams, AccountMovieItem, AccountMovieListResponse, AccountMutationParams, AccountMutationResponse, AccountRatedEpisodeItem, AccountRatedEpisodesResponse, AccountRatedMovieItem, AccountRatedMoviesResponse, AccountRatedTVItem, AccountRatedTVResponse, AccountSortBy, AccountTVItem, AccountTVListResponse, AlternativeName, AlternativeNamesResult, AlternativeTitle, AuthCreateSessionBody, AuthCreateSessionResponse, AuthCreateSessionWithLoginBody, AuthDeleteSessionBody, AuthDeleteSessionResponse, AuthGuestSessionResponse, AuthRequestTokenResponse, AuthValidateKeyResponse, AuthenticationAPI, BACKDROP_SIZES, BackdropSize, Cast, CertificationItem, Certifications, CertificationsAPI, Change, ChangeItem, ChangeResultItem, Changes, ChangesAPI, Collection, CollectionBaseParam, CollectionDetailsParams, CollectionImages, CollectionImagesParams, CollectionItem, CollectionResultItem, CollectionTranslationData, CollectionTranslations, CollectionsAPI, CompaniesAPI, Company, CompanyAlternativeName, CompanyAlternativeNames, CompanyAlternativeNamesParams, CompanyBaseParam, CompanyDetailsParams, CompanyImages, CompanyImagesParams, CompanyResultItem, CompanySummary, ConfigurationAPI, ConfigurationCountriesParams, ConfigurationCountry, ConfigurationJob, ConfigurationLanguage, ConfigurationResponse, ConfigurationTimezone, ContentRating, CountryISO3166_1, Credit, CreditBaseParam, CreditDetails, CreditDetailsMedia, CreditDetailsMovieMedia, CreditDetailsParams, CreditDetailsPerson, CreditDetailsTVEpisode, CreditDetailsTVMedia, CreditDetailsTVSeason, CreditsAPI, Crew, DateRange, DefaultImageSizesConfig, DiscoverAPI, DiscoverFilterExpression, DiscoverMovieParams, DiscoverMovieSortBy, DiscoverTVParams, DiscoverTVResultItem, DiscoverTVSortBy, DiscoverTVStatus, DiscoverTVType, FileType, FindAPI, FindByIDParams, FindExternalSource, FindMovieResultItem, FindPersonResultItem, FindResults, FindTVEpisodeResultItem, FindTVResultItem, FindTVSeasonResultItem, Genre, GenresAPI, GenresResponse, IMAGE_BASE_URL, IMAGE_SECURE_BASE_URL, ImageCollectionKey, ImageConfiguration, ImageItem, ImageSize, ImageSizeTypes, ImagesConfig, ImagesResult, Keyword, KeywordBaseParam, KeywordDetailsParams, KeywordMoviesParams, KeywordResultItem, KeywordsAPI, KnownForItem, KnownForMovie, KnownForTV, LOGO_SIZES, Language, LanguageISO6391, LiteralUnion, LogoSize, MediaType, MediaWatchProviders, MovieAlternativeTitles, MovieAlternativeTitlesParams, MovieAppendToResponseNamespace, MovieAppendableMap, MovieChanges, MovieChangesParams, MovieCollection, MovieCredits, MovieCreditsParams, MovieDetails, MovieDetailsParams, MovieDetailsWithAppends, MovieExternalIDs, MovieExternalIDsParams, MovieImages, MovieImagesParams, MovieKeywords, MovieKeywordsParams, MovieListParams, MovieListsAPI, MovieRecommendations, MovieRecommendationsParams, MovieReleaseDate, MovieReleaseDateResult, MovieReleaseDates, MovieReleaseDatesParams, MovieResultItem, MovieReviews, MovieReviewsParams, MovieSimilar, MovieSimilarParams, MovieTranslationData, MovieTranslations, MovieTranslationsParams, MovieVideos, MovieVideosParams, MovieWatchProvidersParams, MoviesAPI, MultiSearchResultItem, Network, NetworkBaseParams, NetworkImages, NetworkItem, NetworksAPI, OrganizationImage, POSTER_SIZES, PROFILE_SIZES, PaginatedResponse, PeopleAPI, PeopleListParams, PeopleListsAPI, PersonAppendToResponseNamespace, PersonAppendableMap, PersonBaseParam, PersonChanges, PersonChangesParams, PersonCombinedCastCredit, PersonCombinedCredits, PersonCombinedCrewCredit, PersonCreditsParams, PersonDetails, PersonDetailsParams, PersonDetailsWithAppends, PersonExternalIDs, PersonExternalIDsParams, PersonImages, PersonImagesParams, PersonMovieCastCredit, PersonMovieCredits, PersonMovieCrewCredit, PersonResultItem, PersonTVCastCredit, PersonTVCredits, PersonTVCrewCredit, PersonTaggedImage, PersonTaggedImageMedia, PersonTaggedImages, PersonTaggedImagesParams, PersonTranslationData, PersonTranslations, PersonTranslationsParams, PosterSize, Prettify, PrimaryTranslations, ProductionCompany, ProductionCountry, ProfileSize, RequestInterceptor, RequestInterceptorContext, ResponseErrorInterceptor, ResponseSuccessInterceptor, Review, ReviewAuthorDetails, ReviewDetails, ReviewDetailsParams, ReviewsAPI, STILL_SIZES, SearchAPI, SearchCollectionsParams, SearchCompanyParams, SearchKeywordsParams, SearchMoviesParams, SearchMultiParams, SearchPersonParams, SearchTVSeriesParams, SpokenLanguage, StillSize, TMDB, TMDBCountries, TMDBError, TMDBLogger, TMDBLoggerEntry, TMDBLoggerFn, TMDBOptions, TMDBQueryParams, TVAggregateCredits, TVAggregateCreditsCastItem, TVAggregateCreditsCrewItem, TVAggregateCreditsParams, TVAlternativeTitles, TVAppendToResponseNamespace, TVAppendableMap, TVBaseParam, TVChangeParams, TVContentRatings, TVCreditJob, TVCreditRole, TVCredits, TVCreditsParams, TVDetailsParams, TVDetailsWithAppends, TVEpisode, TVEpisodeAppendToResponseNamespace, TVEpisodeAppendableMap, TVEpisodeBaseParams, TVEpisodeCredits, TVEpisodeCreditsParams, TVEpisodeDetailsParams, TVEpisodeDetailsWithAppends, TVEpisodeExternalIDs, TVEpisodeGroupDetails, TVEpisodeGroupDetailsItem, TVEpisodeGroupEpisode, TVEpisodeGroupItem, TVEpisodeGroupParams, TVEpisodeGroupType, TVEpisodeGroups, TVEpisodeGroupsAPI, TVEpisodeId, TVEpisodeImages, TVEpisodeImagesParams, TVEpisodeItem, TVEpisodeTranslationData, TVEpisodeTranslations, TVEpisodeVideos, TVEpisodesAPI, TVExternalIDs, TVImageItem, TVImages, TVImagesParams, TVKeywords, TVRecommendations, TVRecommendationsParams, TVReviews, TVReviewsParams, TVScreenedTheatrically, TVScreeningItem, TVSeason, TVSeasonAggregateCredits, TVSeasonAggregateCreditsParams, TVSeasonAppendToResponseNamespace, TVSeasonAppendableMap, TVSeasonBaseParams, TVSeasonChanges, TVSeasonChangesParams, TVSeasonCredits, TVSeasonCreditsParams, TVSeasonDetailsParams, TVSeasonDetailsWithAppends, TVSeasonEpisode, TVSeasonExternalIDs, TVSeasonId, TVSeasonImages, TVSeasonImagesParams, TVSeasonItem, TVSeasonTranslationData, TVSeasonTranslations, TVSeasonVideos, TVSeasonVideosParams, TVSeasonWatchProvidersParams, TVSeasonsAPI, TVSeriesAPI, TVSeriesChanges, TVSeriesDetails, TVSeriesListItem, TVSeriesListParams, TVSeriesLists, TVSeriesListsAPI, TVSeriesListsParams, TVSeriesResultItem, TVSimilar, TVSimilarParams, TVTranslationData, TVTranslations, TVVideos, Timezone, Translation, TranslationResults, TrendingAPI, TrendingAllResult, TrendingMovieResult, TrendingParams, TrendingPersonResult, TrendingTVResult, TrendingTimeWindow, VideoItem, VideoResults, WatchMonetizationType, WatchProvider, WatchProviderDisplayPriorities, WatchProviderItem, WatchProviderListItem, WatchProviderListParams, WatchProviderListResponse, WatchProviderRegionsParams, WatchProviderRegionsResponse, WatchProvidersAPI, WithLanguage, WithLanguagePage, WithPage, WithPageAndDateRange, WithParams, WithRegion, hasBackdropPath, hasLogoPath, hasPosterPath, hasProfilePath, hasStillPath, isJwt, isKnownForMovie, isKnownForTV, isPlainObject, isRecord };

package/dist/index.mjs

@@ -39,6 +39,46 @@ var TMDBError = class extends Error {
 	}
 };
 //#endregion
+//#region src/types/config/images.ts
+const IMAGE_BASE_URL = "http://image.tmdb.org/t/p/";
+const IMAGE_SECURE_BASE_URL = "https://image.tmdb.org/t/p/";
+const BACKDROP_SIZES = [
+	"w300",
+	"w780",
+	"w1280",
+	"original"
+];
+const LOGO_SIZES = [
+	"w45",
+	"w92",
+	"w154",
+	"w185",
+	"w300",
+	"w500",
+	"original"
+];
+const POSTER_SIZES = [
+	"w92",
+	"w154",
+	"w185",
+	"w342",
+	"w500",
+	"w780",
+	"original"
+];
+const PROFILE_SIZES = [
+	"w45",
+	"w185",
+	"h632",
+	"original"
+];
+const STILL_SIZES = [
+	"w92",
+	"w185",
+	"w300",
+	"original"
+];
+//#endregion
 //#region src/utils/logger.ts
 var TMDBLogger = class TMDBLogger {
 	logger;
@@ -124,7 +164,24 @@ function isJwt(token) {
 	return true;
 }
 //#endregion
-//#region src/utils/index.ts
+//#region src/utils/types.ts
+/**
+* Typeguard that checks if a value is a record object.
+* @param value - The value to check
+* @returns `true` if the value is a non-null object that is not an array, `false` otherwise
+*/
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Typeguard that checks whether a value is a plain object.
+* Plain objects are objects whose prototype is `Object.prototype` or `null`.
+*/
+function isPlainObject(value) {
+	if (!isRecord(value)) return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+}
 /** Utility type guard to check if an object has a poster_path property */
 function hasPosterPath(data) {
 	return typeof data === "object" && data !== null && "poster_path" in data && typeof data.poster_path === "string";
@@ -146,6 +203,99 @@ function hasLogoPath(data) {
 	return typeof data === "object" && data !== null && "logo_path" in data && typeof data.logo_path === "string";
 }
 //#endregion
+//#region src/images/images.ts
+const IMAGE_PATH_BUILDERS = {
+	backdrop_path: "backdrop",
+	logo_path: "logo",
+	poster_path: "poster",
+	profile_path: "profile",
+	still_path: "still"
+};
+const IMAGE_COLLECTION_BUILDERS = {
+	backdrops: "backdrop_path",
+	logos: "logo_path",
+	posters: "poster_path",
+	profiles: "profile_path",
+	stills: "still_path"
+};
+var ImageAPI = class {
+	options;
+	constructor(options = {}) {
+		this.options = {
+			secure_images_url: true,
+			...options
+		};
+	}
+	buildUrl(path, size) {
+		return `${this.options.secure_images_url ? IMAGE_SECURE_BASE_URL : IMAGE_BASE_URL}${size}${path}`;
+	}
+	backdrop(path, size = this.options.default_image_sizes?.backdrops || "w780") {
+		return this.buildUrl(path, size);
+	}
+	logo(path, size = this.options.default_image_sizes?.logos || "w185") {
+		return this.buildUrl(path, size);
+	}
+	poster(path, size = this.options.default_image_sizes?.posters || "w500") {
+		return this.buildUrl(path, size);
+	}
+	profile(path, size = this.options.default_image_sizes?.profiles || "w185") {
+		return this.buildUrl(path, size);
+	}
+	still(path, size = this.options.default_image_sizes?.still || "w300") {
+		return this.buildUrl(path, size);
+	}
+	/**
+	* Recursively processes an object or array to autocomplete image paths by transforming string values
+	* and tracking the current image collection context.
+	*
+	* @template T - The type of the value being processed
+	* @param value - The value to process (can be an object, array, string, or primitive)
+	* @param collectionKey - Optional image collection key to maintain context during recursion
+	* @returns The processed value with autocompleted image paths, maintaining the original type
+	*
+	* @remarks
+	* - Arrays are recursively mapped over each entry
+	* - String values are transformed using {@link transformPathValue}
+	* - Object keys that match image collection keys update the collection context
+	* - Non-plain objects (e.g. Date/class instances) are returned unchanged
+	*/
+	autocompleteImagePaths(value, collectionKey) {
+		if (Array.isArray(value)) return value.map((entry) => this.autocompleteImagePaths(entry, collectionKey));
+		if (!isPlainObject(value)) return value;
+		const transformed = Object.create(null);
+		for (const [key, entry] of Object.entries(value)) {
+			if (key === "__proto__" || key === "constructor" || key === "prototype") {
+				transformed[key] = entry;
+				continue;
+			}
+			if (typeof entry === "string") {
+				transformed[key] = this.transformPathValue(key, entry, collectionKey);
+				continue;
+			}
+			const nextCollectionKey = this.isImageCollectionKey(key) ? key : collectionKey;
+			transformed[key] = this.autocompleteImagePaths(entry, nextCollectionKey);
+		}
+		return transformed;
+	}
+	isImageCollectionKey(value) {
+		return Object.hasOwn(IMAGE_COLLECTION_BUILDERS, value);
+	}
+	isFullUrl(path) {
+		return /^https?:\/\//.test(path);
+	}
+	buildImageUrl(key, path) {
+		const method = IMAGE_PATH_BUILDERS[key];
+		if (Object.hasOwn(this, method) || typeof this[method] !== "function") {}
+		return this[method](path);
+	}
+	transformPathValue(key, value, collectionKey) {
+		if (!value.startsWith("/") || this.isFullUrl(value)) return value;
+		if (Object.hasOwn(IMAGE_PATH_BUILDERS, key)) return this.buildImageUrl(key, value);
+		if (key === "file_path" && collectionKey) return this.buildImageUrl(IMAGE_COLLECTION_BUILDERS[collectionKey], value);
+		return value;
+	}
+};
+//#endregion
 //#region src/client.ts
 var ApiClient = class {
 	accessToken;
@@ -162,6 +312,7 @@ var ApiClient = class {
 	requestInterceptors;
 	onSuccessInterceptor;
 	onErrorInterceptor;
+	imageApi;
 	constructor(accessToken, options = {}) {
 		this.accessToken = accessToken;
 		this.logger = TMDBLogger.from(options.logger);
@@ -170,6 +321,7 @@ var ApiClient = class {
 		this.requestInterceptors = raw == null ? [] : Array.isArray(raw) ? raw : [raw];
 		this.onSuccessInterceptor = options.interceptors?.response?.onSuccess;
 		this.onErrorInterceptor = options.interceptors?.response?.onError;
+		this.imageApi = options.images?.autocomplete_paths ? new ImageAPI(options.images) : void 0;
 	}
 	/**
 	* Builds a stable, order-independent cache key for a request.
@@ -330,11 +482,12 @@ var ApiClient = class {
 		});
 		const data = await res.json();
 		const sanitized = this.sanitizeNulls(data);
+		const transformed = this.imageApi ? this.imageApi.autocompleteImagePaths(sanitized) : sanitized;
 		if (this.onSuccessInterceptor) {
-			const result = await this.onSuccessInterceptor(sanitized);
-			return result !== void 0 ? result : sanitized;
+			const result = await this.onSuccessInterceptor(transformed);
+			return result !== void 0 ? result : transformed;
 		}
-		return sanitized;
+		return transformed;
 	}
 };
 //#endregion
@@ -1894,75 +2047,6 @@ var WatchProvidersAPI = class extends TMDBAPIBase {
 	}
 };
 //#endregion
-//#region src/types/config/images.ts
-const IMAGE_BASE_URL = "http://image.tmdb.org/t/p/";
-const IMAGE_SECURE_BASE_URL = "https://image.tmdb.org/t/p/";
-const BACKDROP_SIZES = [
-	"w300",
-	"w780",
-	"w1280",
-	"original"
-];
-const LOGO_SIZES = [
-	"w45",
-	"w92",
-	"w154",
-	"w185",
-	"w300",
-	"w500",
-	"original"
-];
-const POSTER_SIZES = [
-	"w92",
-	"w154",
-	"w185",
-	"w342",
-	"w500",
-	"w780",
-	"original"
-];
-const PROFILE_SIZES = [
-	"w45",
-	"w185",
-	"h632",
-	"original"
-];
-const STILL_SIZES = [
-	"w92",
-	"w185",
-	"w300",
-	"original"
-];
-//#endregion
-//#region src/images/images.ts
-var ImageAPI = class {
-	options;
-	constructor(options = {}) {
-		this.options = {
-			secure_images_url: true,
-			...options
-		};
-	}
-	buildUrl(path, size) {
-		return `${this.options.secure_images_url ? IMAGE_SECURE_BASE_URL : IMAGE_BASE_URL}${size}${path}`;
-	}
-	backdrop(path, size = this.options.default_image_sizes?.backdrops || "w780") {
-		return this.buildUrl(path, size);
-	}
-	logo(path, size = this.options.default_image_sizes?.logos || "w185") {
-		return this.buildUrl(path, size);
-	}
-	poster(path, size = this.options.default_image_sizes?.posters || "w500") {
-		return this.buildUrl(path, size);
-	}
-	profile(path, size = this.options.default_image_sizes?.profiles || "w185") {
-		return this.buildUrl(path, size);
-	}
-	still(path, size = this.options.default_image_sizes?.still || "w300") {
-		return this.buildUrl(path, size);
-	}
-};
-//#endregion
 //#region src/endpoints/networks.ts
 var NetworksAPI = class extends TMDBAPIBase {
 	networkPath(network_id) {
@@ -2840,6 +2924,7 @@ var TMDB = class {
 		this.client = new ApiClient(accessToken, {
 			logger: options.logger,
 			deduplication: options.deduplication,
+			images: options.images,
 			interceptors: options.interceptors
 		});
 		this.movies = new MoviesAPI(this.client, this.options);
@@ -4187,4 +4272,4 @@ let TVEpisodeGroupType = /* @__PURE__ */ function(TVEpisodeGroupType) {
 	return TVEpisodeGroupType;
 }({});
 //#endregion
-export { AccountAPI, AuthenticationAPI, BACKDROP_SIZES, CertificationsAPI, ChangesAPI, CollectionsAPI, CompaniesAPI, ConfigurationAPI, CreditsAPI, DiscoverAPI, DiscoverTVStatus, DiscoverTVType, FindAPI, GenresAPI, IMAGE_BASE_URL, IMAGE_SECURE_BASE_URL, KeywordsAPI, LOGO_SIZES, MovieListsAPI, MoviesAPI, NetworksAPI, POSTER_SIZES, PROFILE_SIZES, PeopleAPI, PeopleListsAPI, ReviewsAPI, STILL_SIZES, SearchAPI, TMDB, TMDBCountries, TMDBError, TMDBLogger, TVEpisodeGroupType, TVEpisodeGroupsAPI, TVEpisodesAPI, TVSeasonsAPI, TVSeriesAPI, TVSeriesListsAPI, TrendingAPI, WatchProvidersAPI, hasBackdropPath, hasLogoPath, hasPosterPath, hasProfilePath, hasStillPath, isJwt, isKnownForMovie, isKnownForTV };
+export { AccountAPI, AuthenticationAPI, BACKDROP_SIZES, CertificationsAPI, ChangesAPI, CollectionsAPI, CompaniesAPI, ConfigurationAPI, CreditsAPI, DiscoverAPI, DiscoverTVStatus, DiscoverTVType, FindAPI, GenresAPI, IMAGE_BASE_URL, IMAGE_SECURE_BASE_URL, KeywordsAPI, LOGO_SIZES, MovieListsAPI, MoviesAPI, NetworksAPI, POSTER_SIZES, PROFILE_SIZES, PeopleAPI, PeopleListsAPI, ReviewsAPI, STILL_SIZES, SearchAPI, TMDB, TMDBCountries, TMDBError, TMDBLogger, TVEpisodeGroupType, TVEpisodeGroupsAPI, TVEpisodesAPI, TVSeasonsAPI, TVSeriesAPI, TVSeriesListsAPI, TrendingAPI, WatchProvidersAPI, hasBackdropPath, hasLogoPath, hasPosterPath, hasProfilePath, hasStillPath, isJwt, isKnownForMovie, isKnownForTV, isPlainObject, isRecord };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lorenzopant/tmdb",
-	"version": "1.18.0",
+	"version": "1.18.1",
 	"description": "A completely type-safe The Movie Database (TMDB) API wrapper for typescript applications.",
 	"keywords": [
 		"api",
@@ -51,17 +51,15 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"devDependencies": {
-		"@types/node": "^22.19.11",
-		"@vitest/coverage-v8": "^4.0.9",
-		"@vitest/ui": "^4.0.10",
+		"@types/node": "^25.5.0",
+		"@vitest/coverage-v8": "^4.1.2",
+		"@vitest/ui": "^4.1.2",
 		"dotenv": "^16.5.0",
-		"release-it": "^19.0.3",
-		"release-it-pnpm": "^4.6.6",
 		"ts-morph": "^27.0.2",
 		"tsdown": "^0.21.7",
 		"tsx": "^4.21.0",
 		"typescript": "^5.8.3",
-		"vite": "^7.0.0",
-		"vitest": "^4.0.9"
+		"vite": "^8.0.3",
+		"vitest": "^4.1.2"
 	}
 }