@lorenzopant/tmdb 1.10.0 → 1.12.0

package/dist/types/tv-episodes/index.js

@@ -0,0 +1,3 @@
+export * from "./tv_episodes";
+export * from "./params";
+export * from "./credits";

package/dist/types/tv-episodes/params.d.ts

@@ -0,0 +1,30 @@
+import { WithLanguage, WithParams } from "../common";
+import { Language } from "../config";
+import { TVSeasonBaseParams } from "../tv-seasons/params";
+import { Prettify } from "../utility";
+import { TVEpisodeAppendToResponseNamespace } from "./tv_episodes";
+/**
+ * Almost every query within the TV Episodes domain
+ * will take this required param to identify the
+ * tv show episode.
+ */
+export type TVEpisodeBaseParams = TVSeasonBaseParams & {
+    /** Episode number */
+    episode_number: number;
+};
+/** Uniquely identifies an episode across different tv shows. */
+export type TVEpisodeId = {
+    episode_id: string | number;
+};
+/**
+ * Parameters for fetching TV episode details with optional additional data appended.
+ */
+export type TVEpisodeDetailsParams = Prettify<TVEpisodeBaseParams & {
+    append_to_response?: TVEpisodeAppendToResponseNamespace[];
+} & WithParams<"language">>;
+/** Parameters for tv episode credits endpoint */
+export type TVEpisodeCreditsParams = TVEpisodeBaseParams & WithLanguage;
+export type TVEpisodeImagesParams = TVEpisodeBaseParams & WithLanguage & {
+    include_image_language?: Language;
+};
+//# sourceMappingURL=params.d.ts.map

package/dist/types/tv-episodes/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/types/tv-episodes/params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kCAAkC,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IACtD,qBAAqB;IACrB,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC5C,mBAAmB,GAAG;IAAE,kBAAkB,CAAC,EAAE,kCAAkC,EAAE,CAAA;CAAE,GAAG,UAAU,CAAC,UAAU,CAAC,CAC5G,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAExE,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GACtD,YAAY,GAAG;IACd,sBAAsB,CAAC,EAAE,QAAQ,CAAC;CAClC,CAAC"}

package/dist/types/tv-episodes/params.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tv-episodes/translations.d.ts

@@ -0,0 +1,7 @@
+import { TranslationResults } from "../common";
+export type TVEpisodeTranslations = TranslationResults<TVEpisodeTranslation>;
+export type TVEpisodeTranslation = {
+    name?: string | null;
+    overview?: string | null;
+};
+//# sourceMappingURL=translations.d.ts.map

package/dist/types/tv-episodes/translations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/types/tv-episodes/translations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;AAG7E,MAAM,MAAM,oBAAoB,GAAG;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC"}

package/dist/types/tv-episodes/translations.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tv-episodes/tv_episodes.d.ts

@@ -0,0 +1,61 @@
+import { Cast, Crew } from "../common";
+import { TVEpisodeCredits } from "./credits";
+import { TVEpisodeExternalIDs } from "./external_ids";
+import { TVEpisodeImages } from "./images";
+import { TVEpisodeTranslations } from "./translations";
+import { TVEpisodeVideos } from "./videos";
+/**
+ * Represents a single episode of a TV series from the TMDB API.
+ * Contains detailed metadata including crew, guest stars, and voting stats.
+ */
+export type TVEpisode = {
+    /** ISO 8601 formatted date when the episode first aired (e.g. `"2023-05-15"`) */
+    air_date: string;
+    /** Array of crew members who worked on this specific episode */
+    crew: Crew[];
+    /** Sequential number of this episode within its season (1-based) */
+    episode_number: number;
+    /** Array of guest stars appearing in this episode (subset of cast without `cast_id`) */
+    guest_stars: Omit<Cast, "cast_id">[];
+    /** Episode title or name */
+    name: string;
+    /** Episode synopsis or description */
+    overview: string;
+    /** Unique TMDB identifier for this episode */
+    id: number;
+    /** Production code assigned by the production company, if available */
+    production_code?: string | null;
+    /** Runtime of the episode in minutes */
+    runtime: number;
+    /** Season number this episode belongs to (1-based) */
+    season_number: number;
+    /** Relative path to the episode still/image (e.g. `"/abc123.jpg"`), or null if none */
+    still_path?: string | null;
+    /** Average user rating of the episode (0-10 scale) */
+    vote_average: number;
+    /** Total number of user votes for the episode */
+    vote_count: number;
+};
+/**
+ * Available append-to-response options for TV episode details.
+ * These allow fetching additional related data in a single API request.
+ */
+export type TVEpisodeAppendToResponseNamespace = "credits" | "external_ids" | "images" | "translations" | "videos";
+/**
+ * Maps append-to-response keys to their corresponding response types.
+ */
+export type TVEpisodeAppendableMap = {
+    credits: TVEpisodeCredits;
+    external_ids: TVEpisodeExternalIDs;
+    images: TVEpisodeImages;
+    translations: TVEpisodeTranslations;
+    videos: TVEpisodeVideos;
+};
+/**
+ * TV show details with additional appended data based on the requested namespaces.
+ * @template T - Array of append-to-response namespace keys to include
+ */
+export type TVEpisodeDetailsWithAppends<T extends readonly TVEpisodeAppendToResponseNamespace[]> = TVEpisode & {
+    [K in T[number]]: TVEpisodeAppendableMap[K];
+};
+//# sourceMappingURL=tv_episodes.d.ts.map

package/dist/types/tv-episodes/tv_episodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tv_episodes.d.ts","sourceRoot":"","sources":["../../../src/types/tv-episodes/tv_episodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACvB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACrC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEnH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,YAAY,EAAE,oBAAoB,CAAC;IACnC,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,qBAAqB,CAAC;IACpC,MAAM,EAAE,eAAe,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,SAAS,kCAAkC,EAAE,IAAI,SAAS,GAAG;KAC7G,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC;CAC3C,CAAC"}

package/dist/types/tv-episodes/tv_episodes.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tv-episodes/videos.d.ts

@@ -0,0 +1,3 @@
+import { MovieVideos } from "../movies";
+export type TVEpisodeVideos = MovieVideos;
+//# sourceMappingURL=videos.d.ts.map

package/dist/types/tv-episodes/videos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videos.d.ts","sourceRoot":"","sources":["../../../src/types/tv-episodes/videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC"}

package/dist/types/tv-episodes/videos.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tv-seasons/params.d.ts

@@ -0,0 +1,15 @@
+import { TVBaseParam } from "../tv/params";
+/**
+ * Almost every query within the TV Series Seasons domain
+ * will take this required param to identify the
+ * tv show season.
+ */
+export type TVSeasonBaseParams = TVBaseParam & {
+    /** The Season */
+    season_number: number;
+};
+/** Uniquely identifies a season across different tv shows. */
+export type TVSeasonId = {
+    season_id: string;
+};
+//# sourceMappingURL=params.d.ts.map

package/dist/types/tv-seasons/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/types/tv-seasons/params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAC9C,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/types/tv-seasons/params.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tv-seasons/tv-season.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=tv-season.d.ts.map

package/dist/types/tv-seasons/tv-season.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tv-season.d.ts","sourceRoot":"","sources":["../../../src/types/tv-seasons/tv-season.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lorenzopant/tmdb",
-	"version": "1.10.0",
+	"version": "1.12.0",
 	"description": "A completely type-safe The Movie Database (TMDB) API wrapper for typescript applications.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/dist/types/networks/alternative_names.d.ts

@@ -1 +0,0 @@
-//# sourceMappingURL=alternative_names.d.ts.map

package/dist/types/networks/alternative_names.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alternative_names.d.ts","sourceRoot":"","sources":["../../../src/types/networks/alternative_names.ts"],"names":[],"mappings":""}

package/dist/types/networks/images.d.ts

@@ -1 +0,0 @@
-//# sourceMappingURL=images.d.ts.map

package/dist/types/networks/images.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../src/types/networks/images.ts"],"names":[],"mappings":""}

package/dist/types/networks/images.js

@@ -1 +0,0 @@
-"use strict";

package/dist/types/networks/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./network";
-//# sourceMappingURL=index.d.ts.map

package/dist/types/networks/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/networks/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/types/networks/index.js

@@ -1 +0,0 @@
-export * from "./network";

package/dist/types/networks/network.d.ts

@@ -1,8 +0,0 @@
-import { CountryISO3166_1 } from "../config/countries";
-export type NetworkItem = {
-    id: number;
-    logo_path: string;
-    name: string;
-    origin_country: CountryISO3166_1;
-};
-//# sourceMappingURL=network.d.ts.map

package/dist/types/networks/network.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/types/networks/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,gBAAgB,CAAC;CACjC,CAAC"}