@lorenzopant/tmdb 1.12.0 → 1.13.0

package/dist/endpoints/tv_episode_groups.d.ts

@@ -0,0 +1,14 @@
+import { TVEpisodeGroupDetails, TVEpisodeGroupParams } from "../types/other/tv_episode_groups";
+import { TMDBAPIBase } from "./base";
+export declare class TVEpisodeGroupsAPI extends TMDBAPIBase {
+    /**
+     * Details
+     * GET - https://api.themoviedb.org/3/tv/episode_group/{episode_group_id}
+     *
+     * Get the details of a TV episode group by ID.
+     * @param episode_group_id The ID of the episode group.
+     * @reference https://developer.themoviedb.org/reference/tv-episode-group-details
+     */
+    details(params: TVEpisodeGroupParams): Promise<TVEpisodeGroupDetails>;
+}
+//# sourceMappingURL=tv_episode_groups.d.ts.map

package/dist/endpoints/tv_episode_groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tv_episode_groups.d.ts","sourceRoot":"","sources":["../../src/endpoints/tv_episode_groups.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,kBAAmB,SAAQ,WAAW;IAClD;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAI3E"}

package/dist/endpoints/tv_episode_groups.js

@@ -0,0 +1,16 @@
+import { ENDPOINTS } from "../routes";
+import { TMDBAPIBase } from "./base";
+export class TVEpisodeGroupsAPI extends TMDBAPIBase {
+    /**
+     * Details
+     * GET - https://api.themoviedb.org/3/tv/episode_group/{episode_group_id}
+     *
+     * Get the details of a TV episode group by ID.
+     * @param episode_group_id The ID of the episode group.
+     * @reference https://developer.themoviedb.org/reference/tv-episode-group-details
+     */
+    async details(params) {
+        const endpoint = `${ENDPOINTS.TV_EPISODE_GROUPS.DETAILS}/${params.episode_group_id}`;
+        return this.client.request(endpoint);
+    }
+}

package/dist/routes.d.ts

@@ -114,6 +114,9 @@ export declare const ENDPOINTS: {
         TRANSLATIONS: string;
         VIDEOS: string;
     };
+    TV_EPISODE_GROUPS: {
+        DETAILS: string;
+    };
     WATCH_PROVIDERS: {
         MOVIE: string;
         TV: string;

package/dist/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHrB,CAAC"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4HrB,CAAC"}

package/dist/routes.js

@@ -114,6 +114,9 @@ export const ENDPOINTS = {
         TRANSLATIONS: "/translations",
         VIDEOS: "/videos",
     },
+    TV_EPISODE_GROUPS: {
+        DETAILS: "/tv/episode_group",
+    },
     WATCH_PROVIDERS: {
         MOVIE: "/watch/providers/movie",
         TV: "/watch/providers/tv",

package/dist/tmdb.d.ts

@@ -18,6 +18,7 @@ import { ImageAPI } from "./images/images";
 import { TMDBOptions } from "./types/config";
 import { NetworksAPI } from "./endpoints/networks";
 import { TVEpisodesAPI } from "./endpoints/tv_episodes";
+import { TVEpisodeGroupsAPI } from "./endpoints/tv_episode_groups";
 export declare class TMDB {
     private client;
     private options;
@@ -40,6 +41,7 @@ export declare class TMDB {
     find: FindAPI;
     networks: NetworksAPI;
     tv_episodes: TVEpisodesAPI;
+    tv_episode_groups: TVEpisodeGroupsAPI;
     /**
      * Creates a new TMDB instance.
      * @param accessToken The TMDB API access token.

package/dist/tmdb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tmdb.d.ts","sourceRoot":"","sources":["../src/tmdb.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,qBAAa,IAAI;IAChB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAc;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,aAAa,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC;IACjB,aAAa,EAAE,gBAAgB,CAAC;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,EAAE,iBAAiB,CAAC;IACnC,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,aAAa,CAAC;IAGlC;;;;OAIG;gBACS,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB;CAwB1D"}
+{"version":3,"file":"tmdb.d.ts","sourceRoot":"","sources":["../src/tmdb.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,qBAAa,IAAI;IAChB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAc;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,aAAa,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC;IACjB,aAAa,EAAE,gBAAgB,CAAC;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,EAAE,iBAAiB,CAAC;IACnC,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,aAAa,CAAC;IAC3B,iBAAiB,EAAE,kBAAkB,CAAC;IAG7C;;;;OAIG;gBACS,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB;CAyB1D"}

package/dist/tmdb.js

@@ -20,6 +20,7 @@ import { Errors } from "./errors/messages";
 import { ImageAPI } from "./images/images";
 import { NetworksAPI } from "./endpoints/networks";
 import { TVEpisodesAPI } from "./endpoints/tv_episodes";
+import { TVEpisodeGroupsAPI } from "./endpoints/tv_episode_groups";
 export class TMDB {
     client;
     options; // ** Default options for all requests
@@ -42,6 +43,7 @@ export class TMDB {
     find;
     networks;
     tv_episodes;
+    tv_episode_groups;
     // etc...
     /**
      * Creates a new TMDB instance.
@@ -72,5 +74,6 @@ export class TMDB {
         this.find = new FindAPI(this.client, this.options);
         this.networks = new NetworksAPI(this.client, this.options);
         this.tv_episodes = new TVEpisodesAPI(this.client, this.options);
+        this.tv_episode_groups = new TVEpisodeGroupsAPI(this.client, this.options);
     }
 }

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

@@ -5,4 +5,5 @@ export * from "./find";
 export * from "./watch_providers";
 export * from "./keywords";
 export * from "./networks";
+export * from "./tv_episode_groups";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/other/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/other/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/types/other/index.js

@@ -5,3 +5,4 @@ export * from "./find";
 export * from "./watch_providers";
 export * from "./keywords";
 export * from "./networks";
+export * from "./tv_episode_groups";

package/dist/types/other/tv_episode_groups.d.ts

@@ -0,0 +1,64 @@
+import { NetworkItem } from "./networks";
+import { TVEpisode } from "../tv-episodes/tv_episodes";
+/**
+ * Full details for a TV episode group, including grouped episode lists.
+ */
+export type TVEpisodeGroupDetails = {
+    /** Description of the episode group */
+    description: string;
+    /** Total number of episodes across all groups */
+    episode_count: number;
+    /** Number of group entries in this episode group */
+    group_count: number;
+    /** Unique episode group identifier */
+    id: string;
+    /** Name of the episode group */
+    name: string;
+    /** Network associated with the episode group, if available */
+    network: NetworkItem | null;
+    /** Grouping strategy type (e.g., numbered by season, collections, etc.) */
+    type: TVEpisodeGroupType;
+    /** Grouped episode entries */
+    groups: TVEpisodeGroupDetailsItem[];
+};
+/**
+ * A group within an episode group (e.g., a season-like grouping).
+ */
+export type TVEpisodeGroupDetailsItem = {
+    /** Unique group identifier */
+    id: string;
+    /** Group name */
+    name: string;
+    /** Display order */
+    order: number;
+    /** Whether the group is locked on TMDB */
+    locked: boolean;
+    /** Episodes included in this group */
+    episodes: TVEpisodeGroupEpisode[];
+};
+/**
+ * A simplified TV episode item returned in episode group details.
+ */
+export type TVEpisodeGroupEpisode = Omit<TVEpisode, "guest_stars" | "runtime"> & {
+    /** Production code for the episode, if available */
+    production_code?: string | null;
+    /** Path to the episode still image, if available */
+    still_path?: string | null;
+};
+/**
+ * Supported episode group type identifiers.
+ */
+export declare enum TVEpisodeGroupType {
+    OriginalAirDate = 1,
+    Absolute = 2,
+    Dvd = 3,
+    Digital = 4,
+    StoryArc = 5,
+    Production = 6,
+    TV = 7
+}
+export type TVEpisodeGroupParams = {
+    /** Episode group identifier */
+    episode_group_id: string;
+};
+//# sourceMappingURL=tv_episode_groups.d.ts.map

package/dist/types/other/tv_episode_groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tv_episode_groups.d.ts","sourceRoot":"","sources":["../../../src/types/other/tv_episode_groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IACnC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,2EAA2E;IAC3E,IAAI,EAAE,kBAAkB,CAAC;IACzB,8BAA8B;IAC9B,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACvC,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC,GAAG;IAChF,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,oBAAY,kBAAkB;IAC7B,eAAe,IAAI;IACnB,QAAQ,IAAI;IACZ,GAAG,IAAI;IACP,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,UAAU,IAAI;IACd,EAAE,IAAI;CACN;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAC;CACzB,CAAC"}

package/dist/types/other/tv_episode_groups.js

@@ -0,0 +1,13 @@
+/**
+ * Supported episode group type identifiers.
+ */
+export var TVEpisodeGroupType;
+(function (TVEpisodeGroupType) {
+    TVEpisodeGroupType[TVEpisodeGroupType["OriginalAirDate"] = 1] = "OriginalAirDate";
+    TVEpisodeGroupType[TVEpisodeGroupType["Absolute"] = 2] = "Absolute";
+    TVEpisodeGroupType[TVEpisodeGroupType["Dvd"] = 3] = "Dvd";
+    TVEpisodeGroupType[TVEpisodeGroupType["Digital"] = 4] = "Digital";
+    TVEpisodeGroupType[TVEpisodeGroupType["StoryArc"] = 5] = "StoryArc";
+    TVEpisodeGroupType[TVEpisodeGroupType["Production"] = 6] = "Production";
+    TVEpisodeGroupType[TVEpisodeGroupType["TV"] = 7] = "TV";
+})(TVEpisodeGroupType || (TVEpisodeGroupType = {}));

package/package.json

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