tmdb-kit 1.1.0 → 1.2.0

package/dist/resources/tv.d.cts

@@ -1,5 +1,5 @@
 import type { TMDBTransport } from '../http.cjs';
-import type { CreditsResponse, ImageQueryOptions, ImagesResponse, LanguageOptions, ListOptions, PagedResponse, TMDBObject, TVDetails, TVDetailsOptions, TVSeasonDetails, TVSeasonDetailsOptions, TVSummary, VideosResponse } from '../types.cjs';
+import type { AggregateCreditsResponse, CreditsResponse, EpisodeDetails, EpisodeDetailsOptions, EpisodeGroupDetails, EpisodeGroupsResponse, ImageQueryOptions, ImagesResponse, LanguageOptions, ListOptions, PagedResponse, SeasonImagesResponse, TMDBObject, TVDetails, TVDetailsOptions, TVSeasonDetails, TVSeasonDetailsOptions, TVSummary, VideosResponse } from '../types.cjs';
 /**
  * Access TMDB TV show endpoints (popular, top-rated, details, seasons, etc.).
  *
@@ -19,4 +19,12 @@ export declare class TVResource {
     similar(seriesId: number, options?: Omit<ListOptions, 'region'>): Promise<PagedResponse<TVSummary>>;
     videos(seriesId: number, options?: LanguageOptions): Promise<VideosResponse>;
     seasonDetails<TAppend extends TMDBObject = TMDBObject>(seriesId: number, seasonNumber: number, options?: TVSeasonDetailsOptions): Promise<TVSeasonDetails & TAppend>;
+    seasonCredits(seriesId: number, seasonNumber: number, options?: LanguageOptions): Promise<CreditsResponse>;
+    seasonAggregateCredits(seriesId: number, seasonNumber: number, options?: LanguageOptions): Promise<AggregateCreditsResponse>;
+    seasonImages(seriesId: number, seasonNumber: number, options?: ImageQueryOptions): Promise<SeasonImagesResponse>;
+    seasonVideos(seriesId: number, seasonNumber: number, options?: LanguageOptions): Promise<VideosResponse>;
+    episodeDetails<TAppend extends TMDBObject = TMDBObject>(seriesId: number, seasonNumber: number, episodeNumber: number, options?: EpisodeDetailsOptions): Promise<EpisodeDetails & TAppend>;
+    aggregateCredits(seriesId: number, options?: LanguageOptions): Promise<AggregateCreditsResponse>;
+    episodeGroups(seriesId: number, options?: LanguageOptions): Promise<EpisodeGroupsResponse>;
+    episodeGroup(groupId: string, options?: LanguageOptions): Promise<EpisodeGroupDetails>;
 }

package/dist/resources/tv.d.ts

@@ -1,5 +1,5 @@
 import type { TMDBTransport } from '../http.js';
-import type { CreditsResponse, ImageQueryOptions, ImagesResponse, LanguageOptions, ListOptions, PagedResponse, TMDBObject, TVDetails, TVDetailsOptions, TVSeasonDetails, TVSeasonDetailsOptions, TVSummary, VideosResponse } from '../types.js';
+import type { AggregateCreditsResponse, CreditsResponse, EpisodeDetails, EpisodeDetailsOptions, EpisodeGroupDetails, EpisodeGroupsResponse, ImageQueryOptions, ImagesResponse, LanguageOptions, ListOptions, PagedResponse, SeasonImagesResponse, TMDBObject, TVDetails, TVDetailsOptions, TVSeasonDetails, TVSeasonDetailsOptions, TVSummary, VideosResponse } from '../types.js';
 /**
  * Access TMDB TV show endpoints (popular, top-rated, details, seasons, etc.).
  *
@@ -19,4 +19,12 @@ export declare class TVResource {
     similar(seriesId: number, options?: Omit<ListOptions, 'region'>): Promise<PagedResponse<TVSummary>>;
     videos(seriesId: number, options?: LanguageOptions): Promise<VideosResponse>;
     seasonDetails<TAppend extends TMDBObject = TMDBObject>(seriesId: number, seasonNumber: number, options?: TVSeasonDetailsOptions): Promise<TVSeasonDetails & TAppend>;
+    seasonCredits(seriesId: number, seasonNumber: number, options?: LanguageOptions): Promise<CreditsResponse>;
+    seasonAggregateCredits(seriesId: number, seasonNumber: number, options?: LanguageOptions): Promise<AggregateCreditsResponse>;
+    seasonImages(seriesId: number, seasonNumber: number, options?: ImageQueryOptions): Promise<SeasonImagesResponse>;
+    seasonVideos(seriesId: number, seasonNumber: number, options?: LanguageOptions): Promise<VideosResponse>;
+    episodeDetails<TAppend extends TMDBObject = TMDBObject>(seriesId: number, seasonNumber: number, episodeNumber: number, options?: EpisodeDetailsOptions): Promise<EpisodeDetails & TAppend>;
+    aggregateCredits(seriesId: number, options?: LanguageOptions): Promise<AggregateCreditsResponse>;
+    episodeGroups(seriesId: number, options?: LanguageOptions): Promise<EpisodeGroupsResponse>;
+    episodeGroup(groupId: string, options?: LanguageOptions): Promise<EpisodeGroupDetails>;
 }

package/dist/types.d.cts

@@ -162,6 +162,95 @@ export type TVSeasonAppendToResponse = 'account_states' | 'aggregate_credits' |
 export interface TVSeasonDetailsOptions extends LanguageOptions {
     appendToResponse?: TVSeasonAppendToResponse | readonly TVSeasonAppendToResponse[];
 }
+/**
+ * Episode details endpoint payload. Unlike {@link EpisodeSummary}, the
+ * single-episode endpoint does not return `show_id`.
+ */
+export type EpisodeDetails = Omit<EpisodeSummary, 'show_id'>;
+export type EpisodeAppendToResponse = 'account_states' | 'credits' | 'external_ids' | 'images' | 'translations' | 'videos' | (string & {});
+export interface EpisodeDetailsOptions extends LanguageOptions {
+    appendToResponse?: EpisodeAppendToResponse | readonly EpisodeAppendToResponse[];
+}
+export interface AggregateRole {
+    credit_id: string;
+    character: string;
+    episode_count: number;
+}
+export interface AggregateJob {
+    credit_id: string;
+    job: string;
+    episode_count: number;
+}
+export interface AggregateCastMember {
+    adult?: boolean;
+    gender: number | null;
+    id: number;
+    known_for_department: string;
+    name: string;
+    order: number;
+    original_name: string;
+    popularity: number;
+    profile_path: string | null;
+    roles: AggregateRole[];
+    total_episode_count: number;
+}
+export interface AggregateCrewMember {
+    adult?: boolean;
+    department: string;
+    gender: number | null;
+    id: number;
+    jobs: AggregateJob[];
+    known_for_department: string;
+    name: string;
+    original_name: string;
+    popularity: number;
+    profile_path: string | null;
+    total_episode_count: number;
+}
+export interface AggregateCreditsResponse {
+    id: number;
+    cast: AggregateCastMember[];
+    crew: AggregateCrewMember[];
+}
+export interface EpisodeGroupSummary {
+    description: string;
+    episode_count: number;
+    group_count: number;
+    id: string;
+    name: string;
+    network: Network | null;
+    type: number;
+}
+export interface EpisodeGroupsResponse {
+    id: number;
+    results: EpisodeGroupSummary[];
+}
+export interface EpisodeGroupEpisode {
+    air_date: TMDBDateString | null;
+    episode_number: number;
+    episode_type: string;
+    id: number;
+    name: string;
+    order: number;
+    overview: string;
+    production_code: string | null;
+    runtime: number | null;
+    season_number: number;
+    show_id: number;
+    still_path: string | null;
+    vote_average: number;
+    vote_count: number;
+}
+export interface EpisodeGroup {
+    id: string;
+    name: string;
+    order: number;
+    locked: boolean;
+    episodes: EpisodeGroupEpisode[];
+}
+export interface EpisodeGroupDetails extends EpisodeGroupSummary {
+    groups: EpisodeGroup[];
+}
 export interface TVDetails extends Omit<TVSummary, 'genre_ids'> {
     created_by: CreatedBy[];
     episode_run_time: number[];
@@ -329,6 +418,10 @@ export interface ImagesResponse {
     logos?: ImageItem[];
     posters: ImageItem[];
 }
+export interface SeasonImagesResponse {
+    id: number;
+    posters: ImageItem[];
+}
 export interface ConfigurationImages {
     base_url: string;
     secure_base_url: string;
@@ -414,12 +507,17 @@ export declare function isKnownStillSize(value: string): value is KnownStillSize
 export declare function isKnownImageSize(value: string): value is KnownImageSize;
 export type MovieAppendToResponse = 'account_states' | 'alternative_titles' | 'changes' | 'credits' | 'external_ids' | 'images' | 'keywords' | 'lists' | 'recommendations' | 'release_dates' | 'reviews' | 'similar' | 'translations' | 'videos' | 'watch/providers' | (string & {});
 export type TVAppendToResponse = 'account_states' | 'aggregate_credits' | 'alternative_titles' | 'changes' | 'content_ratings' | 'credits' | 'episode_groups' | 'external_ids' | 'images' | 'keywords' | 'recommendations' | 'reviews' | 'screened_theatrically' | 'similar' | 'translations' | 'videos' | 'watch/providers' | (string & {});
-export interface ListOptions {
+/** Per-request options shared by every resource method. */
+export interface RequestOptions {
+    /** AbortSignal used to cancel the underlying request. */
+    signal?: AbortSignal;
+}
+export interface ListOptions extends RequestOptions {
     language?: LanguageCode;
     page?: number;
     region?: RegionCode;
 }
-export interface LanguageOptions {
+export interface LanguageOptions extends RequestOptions {
     language?: LanguageCode;
 }
 export interface MovieDetailsOptions extends LanguageOptions {

package/dist/types.d.ts

@@ -162,6 +162,95 @@ export type TVSeasonAppendToResponse = 'account_states' | 'aggregate_credits' |
 export interface TVSeasonDetailsOptions extends LanguageOptions {
     appendToResponse?: TVSeasonAppendToResponse | readonly TVSeasonAppendToResponse[];
 }
+/**
+ * Episode details endpoint payload. Unlike {@link EpisodeSummary}, the
+ * single-episode endpoint does not return `show_id`.
+ */
+export type EpisodeDetails = Omit<EpisodeSummary, 'show_id'>;
+export type EpisodeAppendToResponse = 'account_states' | 'credits' | 'external_ids' | 'images' | 'translations' | 'videos' | (string & {});
+export interface EpisodeDetailsOptions extends LanguageOptions {
+    appendToResponse?: EpisodeAppendToResponse | readonly EpisodeAppendToResponse[];
+}
+export interface AggregateRole {
+    credit_id: string;
+    character: string;
+    episode_count: number;
+}
+export interface AggregateJob {
+    credit_id: string;
+    job: string;
+    episode_count: number;
+}
+export interface AggregateCastMember {
+    adult?: boolean;
+    gender: number | null;
+    id: number;
+    known_for_department: string;
+    name: string;
+    order: number;
+    original_name: string;
+    popularity: number;
+    profile_path: string | null;
+    roles: AggregateRole[];
+    total_episode_count: number;
+}
+export interface AggregateCrewMember {
+    adult?: boolean;
+    department: string;
+    gender: number | null;
+    id: number;
+    jobs: AggregateJob[];
+    known_for_department: string;
+    name: string;
+    original_name: string;
+    popularity: number;
+    profile_path: string | null;
+    total_episode_count: number;
+}
+export interface AggregateCreditsResponse {
+    id: number;
+    cast: AggregateCastMember[];
+    crew: AggregateCrewMember[];
+}
+export interface EpisodeGroupSummary {
+    description: string;
+    episode_count: number;
+    group_count: number;
+    id: string;
+    name: string;
+    network: Network | null;
+    type: number;
+}
+export interface EpisodeGroupsResponse {
+    id: number;
+    results: EpisodeGroupSummary[];
+}
+export interface EpisodeGroupEpisode {
+    air_date: TMDBDateString | null;
+    episode_number: number;
+    episode_type: string;
+    id: number;
+    name: string;
+    order: number;
+    overview: string;
+    production_code: string | null;
+    runtime: number | null;
+    season_number: number;
+    show_id: number;
+    still_path: string | null;
+    vote_average: number;
+    vote_count: number;
+}
+export interface EpisodeGroup {
+    id: string;
+    name: string;
+    order: number;
+    locked: boolean;
+    episodes: EpisodeGroupEpisode[];
+}
+export interface EpisodeGroupDetails extends EpisodeGroupSummary {
+    groups: EpisodeGroup[];
+}
 export interface TVDetails extends Omit<TVSummary, 'genre_ids'> {
     created_by: CreatedBy[];
     episode_run_time: number[];
@@ -329,6 +418,10 @@ export interface ImagesResponse {
     logos?: ImageItem[];
     posters: ImageItem[];
 }
+export interface SeasonImagesResponse {
+    id: number;
+    posters: ImageItem[];
+}
 export interface ConfigurationImages {
     base_url: string;
     secure_base_url: string;
@@ -414,12 +507,17 @@ export declare function isKnownStillSize(value: string): value is KnownStillSize
 export declare function isKnownImageSize(value: string): value is KnownImageSize;
 export type MovieAppendToResponse = 'account_states' | 'alternative_titles' | 'changes' | 'credits' | 'external_ids' | 'images' | 'keywords' | 'lists' | 'recommendations' | 'release_dates' | 'reviews' | 'similar' | 'translations' | 'videos' | 'watch/providers' | (string & {});
 export type TVAppendToResponse = 'account_states' | 'aggregate_credits' | 'alternative_titles' | 'changes' | 'content_ratings' | 'credits' | 'episode_groups' | 'external_ids' | 'images' | 'keywords' | 'recommendations' | 'reviews' | 'screened_theatrically' | 'similar' | 'translations' | 'videos' | 'watch/providers' | (string & {});
-export interface ListOptions {
+/** Per-request options shared by every resource method. */
+export interface RequestOptions {
+    /** AbortSignal used to cancel the underlying request. */
+    signal?: AbortSignal;
+}
+export interface ListOptions extends RequestOptions {
     language?: LanguageCode;
     page?: number;
     region?: RegionCode;
 }
-export interface LanguageOptions {
+export interface LanguageOptions extends RequestOptions {
     language?: LanguageCode;
 }
 export interface MovieDetailsOptions extends LanguageOptions {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tmdb-kit",
   "type": "module",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A tiny, typed, zero-runtime-dependency TMDB SDK and CLI for Node.js, Bun, Deno, and edge runtimes.",
   "author": "isaced",
   "license": "MIT",