@tdanks2000/tmdb-wrapper 1.1.2 → 1.3.1

package/dist/endpoints/tvSeasons.js

@@ -1,109 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TvSeasonsEndpoint = void 0;
-const _types_1 = require("../@types");
-const BASE_SEASON = (seasonSelection) => {
-    return `/tv/${seasonSelection.tvShowID}/season/${seasonSelection.seasonNumber}`;
-};
-/**
- * Represents an endpoint for accessing TV season-related information.
- */
-class TvSeasonsEndpoint extends _types_1.BaseEndpoint {
-    /**
-     * Constructs a new TvSeasonsEndpoint instance.
-     * @param {string} access_token - The access token used for authentication.
-     */
-    constructor(access_token) {
-        super(access_token);
-        this.access_token = access_token;
-    }
-    /**
-     * Retrieves details of a specific TV season asynchronously.
-     * @param {SeasonSelection} seasonSelection - The selection criteria for the TV season.
-     * @param {AppendToResponseTvSeasonKey[]} [appendToResponse] - Additional data to append to the response.
-     * @param {LanguageOption} [options] - Optional parameters for specifying the language.
-     * @returns {Promise<AppendToResponse<SeasonDetails, AppendToResponseTvSeasonKey[], 'tvSeason'>>}
-     * A Promise that resolves with the details of the TV season.
-     */
-    async details(seasonSelection, appendToResponse, options) {
-        const combinedOptions = {
-            append_to_response: appendToResponse
-                ? appendToResponse.join(",")
-                : undefined,
-            ...options,
-        };
-        return await this.api.get(`${BASE_SEASON(seasonSelection)}`, combinedOptions);
-    }
-    /**
-     * Retrieves aggregate credits for a specific TV season asynchronously.
-     * @param {SeasonSelection} seasonSelection - The selection criteria for the TV season.
-     * @param {LanguageOption} [options] - Optional parameters for specifying the language.
-     * @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);
-    }
-    /**
-     * Retrieves changes related to a specific TV season asynchronously.
-     * @param {number} seasonId - The ID of the TV season.
-     * @param {ChangeOption} [options] - Optional parameters for specifying changes.
-     * @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);
-    }
-    /**
-     * Retrieves credits for a specific TV season asynchronously.
-     * @param {SeasonSelection} seasonSelection - The selection criteria for the TV season.
-     * @param {LanguageOption} [options] - Optional parameters for specifying the language.
-     * @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);
-    }
-    /**
-     * Retrieves external IDs for a specific TV season asynchronously.
-     * @param {SeasonSelection} seasonSelection - The selection criteria for the TV season.
-     * @param {LanguageOption} [options] - Optional parameters for specifying the language.
-     * @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);
-    }
-    /**
-     * Retrieves images for a specific TV season asynchronously.
-     * @param {SeasonSelection} seasonSelection - The selection criteria for the TV season.
-     * @param {TvSeasonImageSearchOptions} [options] - Optional parameters for specifying image search options.
-     * @returns {Promise<Images>} A Promise that resolves with the images for the TV season.
-     */
-    async images(seasonSelection, options) {
-        const computedOptions = {
-            include_image_language: options?.include_image_language?.join(","),
-            language: options?.language,
-        };
-        return await this.api.get(`${BASE_SEASON(seasonSelection)}/images`, computedOptions);
-    }
-    /**
-     * Retrieves videos for a specific TV season asynchronously.
-     * @param {SeasonSelection} seasonSelection - The selection criteria for the TV season.
-     * @param {TvSeasonVideoSearchOptions} [options] - Optional parameters for specifying video search options.
-     * @returns {Promise<Videos>} A Promise that resolves with the videos for the TV season.
-     */
-    async videos(seasonSelection, options) {
-        const computedOptions = {
-            include_video_language: options?.include_video_language?.join(","),
-            language: options?.language,
-        };
-        return await this.api.get(`${BASE_SEASON(seasonSelection)}/videos`, computedOptions);
-    }
-    /**
-     * Retrieves translations for a specific TV season asynchronously.
-     * @param {SeasonSelection} seasonSelection - The selection criteria for the TV season.
-     * @param {LanguageOption} [options] - Optional parameters for specifying the language.
-     * @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);
-    }
-}
-exports.TvSeasonsEndpoint = TvSeasonsEndpoint;

package/dist/endpoints/tvShows.js

@@ -1,230 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TvShowsEndpoint = void 0;
-const _types_1 = require("../@types");
-const BASE_TV = "/tv";
-/**
- * Represents an endpoint for accessing TV show-related information.
- */
-class TvShowsEndpoint extends _types_1.BaseEndpoint {
-    /**
-     * Constructs a new TvShowsEndpoint instance.
-     * @param {string} access_token - The access token used for authentication.
-     */
-    constructor(access_token) {
-        super(access_token);
-        this.access_token = access_token;
-    }
-    /**
-     * Retrieves details of a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {AppendToResponseTvKey[]} [appendToResponse] - Additional data to append to the response.
-     * @param {string} [language] - The language for the response.
-     * @returns {Promise<AppendToResponse<TvShowDetails, AppendToResponseTvKey[], 'tvShow'>>}
-     * A Promise that resolves with the details of the TV show.
-     */
-    async details(id, appendToResponse, language) {
-        const options = {
-            append_to_response: appendToResponse
-                ? appendToResponse.join(",")
-                : undefined,
-            language: language,
-        };
-        return await this.api.get(`${BASE_TV}/${id}`, options);
-    }
-    /**
-     * Retrieves alternative titles of a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @returns {Promise<AlternativeTitles>} A Promise that resolves with the alternative titles of the TV show.
-     */
-    async alternativeTitles(id) {
-        return await this.api.get(`${BASE_TV}/${id}/alternative_titles`);
-    }
-    /**
-     * Retrieves changes for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {ChangeOption} [options] - Additional options for the request.
-     * @returns {Promise<Changes<TvShowChangeValue>>}
-     * 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);
-    }
-    /**
-     * Retrieves content ratings for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @returns {Promise<ContentRatings>} A Promise that resolves with the content ratings of the TV show.
-     */
-    async contentRatings(id) {
-        return await this.api.get(`${BASE_TV}/${id}/content_ratings`);
-    }
-    /**
-     * Retrieves aggregate credits for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {LanguageOption} [options] - Additional options for the request.
-     * @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);
-    }
-    /**
-     * Retrieves credits for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {LanguageOption} [options] - Additional options for the request.
-     * @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);
-    }
-    /**
-     * Retrieves details of a specific season of a TV show asynchronously.
-     * @param {number} tvId - The ID of the TV show.
-     * @param {number} seasonNumber - The season number.
-     * @returns {Promise<SeasonDetails>} A Promise that resolves with the details of the season.
-     */
-    async season(tvId, seasonNumber) {
-        return await this.api.get(`${BASE_TV}/${tvId}/season/${seasonNumber}`);
-    }
-    /**
-     * Retrieves episode groups for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @returns {Promise<EpisodeGroups>} A Promise that resolves with the episode groups of the TV show.
-     */
-    async episodeGroups(id) {
-        return await this.api.get(`${BASE_TV}/${id}/episode_groups`);
-    }
-    /**
-     * Retrieves external IDs for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @returns {Promise<ExternalIds>} A Promise that resolves with the external IDs of the TV show.
-     */
-    async externalIds(id) {
-        return await this.api.get(`${BASE_TV}/${id}/external_ids`);
-    }
-    /**
-     * Retrieves images for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {TvShowImageOptions} [options] - Additional options for the request.
-     * @returns {Promise<Images>} A Promise that resolves with the images of the TV show.
-     */
-    async images(id, options) {
-        const computedOptions = {
-            include_image_language: options?.include_image_language?.join(","),
-            language: options?.language,
-        };
-        return await this.api.get(`${BASE_TV}/${id}/images`, computedOptions);
-    }
-    /**
-     * Retrieves keywords for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @returns {Promise<Keywords>} A Promise that resolves with the keywords of the TV show.
-     */
-    async keywords(id) {
-        return await this.api.get(`${BASE_TV}/${id}/keywords`);
-    }
-    /**
-     * Retrieves recommendations for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {LanguageOption & PageOption} [options] - Additional options for the request.
-     * @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);
-    }
-    /**
-     * Retrieves reviews for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {LanguageOption & PageOption} [options] - Additional options for the request.
-     * @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);
-    }
-    /**
-     * Retrieves information about whether the TV show was screened theatrically asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @returns {Promise<ScreenedTheatrically>} A Promise that resolves with information about theatrical screenings.
-     */
-    async screenedTheatrically(id) {
-        return await this.api.get(`${BASE_TV}/${id}/screened_theatrically`);
-    }
-    /**
-     * Retrieves similar TV shows for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {LanguageOption & PageOption} [options] - Additional options for the request.
-     * @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);
-    }
-    /**
-     * Retrieves translations for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @returns {Promise<Translations>} A Promise that resolves with the translations of the TV show.
-     */
-    async translations(id) {
-        return await this.api.get(`${BASE_TV}/${id}/translations`);
-    }
-    /**
-     * Retrieves videos for a specific TV show asynchronously.
-     * @param {number} id - The ID of the TV show.
-     * @param {TvShowVideoOptions} [options] - Additional options for the request.
-     * @returns {Promise<Videos>} A Promise that resolves with the videos of the TV show.
-     */
-    async videos(id, options) {
-        const computedOptions = {
-            include_video_language: options?.include_video_language?.join(","),
-            language: options?.language,
-        };
-        return await this.api.get(`${BASE_TV}/${id}/videos`, computedOptions);
-    }
-    /**
-     * Retrieves watch providers for a specific TV show asynchronously.
-     * Powered by JustWatch.
-     * @param {number} id - The ID of the TV show.
-     * @returns {Promise<WatchProviders>} A Promise that resolves with the watch providers of the TV show.
-     */
-    async watchProviders(id) {
-        return await this.api.get(`${BASE_TV}/${id}/watch/providers`);
-    }
-    /**
-     * Retrieves the latest TV show asynchronously.
-     * @returns {Promise<Latesttv>} A Promise that resolves with the latest TV show.
-     */
-    async latest() {
-        return await this.api.get(`${BASE_TV}/latest`);
-    }
-    /**
-     * Retrieves TV shows that are currently on the air asynchronously.
-     * @param {PageOption & LanguageOption & TimezoneOption} [options] - Additional options for the request.
-     * @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);
-    }
-    /**
-     * Retrieves TV shows that are airing today asynchronously.
-     * @param {PageOption & LanguageOption & TimezoneOption} [options] - Additional options for the request.
-     * @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);
-    }
-    /**
-     * Retrieves popular TV shows asynchronously.
-     * @param {PageOption & LanguageOption} [options] - Additional options for the request.
-     * @returns {Promise<Populartv>} A Promise that resolves with popular TV shows.
-     */
-    async popular(options) {
-        return await this.api.get(`${BASE_TV}/popular`, options);
-    }
-    /**
-     * Retrieves top-rated TV shows asynchronously.
-     * @param {PageOption & LanguageOption} [options] - Additional options for the request.
-     * @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);
-    }
-}
-exports.TvShowsEndpoint = TvShowsEndpoint;

package/dist/endpoints/watchProviders.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WatchProvidersEndpoint = void 0;
-const _types_1 = require("../@types");
-/**
- * Represents an endpoint for accessing watch provider information.
- */
-class WatchProvidersEndpoint extends _types_1.BaseEndpoint {
-    /**
-     * Constructs a new WatchProvidersEndpoint instance.
-     * @param {string} access_token - The access token used for authentication.
-     */
-    constructor(access_token) {
-        super(access_token);
-        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.
-     */
-    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.
-     */
-    async tv() {
-        return await this.api.get("/watch/providers/tv");
-    }
-}
-exports.WatchProvidersEndpoint = WatchProvidersEndpoint;

package/dist/index.js

@@ -1,46 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TMDB = void 0;
-const endpoints_1 = require("./endpoints");
-class TMDB {
-    constructor(auth) {
-        this.account = new endpoints_1.AccountEndpoint(auth);
-        this.certification = new endpoints_1.CertificationEndpoint(auth);
-        this.changes = new endpoints_1.ChangeEndpoint(auth);
-        this.collections = new endpoints_1.CollectionsEndpoint(auth);
-        this.companies = new endpoints_1.CompaniesEndpoint(auth);
-        this.configuration = new endpoints_1.ConfigurationEndpoint(auth);
-        this.credits = new endpoints_1.CreditsEndpoint(auth);
-        this.discover = new endpoints_1.DiscoverEndpoint(auth);
-        this.find = new endpoints_1.FindEndpoint(auth);
-        this.genre = new endpoints_1.GenreEndpoint(auth);
-        this.keywords = new endpoints_1.KeywordsEndpoint(auth);
-        this.movies = new endpoints_1.MoviesEndpoint(auth);
-        this.networks = new endpoints_1.NetworksEndpoint(auth);
-        this.people = new endpoints_1.PeopleEndpoint(auth);
-        this.review = new endpoints_1.ReviewEndpoint(auth);
-        this.search = new endpoints_1.SearchEndpoint(auth);
-        this.trending = new endpoints_1.TrendingEndpoint(auth);
-        this.tvEpisodes = new endpoints_1.TvEpisodesEndpoint(auth);
-        this.tvSeasons = new endpoints_1.TvSeasonsEndpoint(auth);
-        this.tvShows = new endpoints_1.TvShowsEndpoint(auth);
-        this.watchProviders = new endpoints_1.WatchProvidersEndpoint(auth);
-    }
-}
-exports.TMDB = TMDB;
-__exportStar(require("./@types"), exports);
-__exportStar(require("./utils"), exports);

package/dist/utils/api.js

@@ -1,61 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseOptions = exports.API = void 0;
-const BASE_URL_V3 = "https://api.themoviedb.org/3";
-class API {
-    constructor(auth) {
-        if (typeof auth === "string") {
-            this.accessToken = auth;
-        }
-        else {
-            this.apiKey = auth.apiKey;
-            this.accessToken = auth.accessToken;
-        }
-    }
-    /**
-     * Generic GET:
-     * @template T — response type
-     * @template O — options (query params) type
-     */
-    async get(path, options) {
-        const rawOptions = {
-            ...(options ?? {}),
-            ...(this.apiKey ? { api_key: this.apiKey } : {}),
-        };
-        const params = (0, exports.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",
-            },
-        });
-        if (!response.ok) {
-            const error = (await response.json());
-            return Promise.reject(error);
-        }
-        return (await response.json());
-    }
-}
-exports.API = API;
-const parseOptions = (options) => {
-    if (!options)
-        return "";
-    const entries = [];
-    for (const [key, value] of Object.entries(options)) {
-        if (value === undefined || 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();
-};
-exports.parseOptions = parseOptions;

package/dist/utils/getimagePath.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ImageFormats = exports.ImageSizes = exports.getFullImagePath = void 0;
-/**
- * Utility method to construct full url for image
- * based on configuration
- *
- * https://developers.themoviedb.org/3/getting-started/images
- * @param {string} baseUrl base image url (e.g., 'https://image.tmdb.org/t/p/')
- * @param {string} fileSize file size (e.g., 'original', 'w500')
- * @param {string} imagePath raw image path
- * @param {string} format override image format (e.g., 'svg', 'png', 'jpg')
- * @returns {string} The complete image URL
- */
-const getFullImagePath = (baseUrl, fileSize, imagePath, format) => {
-    if (!imagePath)
-        return "";
-    // Handle case where imagePath doesn't have an extension
-    const hasExtension = imagePath.includes(".");
-    if (hasExtension) {
-        const imagePathArr = imagePath.split(".");
-        const imageFormat = format || imagePathArr[1];
-        return `${baseUrl}${fileSize}${imagePathArr[0]}.${imageFormat}`;
-    }
-    else {
-        // If no extension in path, use provided format or default to jpg
-        const imageFormat = format || "jpg";
-        return `${baseUrl}${fileSize}${imagePath}.${imageFormat}`;
-    }
-};
-exports.getFullImagePath = getFullImagePath;
-/**
- * Common image sizes available in TMDB
- */
-exports.ImageSizes = {
-    ORIGINAL: "original",
-    W500: "w500",
-    W300: "w300",
-    W185: "w185",
-    W92: "w92",
-    H632: "h632",
-};
-/**
- * Image formats supported by TMDB
- */
-exports.ImageFormats = {
-    JPG: "jpg",
-    PNG: "png",
-    SVG: "svg",
-};

package/dist/utils/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./api"), exports);
-__exportStar(require("./getimagePath"), exports);