npm - @andev2005/movie-glu-sdk - Versions diffs - 1.0.4 → 1.0.6 - Mend

@andev2005/movie-glu-sdk 1.0.4 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md CHANGED Viewed

@@ -16,7 +16,6 @@ npm i @andev2005/movie-glu-sdk
 ## Yêu cầu
-- Có `apiKey` của MovieGlu
 - Runtime có `fetch` (Node.js 18+) hoặc truyền `fetch` custom vào client
 ## Sử dụng nhanh
@@ -27,7 +26,8 @@ npm i @andev2005/movie-glu-sdk
 import { createMovieGluClient } from '@andev2005/movie-glu-sdk';
 const movieGlu = createMovieGluClient({
-  apiKey: process.env.MOVIE_GLU_API_KEY!,
+  // apiKey là optional, mặc định đã được gắn theo cấu hình ANDE/XX
+  // apiKey: process.env.MOVIE_GLU_API_KEY,
 });
 async function main() {
@@ -50,7 +50,6 @@ main().catch(console.error);
 import { createMovieGluClient } from '@andev2005/movie-glu-sdk';
 const client = createMovieGluClient({
-  apiKey: 'your-api-key',
   // Tuỳ chọn:
   // baseUrl: 'https://api-gate2.movieglu.com',
   // headers: { 'x-custom-header': 'value' },
@@ -63,14 +62,27 @@ const client = createMovieGluClient({
 ### `films`
 ```ts
-// Phim đang chiếu
+// Phim đang chiếu (limit optional, default 10)
 await client.films.nowShowing({ limit: 10 });
-// Phim sắp chiếu
+// Phim sắp chiếu (limit optional, default 10)
 await client.films.comingSoon({ limit: 10 });
 // Chi tiết phim
 await client.films.details(12345);
+// Chi tiết phim + size_category
+await client.films.details({
+  filmId: 12345,
+  sizeCategory: ['small', 'medium'],
+});
+// Lịch chiếu theo phim + ngày
+await client.films.showTimes({
+  filmId: 12345,
+  date: '2026-02-25',
+  limit: 10,
+});
 ```
 ### `cinemas`
@@ -106,6 +118,16 @@ await client.cinemas.showTimes({
 SDK sẽ throw `MovieGluError` nếu request thất bại (HTTP status không thành công).
+Mỗi request tự động gửi các header mặc định:
+- `client: ANDE`
+- `x-api-key: Bcg2m9aHOI8QSg5h8EDNK8ecPZRTiove3dsbZVuz`
+- `authorization: Basic QU5ERV9YWDpWMEhoUjYzSHZOalM=`
+- `territory: XX`
+- `api-version: v201`
+- `geolocation: -22.0;14.0`
+- `device-datetime: <ISO datetime hiện tại>`
 ```ts
 import { MovieGluError } from '@andev2005/movie-glu-sdk';
@@ -127,9 +149,10 @@ try {
 SDK có kiểm tra đầu vào và sẽ throw `TypeError` nếu:
-- `apiKey` bị thiếu/rỗng
+- `apiKey` rỗng (nếu bạn truyền vào)
 - `limit` không phải số nguyên dương
-- `id`, `cinemaId`, `filmId` không phải số nguyên dương
+- `id/filmId/cinemaId` không phải số nguyên dương
+- `sizeCategory` không thuộc `small|medium|large|xlarge|xxlarge`
 - `date` không đúng định dạng `YYYY-MM-DD`
 ## Utility build URL (tuỳ chọn)
@@ -148,7 +171,8 @@ Các helper có sẵn:
 - `MOVIE_GLU.FILM_NOWSHOWING(limit)`
 - `MOVIE_GLU.CINEMA_NEARBY(limit)`
 - `MOVIE_GLU.FILMS_COMING_SOON(limit)`
-- `MOVIE_GLU.FILMS_DETAIL(id)`
+- `MOVIE_GLU.FILM_SHOWTIME({ filmId, date, limit? })`
+- `MOVIE_GLU.FILMS_DETAIL(idOrParams)`
 - `MOVIE_GLU.CINEMA_DETAIL(id)`
 - `MOVIE_GLU.CINEMA_SHOWTIME({ cinemaId, date, filmId?, sort? })`

package/dist/index.d.mts CHANGED Viewed

@@ -26,7 +26,7 @@ type Client = {
     fetch?: FetchLike;
 };
 type MovieGluClientConfig = {
-    apiKey: string;
+    apiKey?: string;
     baseUrl?: string;
     headers?: Record<string, string>;
     geolocation?: GeolocationInput;
@@ -38,8 +38,25 @@ type CinemaShowTimesParams = {
     filmId?: number;
     sort?: SortType;
 };
+declare const IMAGE_SIZE_CATEGORY: {
+    readonly SMALL: "small";
+    readonly MEDIUM: "medium";
+    readonly LARGE: "large";
+    readonly XLARGE: "xlarge";
+    readonly XXLARGE: "xxlarge";
+};
+type ImageSizeCategory = (typeof IMAGE_SIZE_CATEGORY)[keyof typeof IMAGE_SIZE_CATEGORY];
+type FilmDetailsParams = {
+    filmId: number;
+    sizeCategory?: ImageSizeCategory | ImageSizeCategory[];
+};
+type FilmShowTimesParams = {
+    date: string;
+    filmId: number;
+    limit?: number;
+};
 type ListParams = {
-    limit: number;
+    limit?: number;
 };
 type GeolocationInput = string | UserLocation;
 type CinemasNearbyParams = ListParams;
@@ -49,7 +66,8 @@ type MovieGluSdk = {
     films: {
         nowShowing(params: ListParams): Promise<FilmsNowShowing>;
         comingSoon(params: ListParams): Promise<FilmsComingSoonResponse>;
-        details(id: number): Promise<FilmDetailsResponse>;
+        details(idOrParams: number | FilmDetailsParams): Promise<FilmDetailsResponse>;
+        showTimes(params: FilmShowTimesParams): Promise<FilmShowTimesResponse>;
     };
     cinemas: {
         nearby(params: CinemasNearbyParams, options?: CinemasNearbyRequestOptions): Promise<CinemasNearbyResponse>;
@@ -76,47 +94,48 @@ type FilmsComingSoonResponse = {
 };
 type FilmDetailsResponse = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
-    other_titles: OtherTitles;
-    version_type: string;
-    images: FilmImages;
-    synopsis_long: string;
-    distributor_id: number;
-    distributor: string;
-    release_dates: ReleaseDate[];
-    age_rating: AgeRating[];
-    duration_mins: number;
-    review_stars: number;
-    review_txt: string;
-    trailers: Trailer[] | null;
-    genres: Genre[];
-    cast: Cast[];
-    directors: Director[];
-    producers: Producer[];
-    writers: Writer[];
-    show_dates: ShowDate[];
-    alternate_versions: AlternateVersion[];
+    other_titles?: OtherTitles;
+    version_type?: string;
+    images?: FilmImages;
+    synopsis_short?: string;
+    synopsis_long?: string;
+    distributor_id?: number;
+    distributor?: string;
+    release_dates?: ReleaseDate[];
+    age_rating?: AgeRating[];
+    duration_mins?: number;
+    review_stars?: number | string;
+    review_txt?: string;
+    trailers?: Trailers | null;
+    genres?: Genre[];
+    cast?: Cast[];
+    directors?: Director[];
+    producers?: Producer[];
+    writers?: Writer[];
+    show_dates?: ShowDate[];
+    alternate_versions?: AlternateVersion[];
     status: Status;
 };
 type CinemaDetailsResponse = {
     cinema_id: number;
     cinema_name: string;
     address: string;
-    address2: string;
+    address2?: string;
     city: string;
-    state: string;
-    county: string;
-    country: string;
+    state?: string;
+    county?: string;
+    country?: string;
     postcode: string;
-    phone: string;
+    phone?: string;
     lat: number;
     lng: number;
-    distance: number;
-    ticketing: number;
-    directions: string;
-    logo_url: string;
+    distance?: number;
+    ticketing?: number;
+    directions?: string;
+    logo_url?: string;
     show_dates: ShowDate[];
     status: Status;
 };
@@ -144,13 +163,13 @@ type Status = {
 };
 type OtherTitles = Record<string, string>;
 type ReleaseDate = {
-    release_date: string;
-    notes: string;
+    release_date?: string;
+    notes?: string;
 };
 type AgeRating = {
-    rating: string;
-    age_rating_image: string;
-    age_advisory: string;
+    rating?: string;
+    age_rating_image?: string;
+    age_advisory?: string;
 };
 type FilmImageSize = {
     film_image: string;
@@ -167,8 +186,8 @@ type Still = {
     medium: FilmImageSize;
 };
 type FilmImages = {
-    poster: KeyNumberObject<Poster>;
-    still: KeyNumberObject<Still>;
+    poster?: KeyNumberObject<Poster>;
+    still?: KeyNumberObject<Still>;
 };
 type ShowDate = {
     date: string;
@@ -177,10 +196,10 @@ type Cinema = {
     cinema_id: number;
     cinema_name: string;
     address: string;
-    address2: string;
+    address2?: string;
     city: string;
-    state: string;
-    county: string;
+    state?: string;
+    county?: string;
     country?: string;
     postcode: string;
     phone?: string;
@@ -193,8 +212,8 @@ type Cinema = {
 };
 type Film = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
     other_titles?: OtherTitles;
     release_dates: ReleaseDate[];
@@ -205,10 +224,10 @@ type Film = {
 };
 type FilmComingSoon = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
-    other_titles: OtherTitles;
+    other_titles?: OtherTitles;
     release_dates: ReleaseDate[];
     age_rating: AgeRating[];
     film_trailer: string | null;
@@ -240,11 +259,15 @@ type AlternateVersion = {
     film_name: string;
     version_type: string;
 };
-type Trailer = {
-    trailer_url?: string;
+type TrailerItem = {
+    film_trailer?: string;
     trailer_image?: string;
-    trailer_type?: string;
-    [key: string]: string | number | boolean | null | undefined;
+    version?: number;
+    quality?: string;
+    region?: string;
+};
+type Trailers = {
+    [quality: string]: TrailerItem[];
 };
 type ShowtimeTime = {
     start_time: string;
@@ -262,10 +285,10 @@ type CinemaShowTimesCinema = {
 };
 type CinemaShowTimesFilm = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
-    other_titles: OtherTitles;
+    other_titles?: OtherTitles;
     version_type: string;
     age_rating: AgeRating[];
     film_image: string;
@@ -276,10 +299,10 @@ type CinemaShowTimesFilm = {
 };
 type FilmShowTimesFilm = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
-    other_titles: OtherTitles;
+    other_titles?: OtherTitles;
     version_type: string;
     age_rating: AgeRating[];
     film_image: string;
@@ -310,10 +333,11 @@ declare const MOVIE_GLU: {
     FILM_NOWSHOWING(limit: number): string;
     CINEMA_NEARBY(limit: number): string;
     FILMS_COMING_SOON(limit: number): string;
-    FILMS_DETAIL(id: number): string;
+    FILM_SHOWTIME(params: FilmShowTimesParams): string;
+    FILMS_DETAIL(idOrParams: number | FilmDetailsParams): string;
     CINEMA_DETAIL(id: number): string;
     CINEMA_SHOWTIME(params: CinemaShowTimesParams): string;
 };
 declare function createMovieGluClient(config: MovieGluClientConfig): MovieGluSdk;
-export { type AgeRating, type AlternateVersion, type Cast, type Cinema, type CinemaDetailsRequestOptions, type CinemaDetailsResponse, type CinemaShowTimesCinema, type CinemaShowTimesFilm, type CinemaShowTimesParams, type CinemaShowTimesResponse, type CinemasNearbyParams, type CinemasNearbyRequestOptions, type CinemasNearbyResponse, type Client, DEFAULT_BASE_URL, type Director, type FetchLike, type Film, type FilmComingSoon, type FilmDetailsResponse, type FilmImageSize, type FilmImages, type FilmShowTimesCinema, type FilmShowTimesFilm, type FilmShowTimesResponse, type FilmsComingSoonResponse, type FilmsNowShowing, type Genre, type GeolocationInput, type KeyNumberObject, type ListParams, MOVIE_GLU, type MovieGluClientConfig, MovieGluError, type MovieGluSdk, type OtherTitles, type Poster, type Producer, type ReleaseDate, type RequestOptions, SORT_TYPE, type ShowDate, type Showings, type ShowtimeGroup, type ShowtimeTime, type SortType, type Status, type Still, type Trailer, type UserLocation, type Writer, createMovieGluClient };
+export { type AgeRating, type AlternateVersion, type Cast, type Cinema, type CinemaDetailsRequestOptions, type CinemaDetailsResponse, type CinemaShowTimesCinema, type CinemaShowTimesFilm, type CinemaShowTimesParams, type CinemaShowTimesResponse, type CinemasNearbyParams, type CinemasNearbyRequestOptions, type CinemasNearbyResponse, type Client, DEFAULT_BASE_URL, type Director, type FetchLike, type Film, type FilmComingSoon, type FilmDetailsParams, type FilmDetailsResponse, type FilmImageSize, type FilmImages, type FilmShowTimesCinema, type FilmShowTimesFilm, type FilmShowTimesParams, type FilmShowTimesResponse, type FilmsComingSoonResponse, type FilmsNowShowing, type Genre, type GeolocationInput, IMAGE_SIZE_CATEGORY, type ImageSizeCategory, type KeyNumberObject, type ListParams, MOVIE_GLU, type MovieGluClientConfig, MovieGluError, type MovieGluSdk, type OtherTitles, type Poster, type Producer, type ReleaseDate, type RequestOptions, SORT_TYPE, type ShowDate, type Showings, type ShowtimeGroup, type ShowtimeTime, type SortType, type Status, type Still, type TrailerItem, type Trailers, type UserLocation, type Writer, createMovieGluClient };

package/dist/index.d.ts CHANGED Viewed

@@ -26,7 +26,7 @@ type Client = {
     fetch?: FetchLike;
 };
 type MovieGluClientConfig = {
-    apiKey: string;
+    apiKey?: string;
     baseUrl?: string;
     headers?: Record<string, string>;
     geolocation?: GeolocationInput;
@@ -38,8 +38,25 @@ type CinemaShowTimesParams = {
     filmId?: number;
     sort?: SortType;
 };
+declare const IMAGE_SIZE_CATEGORY: {
+    readonly SMALL: "small";
+    readonly MEDIUM: "medium";
+    readonly LARGE: "large";
+    readonly XLARGE: "xlarge";
+    readonly XXLARGE: "xxlarge";
+};
+type ImageSizeCategory = (typeof IMAGE_SIZE_CATEGORY)[keyof typeof IMAGE_SIZE_CATEGORY];
+type FilmDetailsParams = {
+    filmId: number;
+    sizeCategory?: ImageSizeCategory | ImageSizeCategory[];
+};
+type FilmShowTimesParams = {
+    date: string;
+    filmId: number;
+    limit?: number;
+};
 type ListParams = {
-    limit: number;
+    limit?: number;
 };
 type GeolocationInput = string | UserLocation;
 type CinemasNearbyParams = ListParams;
@@ -49,7 +66,8 @@ type MovieGluSdk = {
     films: {
         nowShowing(params: ListParams): Promise<FilmsNowShowing>;
         comingSoon(params: ListParams): Promise<FilmsComingSoonResponse>;
-        details(id: number): Promise<FilmDetailsResponse>;
+        details(idOrParams: number | FilmDetailsParams): Promise<FilmDetailsResponse>;
+        showTimes(params: FilmShowTimesParams): Promise<FilmShowTimesResponse>;
     };
     cinemas: {
         nearby(params: CinemasNearbyParams, options?: CinemasNearbyRequestOptions): Promise<CinemasNearbyResponse>;
@@ -76,47 +94,48 @@ type FilmsComingSoonResponse = {
 };
 type FilmDetailsResponse = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
-    other_titles: OtherTitles;
-    version_type: string;
-    images: FilmImages;
-    synopsis_long: string;
-    distributor_id: number;
-    distributor: string;
-    release_dates: ReleaseDate[];
-    age_rating: AgeRating[];
-    duration_mins: number;
-    review_stars: number;
-    review_txt: string;
-    trailers: Trailer[] | null;
-    genres: Genre[];
-    cast: Cast[];
-    directors: Director[];
-    producers: Producer[];
-    writers: Writer[];
-    show_dates: ShowDate[];
-    alternate_versions: AlternateVersion[];
+    other_titles?: OtherTitles;
+    version_type?: string;
+    images?: FilmImages;
+    synopsis_short?: string;
+    synopsis_long?: string;
+    distributor_id?: number;
+    distributor?: string;
+    release_dates?: ReleaseDate[];
+    age_rating?: AgeRating[];
+    duration_mins?: number;
+    review_stars?: number | string;
+    review_txt?: string;
+    trailers?: Trailers | null;
+    genres?: Genre[];
+    cast?: Cast[];
+    directors?: Director[];
+    producers?: Producer[];
+    writers?: Writer[];
+    show_dates?: ShowDate[];
+    alternate_versions?: AlternateVersion[];
     status: Status;
 };
 type CinemaDetailsResponse = {
     cinema_id: number;
     cinema_name: string;
     address: string;
-    address2: string;
+    address2?: string;
     city: string;
-    state: string;
-    county: string;
-    country: string;
+    state?: string;
+    county?: string;
+    country?: string;
     postcode: string;
-    phone: string;
+    phone?: string;
     lat: number;
     lng: number;
-    distance: number;
-    ticketing: number;
-    directions: string;
-    logo_url: string;
+    distance?: number;
+    ticketing?: number;
+    directions?: string;
+    logo_url?: string;
     show_dates: ShowDate[];
     status: Status;
 };
@@ -144,13 +163,13 @@ type Status = {
 };
 type OtherTitles = Record<string, string>;
 type ReleaseDate = {
-    release_date: string;
-    notes: string;
+    release_date?: string;
+    notes?: string;
 };
 type AgeRating = {
-    rating: string;
-    age_rating_image: string;
-    age_advisory: string;
+    rating?: string;
+    age_rating_image?: string;
+    age_advisory?: string;
 };
 type FilmImageSize = {
     film_image: string;
@@ -167,8 +186,8 @@ type Still = {
     medium: FilmImageSize;
 };
 type FilmImages = {
-    poster: KeyNumberObject<Poster>;
-    still: KeyNumberObject<Still>;
+    poster?: KeyNumberObject<Poster>;
+    still?: KeyNumberObject<Still>;
 };
 type ShowDate = {
     date: string;
@@ -177,10 +196,10 @@ type Cinema = {
     cinema_id: number;
     cinema_name: string;
     address: string;
-    address2: string;
+    address2?: string;
     city: string;
-    state: string;
-    county: string;
+    state?: string;
+    county?: string;
     country?: string;
     postcode: string;
     phone?: string;
@@ -193,8 +212,8 @@ type Cinema = {
 };
 type Film = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
     other_titles?: OtherTitles;
     release_dates: ReleaseDate[];
@@ -205,10 +224,10 @@ type Film = {
 };
 type FilmComingSoon = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
-    other_titles: OtherTitles;
+    other_titles?: OtherTitles;
     release_dates: ReleaseDate[];
     age_rating: AgeRating[];
     film_trailer: string | null;
@@ -240,11 +259,15 @@ type AlternateVersion = {
     film_name: string;
     version_type: string;
 };
-type Trailer = {
-    trailer_url?: string;
+type TrailerItem = {
+    film_trailer?: string;
     trailer_image?: string;
-    trailer_type?: string;
-    [key: string]: string | number | boolean | null | undefined;
+    version?: number;
+    quality?: string;
+    region?: string;
+};
+type Trailers = {
+    [quality: string]: TrailerItem[];
 };
 type ShowtimeTime = {
     start_time: string;
@@ -262,10 +285,10 @@ type CinemaShowTimesCinema = {
 };
 type CinemaShowTimesFilm = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
-    other_titles: OtherTitles;
+    other_titles?: OtherTitles;
     version_type: string;
     age_rating: AgeRating[];
     film_image: string;
@@ -276,10 +299,10 @@ type CinemaShowTimesFilm = {
 };
 type FilmShowTimesFilm = {
     film_id: number;
-    imdb_id: number;
-    imdb_title_id: string;
+    imdb_id?: number;
+    imdb_title_id?: string;
     film_name: string;
-    other_titles: OtherTitles;
+    other_titles?: OtherTitles;
     version_type: string;
     age_rating: AgeRating[];
     film_image: string;
@@ -310,10 +333,11 @@ declare const MOVIE_GLU: {
     FILM_NOWSHOWING(limit: number): string;
     CINEMA_NEARBY(limit: number): string;
     FILMS_COMING_SOON(limit: number): string;
-    FILMS_DETAIL(id: number): string;
+    FILM_SHOWTIME(params: FilmShowTimesParams): string;
+    FILMS_DETAIL(idOrParams: number | FilmDetailsParams): string;
     CINEMA_DETAIL(id: number): string;
     CINEMA_SHOWTIME(params: CinemaShowTimesParams): string;
 };
 declare function createMovieGluClient(config: MovieGluClientConfig): MovieGluSdk;
-export { type AgeRating, type AlternateVersion, type Cast, type Cinema, type CinemaDetailsRequestOptions, type CinemaDetailsResponse, type CinemaShowTimesCinema, type CinemaShowTimesFilm, type CinemaShowTimesParams, type CinemaShowTimesResponse, type CinemasNearbyParams, type CinemasNearbyRequestOptions, type CinemasNearbyResponse, type Client, DEFAULT_BASE_URL, type Director, type FetchLike, type Film, type FilmComingSoon, type FilmDetailsResponse, type FilmImageSize, type FilmImages, type FilmShowTimesCinema, type FilmShowTimesFilm, type FilmShowTimesResponse, type FilmsComingSoonResponse, type FilmsNowShowing, type Genre, type GeolocationInput, type KeyNumberObject, type ListParams, MOVIE_GLU, type MovieGluClientConfig, MovieGluError, type MovieGluSdk, type OtherTitles, type Poster, type Producer, type ReleaseDate, type RequestOptions, SORT_TYPE, type ShowDate, type Showings, type ShowtimeGroup, type ShowtimeTime, type SortType, type Status, type Still, type Trailer, type UserLocation, type Writer, createMovieGluClient };
+export { type AgeRating, type AlternateVersion, type Cast, type Cinema, type CinemaDetailsRequestOptions, type CinemaDetailsResponse, type CinemaShowTimesCinema, type CinemaShowTimesFilm, type CinemaShowTimesParams, type CinemaShowTimesResponse, type CinemasNearbyParams, type CinemasNearbyRequestOptions, type CinemasNearbyResponse, type Client, DEFAULT_BASE_URL, type Director, type FetchLike, type Film, type FilmComingSoon, type FilmDetailsParams, type FilmDetailsResponse, type FilmImageSize, type FilmImages, type FilmShowTimesCinema, type FilmShowTimesFilm, type FilmShowTimesParams, type FilmShowTimesResponse, type FilmsComingSoonResponse, type FilmsNowShowing, type Genre, type GeolocationInput, IMAGE_SIZE_CATEGORY, type ImageSizeCategory, type KeyNumberObject, type ListParams, MOVIE_GLU, type MovieGluClientConfig, MovieGluError, type MovieGluSdk, type OtherTitles, type Poster, type Producer, type ReleaseDate, type RequestOptions, SORT_TYPE, type ShowDate, type Showings, type ShowtimeGroup, type ShowtimeTime, type SortType, type Status, type Still, type TrailerItem, type Trailers, type UserLocation, type Writer, createMovieGluClient };

package/dist/index.js CHANGED Viewed

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  IMAGE_SIZE_CATEGORY: () => IMAGE_SIZE_CATEGORY,
   MOVIE_GLU: () => MOVIE_GLU,
   MovieGluError: () => MovieGluError,
   SORT_TYPE: () => SORT_TYPE,
@@ -96,7 +97,13 @@ async function httpRequest(client, path, options = {}) {
   }
   const headers = {
     Accept: "application/json",
+    client: "ANDE",
     "x-api-key": client.apiKey,
+    authorization: "Basic QU5ERV9YWDpWMEhoUjYzSHZOalM=",
+    territory: "XX",
+    "api-version": "v201",
+    geolocation: "-22.0;14.0",
+    "device-datetime": (/* @__PURE__ */ new Date()).toISOString(),
     ...client.headers,
     ...options.headers
   };
@@ -124,17 +131,28 @@ var SORT_TYPE = {
   ALPHABETICAL: "alphabetical",
   POPULARITY: "popularity"
 };
+var IMAGE_SIZE_CATEGORY = {
+  SMALL: "small",
+  MEDIUM: "medium",
+  LARGE: "large",
+  XLARGE: "xlarge",
+  XXLARGE: "xxlarge"
+};
 // src/index.ts
 var DEFAULT_BASE_URL = "https://api-gate2.movieglu.com";
 var ENDPOINT_PATH = {
   FILM_NOWSHOWING: "/filmsNowShowing",
+  FILM_SHOWTIME: "/filmShowTimes",
   CINEMA_NEARBY: "/cinemasNearby",
   FILMS_COMING_SOON: "/filmsComingSoon",
   FILMS_DETAIL: "/filmDetails/",
   CINEMA_DETAIL: "/cinemaDetails/",
   CINEMA_SHOWTIME: "/cinemaShowTimes/"
 };
+var DEFAULT_API_KEY = "Bcg2m9aHOI8QSg5h8EDNK8ecPZRTiove3dsbZVuz";
+var DEFAULT_LIST_LIMIT = 10;
+var VALID_IMAGE_SIZE_CATEGORIES = /* @__PURE__ */ new Set(["small", "medium", "large", "xlarge", "xxlarge"]);
 function normalizeBaseUrl(baseUrl) {
   return baseUrl.replace(/\/+$/, "");
 }
@@ -177,8 +195,9 @@ function formatGeolocationHeader(geolocation) {
   return `${geolocation.lat};${geolocation.lng}`;
 }
 function toListQuery(params) {
-  assertPositiveInteger(params.limit, "limit");
-  return { n: params.limit };
+  const limit = params.limit ?? DEFAULT_LIST_LIMIT;
+  assertPositiveInteger(limit, "limit");
+  return { n: limit };
 }
 function toCinemaShowTimesQuery(params) {
   assertPositiveInteger(params.cinemaId, "cinemaId");
@@ -193,6 +212,34 @@ function toCinemaShowTimesQuery(params) {
     film_id: params.filmId
   };
 }
+function toFilmShowTimesQuery(params) {
+  assertDateString(params.date, "date");
+  assertPositiveInteger(params.filmId, "filmId");
+  if (params.limit !== void 0) {
+    assertPositiveInteger(params.limit, "limit");
+  }
+  return {
+    date: params.date,
+    film_id: params.filmId,
+    n: params.limit
+  };
+}
+function normalizeFilmDetailsInput(input) {
+  const details = typeof input === "number" ? { filmId: input } : input;
+  assertPositiveInteger(details.filmId, "filmId");
+  if (!details.sizeCategory) {
+    return { film_id: details.filmId };
+  }
+  const sizeCategoryRaw = Array.isArray(details.sizeCategory) ? details.sizeCategory.join(",") : details.sizeCategory;
+  const normalizedValues = sizeCategoryRaw.split(",").map((value) => value.trim().toLowerCase()).filter(Boolean);
+  if (normalizedValues.length === 0 || normalizedValues.some((value) => !VALID_IMAGE_SIZE_CATEGORIES.has(value))) {
+    throw new TypeError("sizeCategory must be one or more of: small, medium, large, xlarge, xxlarge");
+  }
+  return {
+    film_id: details.filmId,
+    size_category: normalizedValues.join(",")
+  };
+}
 var MOVIE_GLU = {
   FILM_NOWSHOWING(limit) {
     assertPositiveInteger(limit, "limit");
@@ -206,9 +253,11 @@ var MOVIE_GLU = {
     assertPositiveInteger(limit, "limit");
     return buildUrl(ENDPOINT_PATH.FILMS_COMING_SOON, { n: limit });
   },
-  FILMS_DETAIL(id) {
-    assertPositiveInteger(id, "id");
-    return buildUrl(ENDPOINT_PATH.FILMS_DETAIL, { film_id: id });
+  FILM_SHOWTIME(params) {
+    return buildUrl(ENDPOINT_PATH.FILM_SHOWTIME, toFilmShowTimesQuery(params));
+  },
+  FILMS_DETAIL(idOrParams) {
+    return buildUrl(ENDPOINT_PATH.FILMS_DETAIL, normalizeFilmDetailsInput(idOrParams));
   },
   CINEMA_DETAIL(id) {
     assertPositiveInteger(id, "id");
@@ -219,12 +268,13 @@ var MOVIE_GLU = {
   }
 };
 function createMovieGluClient(config) {
-  if (typeof config.apiKey !== "string" || !config.apiKey.trim()) {
-    throw new TypeError("apiKey is required");
+  const resolvedApiKey = (config.apiKey ?? DEFAULT_API_KEY).trim();
+  if (!resolvedApiKey) {
+    throw new TypeError("apiKey must not be empty");
   }
   const client = {
     baseUrl: normalizeBaseUrl(config.baseUrl ?? DEFAULT_BASE_URL),
-    apiKey: config.apiKey,
+    apiKey: resolvedApiKey,
     headers: config.headers,
     geolocation: config.geolocation,
     fetch: config.fetch
@@ -241,10 +291,14 @@ function createMovieGluClient(config) {
           queryParams: toListQuery(params)
         });
       },
-      details(id) {
-        assertPositiveInteger(id, "id");
+      details(idOrParams) {
         return httpRequest(client, ENDPOINT_PATH.FILMS_DETAIL, {
-          queryParams: { film_id: id }
+          queryParams: normalizeFilmDetailsInput(idOrParams)
+        });
+      },
+      showTimes(params) {
+        return httpRequest(client, ENDPOINT_PATH.FILM_SHOWTIME, {
+          queryParams: toFilmShowTimesQuery(params)
         });
       }
     },
@@ -284,6 +338,7 @@ function createMovieGluClient(config) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_BASE_URL,
+  IMAGE_SIZE_CATEGORY,
   MOVIE_GLU,
   MovieGluError,
   SORT_TYPE,

package/dist/index.mjs CHANGED Viewed

@@ -67,7 +67,13 @@ async function httpRequest(client, path, options = {}) {
   }
   const headers = {
     Accept: "application/json",
+    client: "ANDE",
     "x-api-key": client.apiKey,
+    authorization: "Basic QU5ERV9YWDpWMEhoUjYzSHZOalM=",
+    territory: "XX",
+    "api-version": "v201",
+    geolocation: "-22.0;14.0",
+    "device-datetime": (/* @__PURE__ */ new Date()).toISOString(),
     ...client.headers,
     ...options.headers
   };
@@ -95,17 +101,28 @@ var SORT_TYPE = {
   ALPHABETICAL: "alphabetical",
   POPULARITY: "popularity"
 };
+var IMAGE_SIZE_CATEGORY = {
+  SMALL: "small",
+  MEDIUM: "medium",
+  LARGE: "large",
+  XLARGE: "xlarge",
+  XXLARGE: "xxlarge"
+};
 // src/index.ts
 var DEFAULT_BASE_URL = "https://api-gate2.movieglu.com";
 var ENDPOINT_PATH = {
   FILM_NOWSHOWING: "/filmsNowShowing",
+  FILM_SHOWTIME: "/filmShowTimes",
   CINEMA_NEARBY: "/cinemasNearby",
   FILMS_COMING_SOON: "/filmsComingSoon",
   FILMS_DETAIL: "/filmDetails/",
   CINEMA_DETAIL: "/cinemaDetails/",
   CINEMA_SHOWTIME: "/cinemaShowTimes/"
 };
+var DEFAULT_API_KEY = "Bcg2m9aHOI8QSg5h8EDNK8ecPZRTiove3dsbZVuz";
+var DEFAULT_LIST_LIMIT = 10;
+var VALID_IMAGE_SIZE_CATEGORIES = /* @__PURE__ */ new Set(["small", "medium", "large", "xlarge", "xxlarge"]);
 function normalizeBaseUrl(baseUrl) {
   return baseUrl.replace(/\/+$/, "");
 }
@@ -148,8 +165,9 @@ function formatGeolocationHeader(geolocation) {
   return `${geolocation.lat};${geolocation.lng}`;
 }
 function toListQuery(params) {
-  assertPositiveInteger(params.limit, "limit");
-  return { n: params.limit };
+  const limit = params.limit ?? DEFAULT_LIST_LIMIT;
+  assertPositiveInteger(limit, "limit");
+  return { n: limit };
 }
 function toCinemaShowTimesQuery(params) {
   assertPositiveInteger(params.cinemaId, "cinemaId");
@@ -164,6 +182,34 @@ function toCinemaShowTimesQuery(params) {
     film_id: params.filmId
   };
 }
+function toFilmShowTimesQuery(params) {
+  assertDateString(params.date, "date");
+  assertPositiveInteger(params.filmId, "filmId");
+  if (params.limit !== void 0) {
+    assertPositiveInteger(params.limit, "limit");
+  }
+  return {
+    date: params.date,
+    film_id: params.filmId,
+    n: params.limit
+  };
+}
+function normalizeFilmDetailsInput(input) {
+  const details = typeof input === "number" ? { filmId: input } : input;
+  assertPositiveInteger(details.filmId, "filmId");
+  if (!details.sizeCategory) {
+    return { film_id: details.filmId };
+  }
+  const sizeCategoryRaw = Array.isArray(details.sizeCategory) ? details.sizeCategory.join(",") : details.sizeCategory;
+  const normalizedValues = sizeCategoryRaw.split(",").map((value) => value.trim().toLowerCase()).filter(Boolean);
+  if (normalizedValues.length === 0 || normalizedValues.some((value) => !VALID_IMAGE_SIZE_CATEGORIES.has(value))) {
+    throw new TypeError("sizeCategory must be one or more of: small, medium, large, xlarge, xxlarge");
+  }
+  return {
+    film_id: details.filmId,
+    size_category: normalizedValues.join(",")
+  };
+}
 var MOVIE_GLU = {
   FILM_NOWSHOWING(limit) {
     assertPositiveInteger(limit, "limit");
@@ -177,9 +223,11 @@ var MOVIE_GLU = {
     assertPositiveInteger(limit, "limit");
     return buildUrl(ENDPOINT_PATH.FILMS_COMING_SOON, { n: limit });
   },
-  FILMS_DETAIL(id) {
-    assertPositiveInteger(id, "id");
-    return buildUrl(ENDPOINT_PATH.FILMS_DETAIL, { film_id: id });
+  FILM_SHOWTIME(params) {
+    return buildUrl(ENDPOINT_PATH.FILM_SHOWTIME, toFilmShowTimesQuery(params));
+  },
+  FILMS_DETAIL(idOrParams) {
+    return buildUrl(ENDPOINT_PATH.FILMS_DETAIL, normalizeFilmDetailsInput(idOrParams));
   },
   CINEMA_DETAIL(id) {
     assertPositiveInteger(id, "id");
@@ -190,12 +238,13 @@ var MOVIE_GLU = {
   }
 };
 function createMovieGluClient(config) {
-  if (typeof config.apiKey !== "string" || !config.apiKey.trim()) {
-    throw new TypeError("apiKey is required");
+  const resolvedApiKey = (config.apiKey ?? DEFAULT_API_KEY).trim();
+  if (!resolvedApiKey) {
+    throw new TypeError("apiKey must not be empty");
   }
   const client = {
     baseUrl: normalizeBaseUrl(config.baseUrl ?? DEFAULT_BASE_URL),
-    apiKey: config.apiKey,
+    apiKey: resolvedApiKey,
     headers: config.headers,
     geolocation: config.geolocation,
     fetch: config.fetch
@@ -212,10 +261,14 @@ function createMovieGluClient(config) {
           queryParams: toListQuery(params)
         });
       },
-      details(id) {
-        assertPositiveInteger(id, "id");
+      details(idOrParams) {
         return httpRequest(client, ENDPOINT_PATH.FILMS_DETAIL, {
-          queryParams: { film_id: id }
+          queryParams: normalizeFilmDetailsInput(idOrParams)
+        });
+      },
+      showTimes(params) {
+        return httpRequest(client, ENDPOINT_PATH.FILM_SHOWTIME, {
+          queryParams: toFilmShowTimesQuery(params)
         });
       }
     },
@@ -254,6 +307,7 @@ function createMovieGluClient(config) {
 }
 export {
   DEFAULT_BASE_URL,
+  IMAGE_SIZE_CATEGORY,
   MOVIE_GLU,
   MovieGluError,
   SORT_TYPE,

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@andev2005/movie-glu-sdk",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/http.ts CHANGED Viewed

@@ -82,7 +82,13 @@ export async function httpRequest<T>(
   const headers: Record<string, string> = {
     Accept: 'application/json',
+    client: 'ANDE',
     'x-api-key': client.apiKey,
+    authorization: 'Basic QU5ERV9YWDpWMEhoUjYzSHZOalM=',
+    territory: 'XX',
+    'api-version': 'v201',
+    geolocation: '-22.0;14.0',
+    'device-datetime': new Date().toISOString(),
     ...client.headers,
     ...options.headers,
   };

package/src/index.ts CHANGED Viewed

@@ -7,7 +7,10 @@ import type {
   CinemasNearbyParams,
   CinemasNearbyRequestOptions,
   CinemasNearbyResponse,
+  FilmDetailsParams,
   FilmDetailsResponse,
+  FilmShowTimesParams,
+  FilmShowTimesResponse,
   FilmsComingSoonResponse,
   FilmsNowShowing,
   GeolocationInput,
@@ -22,6 +25,7 @@ export const DEFAULT_BASE_URL = 'https://api-gate2.movieglu.com';
 const ENDPOINT_PATH = {
   FILM_NOWSHOWING: '/filmsNowShowing',
+  FILM_SHOWTIME: '/filmShowTimes',
   CINEMA_NEARBY: '/cinemasNearby',
   FILMS_COMING_SOON: '/filmsComingSoon',
   FILMS_DETAIL: '/filmDetails/',
@@ -29,6 +33,10 @@ const ENDPOINT_PATH = {
   CINEMA_SHOWTIME: '/cinemaShowTimes/',
 } as const;
+const DEFAULT_API_KEY = 'Bcg2m9aHOI8QSg5h8EDNK8ecPZRTiove3dsbZVuz';
+const DEFAULT_LIST_LIMIT = 10;
+const VALID_IMAGE_SIZE_CATEGORIES = new Set(['small', 'medium', 'large', 'xlarge', 'xxlarge']);
 type QueryValue = string | number | boolean | null | undefined;
 function normalizeBaseUrl(baseUrl: string): string {
@@ -86,8 +94,9 @@ function formatGeolocationHeader(geolocation: GeolocationInput): string {
 }
 function toListQuery(params: ListParams): { n: number } {
-  assertPositiveInteger(params.limit, 'limit');
-  return { n: params.limit };
+  const limit = params.limit ?? DEFAULT_LIST_LIMIT;
+  assertPositiveInteger(limit, 'limit');
+  return { n: limit };
 }
 function toCinemaShowTimesQuery(params: CinemaShowTimesParams): {
@@ -111,6 +120,48 @@ function toCinemaShowTimesQuery(params: CinemaShowTimesParams): {
   };
 }
+function toFilmShowTimesQuery(params: FilmShowTimesParams): { date: string; film_id: number; n?: number } {
+  assertDateString(params.date, 'date');
+  assertPositiveInteger(params.filmId, 'filmId');
+  if (params.limit !== undefined) {
+    assertPositiveInteger(params.limit, 'limit');
+  }
+  return {
+    date: params.date,
+    film_id: params.filmId,
+    n: params.limit,
+  };
+}
+function normalizeFilmDetailsInput(input: number | FilmDetailsParams): { film_id: number; size_category?: string } {
+  const details = typeof input === 'number' ? { filmId: input } : input;
+  assertPositiveInteger(details.filmId, 'filmId');
+  if (!details.sizeCategory) {
+    return { film_id: details.filmId };
+  }
+  const sizeCategoryRaw = Array.isArray(details.sizeCategory)
+    ? details.sizeCategory.join(',')
+    : details.sizeCategory;
+  const normalizedValues = sizeCategoryRaw
+    .split(',')
+    .map((value) => value.trim().toLowerCase())
+    .filter(Boolean);
+  if (normalizedValues.length === 0 || normalizedValues.some((value) => !VALID_IMAGE_SIZE_CATEGORIES.has(value))) {
+    throw new TypeError('sizeCategory must be one or more of: small, medium, large, xlarge, xxlarge');
+  }
+  return {
+    film_id: details.filmId,
+    size_category: normalizedValues.join(','),
+  };
+}
 export const MOVIE_GLU = {
   FILM_NOWSHOWING(limit: number): string {
     assertPositiveInteger(limit, 'limit');
@@ -124,9 +175,11 @@ export const MOVIE_GLU = {
     assertPositiveInteger(limit, 'limit');
     return buildUrl(ENDPOINT_PATH.FILMS_COMING_SOON, { n: limit });
   },
-  FILMS_DETAIL(id: number): string {
-    assertPositiveInteger(id, 'id');
-    return buildUrl(ENDPOINT_PATH.FILMS_DETAIL, { film_id: id });
+  FILM_SHOWTIME(params: FilmShowTimesParams): string {
+    return buildUrl(ENDPOINT_PATH.FILM_SHOWTIME, toFilmShowTimesQuery(params));
+  },
+  FILMS_DETAIL(idOrParams: number | FilmDetailsParams): string {
+    return buildUrl(ENDPOINT_PATH.FILMS_DETAIL, normalizeFilmDetailsInput(idOrParams));
   },
   CINEMA_DETAIL(id: number): string {
     assertPositiveInteger(id, 'id');
@@ -138,13 +191,14 @@ export const MOVIE_GLU = {
 };
 export function createMovieGluClient(config: MovieGluClientConfig): MovieGluSdk {
-  if (typeof config.apiKey !== 'string' || !config.apiKey.trim()) {
-    throw new TypeError('apiKey is required');
+  const resolvedApiKey = (config.apiKey ?? DEFAULT_API_KEY).trim();
+  if (!resolvedApiKey) {
+    throw new TypeError('apiKey must not be empty');
   }
   const client = {
     baseUrl: normalizeBaseUrl(config.baseUrl ?? DEFAULT_BASE_URL),
-    apiKey: config.apiKey,
+    apiKey: resolvedApiKey,
     headers: config.headers,
     geolocation: config.geolocation,
     fetch: config.fetch,
@@ -162,10 +216,14 @@ export function createMovieGluClient(config: MovieGluClientConfig): MovieGluSdk
           queryParams: toListQuery(params),
         });
       },
-      details(id: number): Promise<FilmDetailsResponse> {
-        assertPositiveInteger(id, 'id');
+      details(idOrParams: number | FilmDetailsParams): Promise<FilmDetailsResponse> {
         return httpRequest<FilmDetailsResponse>(client, ENDPOINT_PATH.FILMS_DETAIL, {
-          queryParams: { film_id: id },
+          queryParams: normalizeFilmDetailsInput(idOrParams),
+        });
+      },
+      showTimes(params: FilmShowTimesParams): Promise<FilmShowTimesResponse> {
+        return httpRequest<FilmShowTimesResponse>(client, ENDPOINT_PATH.FILM_SHOWTIME, {
+          queryParams: toFilmShowTimesQuery(params),
         });
       },
     },

package/src/type.ts CHANGED Viewed

@@ -32,7 +32,7 @@ export type Client = {
 };
 export type MovieGluClientConfig = {
-  apiKey: string;
+  apiKey?: string;
   baseUrl?: string;
   headers?: Record<string, string>;
   geolocation?: GeolocationInput;
@@ -46,8 +46,29 @@ export type CinemaShowTimesParams = {
   sort?: SortType;
 };
+export const IMAGE_SIZE_CATEGORY = {
+  SMALL: 'small',
+  MEDIUM: 'medium',
+  LARGE: 'large',
+  XLARGE: 'xlarge',
+  XXLARGE: 'xxlarge',
+} as const;
+export type ImageSizeCategory = (typeof IMAGE_SIZE_CATEGORY)[keyof typeof IMAGE_SIZE_CATEGORY];
+export type FilmDetailsParams = {
+  filmId: number;
+  sizeCategory?: ImageSizeCategory | ImageSizeCategory[];
+};
+export type FilmShowTimesParams = {
+  date: string;
+  filmId: number;
+  limit?: number;
+};
 export type ListParams = {
-  limit: number;
+  limit?: number;
 };
 export type GeolocationInput = string | UserLocation;
@@ -61,7 +82,8 @@ export type MovieGluSdk = {
   films: {
     nowShowing(params: ListParams): Promise<FilmsNowShowing>;
     comingSoon(params: ListParams): Promise<FilmsComingSoonResponse>;
-    details(id: number): Promise<FilmDetailsResponse>;
+    details(idOrParams: number | FilmDetailsParams): Promise<FilmDetailsResponse>;
+    showTimes(params: FilmShowTimesParams): Promise<FilmShowTimesResponse>;
   };
   cinemas: {
     nearby(params: CinemasNearbyParams, options?: CinemasNearbyRequestOptions): Promise<CinemasNearbyResponse>;
@@ -93,28 +115,29 @@ export type FilmsComingSoonResponse = {
 export type FilmDetailsResponse = {
   film_id: number;
-  imdb_id: number;
-  imdb_title_id: string;
+  imdb_id?: number;
+  imdb_title_id?: string;
   film_name: string;
-  other_titles: OtherTitles;
-  version_type: string;
-  images: FilmImages;
-  synopsis_long: string;
-  distributor_id: number;
-  distributor: string;
-  release_dates: ReleaseDate[];
-  age_rating: AgeRating[];
-  duration_mins: number;
-  review_stars: number;
-  review_txt: string;
-  trailers: Trailer[] | null;
-  genres: Genre[];
-  cast: Cast[];
-  directors: Director[];
-  producers: Producer[];
-  writers: Writer[];
-  show_dates: ShowDate[];
-  alternate_versions: AlternateVersion[];
+  other_titles?: OtherTitles;
+  version_type?: string;
+  images?: FilmImages;
+  synopsis_short?: string;
+  synopsis_long?: string;
+  distributor_id?: number;
+  distributor?: string;
+  release_dates?: ReleaseDate[];
+  age_rating?: AgeRating[];
+  duration_mins?: number;
+  review_stars?: number | string;
+  review_txt?: string;
+  trailers?: Trailers | null;
+  genres?: Genre[];
+  cast?: Cast[];
+  directors?: Director[];
+  producers?: Producer[];
+  writers?: Writer[];
+  show_dates?: ShowDate[];
+  alternate_versions?: AlternateVersion[];
   status: Status;
 };
@@ -122,19 +145,19 @@ export type CinemaDetailsResponse = {
   cinema_id: number;
   cinema_name: string;
   address: string;
-  address2: string;
+  address2?: string;
   city: string;
-  state: string;
-  county: string;
-  country: string;
+  state?: string;
+  county?: string;
+  country?: string;
   postcode: string;
-  phone: string;
+  phone?: string;
   lat: number;
   lng: number;
-  distance: number;
-  ticketing: number;
-  directions: string;
-  logo_url: string;
+  distance?: number;
+  ticketing?: number;
+  directions?: string;
+  logo_url?: string;
   show_dates: ShowDate[];
   status: Status;
 };
@@ -168,14 +191,14 @@ export type Status = {
 export type OtherTitles = Record<string, string>;
 export type ReleaseDate = {
-  release_date: string;
-  notes: string;
+  release_date?: string;
+  notes?: string;
 };
 export type AgeRating = {
-  rating: string;
-  age_rating_image: string;
-  age_advisory: string;
+  rating?: string;
+  age_rating_image?: string;
+  age_advisory?: string;
 };
 export type FilmImageSize = {
@@ -196,8 +219,8 @@ export type Still = {
 };
 export type FilmImages = {
-  poster: KeyNumberObject<Poster>;
-  still: KeyNumberObject<Still>;
+  poster?: KeyNumberObject<Poster>;
+  still?: KeyNumberObject<Still>;
 };
 export type ShowDate = {
@@ -208,10 +231,10 @@ export type Cinema = {
   cinema_id: number;
   cinema_name: string;
   address: string;
-  address2: string;
+  address2?: string;
   city: string;
-  state: string;
-  county: string;
+  state?: string;
+  county?: string;
   country?: string;
   postcode: string;
   phone?: string;
@@ -225,8 +248,8 @@ export type Cinema = {
 export type Film = {
   film_id: number;
-  imdb_id: number;
-  imdb_title_id: string;
+  imdb_id?: number;
+  imdb_title_id?: string;
   film_name: string;
   other_titles?: OtherTitles;
   release_dates: ReleaseDate[];
@@ -238,10 +261,10 @@ export type Film = {
 export type FilmComingSoon = {
   film_id: number;
-  imdb_id: number;
-  imdb_title_id: string;
+  imdb_id?: number;
+  imdb_title_id?: string;
   film_name: string;
-  other_titles: OtherTitles;
+  other_titles?: OtherTitles;
   release_dates: ReleaseDate[];
   age_rating: AgeRating[];
   film_trailer: string | null;
@@ -280,11 +303,16 @@ export type AlternateVersion = {
   version_type: string;
 };
-export type Trailer = {
-  trailer_url?: string;
+export type TrailerItem = {
+  film_trailer?: string;
   trailer_image?: string;
-  trailer_type?: string;
-  [key: string]: string | number | boolean | null | undefined;
+  version?: number;
+  quality?: string;
+  region?: string;
+};
+export type Trailers = {
+  [quality: string]: TrailerItem[];
 };
 export type ShowtimeTime = {
@@ -307,10 +335,10 @@ export type CinemaShowTimesCinema = {
 export type CinemaShowTimesFilm = {
   film_id: number;
-  imdb_id: number;
-  imdb_title_id: string;
+  imdb_id?: number;
+  imdb_title_id?: string;
   film_name: string;
-  other_titles: OtherTitles;
+  other_titles?: OtherTitles;
   version_type: string;
   age_rating: AgeRating[];
   film_image: string;
@@ -322,10 +350,10 @@ export type CinemaShowTimesFilm = {
 export type FilmShowTimesFilm = {
   film_id: number;
-  imdb_id: number;
-  imdb_title_id: string;
+  imdb_id?: number;
+  imdb_title_id?: string;
   film_name: string;
-  other_titles: OtherTitles;
+  other_titles?: OtherTitles;
   version_type: string;
   age_rating: AgeRating[];
   film_image: string;