node-csfd-api 2.13.1 → 2.14.1

package/helpers/cinema.helper.d.ts

@@ -0,0 +1,18 @@
+import { HTMLElement } from 'node-html-parser';
+import { CSFDColorRating } from '../interfaces/global';
+import { CSFDCinemaGroupedFilmsByDate, CSFDCinemaMeta, CSFDCinemaMovie } from './../interfaces/cinema.interface';
+export declare const getColorRating: (el: HTMLElement) => CSFDColorRating;
+export declare const getCinemaId: (el: HTMLElement | null) => number;
+export declare const getId: (url: string) => number | null;
+export declare const getCoords: (el: HTMLElement | null) => {
+    lat: number;
+    lng: number;
+} | null;
+export declare const getCinemaUrl: (el: HTMLElement | null) => string;
+export declare const parseCinema: (el: HTMLElement | null) => {
+    city: string;
+    name: string;
+};
+export declare const getGroupedFilmsByDate: (el: HTMLElement | null) => CSFDCinemaGroupedFilmsByDate[];
+export declare const getFilms: (date: string, el: HTMLElement | null) => CSFDCinemaMovie[];
+export declare const parseMeta: (meta: string[]) => CSFDCinemaMeta[];

package/helpers/cinema.helper.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMeta = exports.getFilms = exports.getGroupedFilmsByDate = exports.parseCinema = exports.getCinemaUrl = exports.getCoords = exports.getId = exports.getCinemaId = exports.getColorRating = void 0;
+const global_helper_1 = require("./global.helper");
+const getColorRating = (el) => {
+    return (0, global_helper_1.parseColor)(el === null || el === void 0 ? void 0 : el.classNames.split(' ').pop());
+};
+exports.getColorRating = getColorRating;
+const getCinemaId = (el) => {
+    var _a;
+    const id = (_a = el === null || el === void 0 ? void 0 : el.id) === null || _a === void 0 ? void 0 : _a.split('-')[1];
+    return +id;
+};
+exports.getCinemaId = getCinemaId;
+const getId = (url) => {
+    if (url) {
+        return (0, global_helper_1.parseIdFromUrl)(url);
+    }
+    return null;
+};
+exports.getId = getId;
+const getCoords = (el) => {
+    if (!el)
+        return null;
+    const linkMapsEl = el.querySelector('a[href*="q="]');
+    if (!linkMapsEl)
+        return null;
+    const linkMaps = linkMapsEl.getAttribute('href');
+    const [_, latLng] = linkMaps.split('q=');
+    const coords = latLng.split(',');
+    if (coords.length !== 2)
+        return null;
+    const lat = Number(coords[0]);
+    const lng = Number(coords[1]);
+    if (Number.isFinite(lat) && Number.isFinite(lng)) {
+        return { lat, lng };
+    }
+    return null;
+};
+exports.getCoords = getCoords;
+const getCinemaUrl = (el) => {
+    var _a, _b;
+    if (!el)
+        return '';
+    return (_b = (_a = el.querySelector('a[title="Přejít na webovou stránku kina"]')) === null || _a === void 0 ? void 0 : _a.attributes.href) !== null && _b !== void 0 ? _b : '';
+};
+exports.getCinemaUrl = getCinemaUrl;
+const parseCinema = (el) => {
+    const title = el.querySelector('.box-header h2').innerText.trim();
+    const [city, name] = title.split(' - ');
+    return { city, name };
+};
+exports.parseCinema = parseCinema;
+const getGroupedFilmsByDate = (el) => {
+    const divs = el.querySelectorAll(':scope > div');
+    const getDatesAndFilms = divs
+        .map((_, index) => index)
+        .filter((index) => index % 2 === 0)
+        .map((index) => {
+        var _a, _b, _c;
+        const [date, films] = divs.slice(index, index + 2);
+        const dateText = (_c = (_b = (_a = date === null || date === void 0 ? void 0 : date.firstChild) === null || _a === void 0 ? void 0 : _a.textContent) === null || _b === void 0 ? void 0 : _b.trim()) !== null && _c !== void 0 ? _c : null;
+        return { date: dateText, films: (0, exports.getFilms)('', films) };
+    });
+    return getDatesAndFilms;
+};
+exports.getGroupedFilmsByDate = getGroupedFilmsByDate;
+const getFilms = (date, el) => {
+    const filmNodes = el.querySelectorAll('.cinema-table tr');
+    const films = filmNodes.map((filmNode) => {
+        var _a, _b, _c, _d;
+        const url = (_a = filmNode.querySelector('td.name h3 a')) === null || _a === void 0 ? void 0 : _a.attributes.href;
+        const id = (0, exports.getId)(url);
+        const title = (_b = filmNode.querySelector('.name h3')) === null || _b === void 0 ? void 0 : _b.text.trim();
+        const colorRating = (0, exports.getColorRating)(filmNode.querySelector('.name .icon'));
+        const showTimes = (_c = filmNode.querySelectorAll('.td-time')) === null || _c === void 0 ? void 0 : _c.map((x) => x.textContent.trim());
+        const meta = (_d = filmNode.querySelectorAll('.td-title span')) === null || _d === void 0 ? void 0 : _d.map((x) => x.text.trim());
+        return {
+            id,
+            title,
+            url,
+            colorRating,
+            showTimes,
+            meta: (0, exports.parseMeta)(meta)
+        };
+    });
+    return films;
+};
+exports.getFilms = getFilms;
+const parseMeta = (meta) => {
+    const metaConvert = [];
+    for (const element of meta) {
+        if (element === 'T') {
+            metaConvert.push('subtitles');
+        }
+        else if (element === 'D') {
+            metaConvert.push('dubbing');
+        }
+        else {
+            metaConvert.push(element);
+        }
+    }
+    return metaConvert;
+};
+exports.parseMeta = parseMeta;

package/index.d.ts

@@ -1,7 +1,9 @@
+import { CSFDCinema, CSFDCinemaPeriod } from './interfaces/cinema.interface';
 import { CSFDCreator } from './interfaces/creator.interface';
 import { CSFDMovie } from './interfaces/movie.interface';
 import { CSFDSearch } from './interfaces/search.interface';
 import { CSFDUserRatingConfig, CSFDUserRatings } from './interfaces/user-ratings.interface';
+import { CinemaScraper } from './services/cinema.service';
 import { CreatorScraper } from './services/creator.service';
 import { MovieScraper } from './services/movie.service';
 import { SearchScraper } from './services/search.service';
@@ -11,10 +13,12 @@ export declare class Csfd {
     private movieService;
     private creatorService;
     private searchService;
-    constructor(userRatingsService: UserRatingsScraper, movieService: MovieScraper, creatorService: CreatorScraper, searchService: SearchScraper);
+    private cinemaService;
+    constructor(userRatingsService: UserRatingsScraper, movieService: MovieScraper, creatorService: CreatorScraper, searchService: SearchScraper, cinemaService: CinemaScraper);
     userRatings(user: string | number, config?: CSFDUserRatingConfig): Promise<CSFDUserRatings[]>;
     movie(movie: number): Promise<CSFDMovie>;
     creator(creator: number): Promise<CSFDCreator>;
     search(text: string): Promise<CSFDSearch>;
+    cinema(district: number | string, period: CSFDCinemaPeriod): Promise<CSFDCinema[]>;
 }
 export declare const csfd: Csfd;

package/index.js

@@ -1,16 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.csfd = exports.Csfd = void 0;
+const cinema_service_1 = require("./services/cinema.service");
 const creator_service_1 = require("./services/creator.service");
 const movie_service_1 = require("./services/movie.service");
 const search_service_1 = require("./services/search.service");
 const user_ratings_service_1 = require("./services/user-ratings.service");
 class Csfd {
-    constructor(userRatingsService, movieService, creatorService, searchService) {
+    constructor(userRatingsService, movieService, creatorService, searchService, cinemaService) {
         this.userRatingsService = userRatingsService;
         this.movieService = movieService;
         this.creatorService = creatorService;
         this.searchService = searchService;
+        this.cinemaService = cinemaService;
     }
     async userRatings(user, config) {
         return this.userRatingsService.userRatings(user, config);
@@ -24,10 +26,14 @@ class Csfd {
     async search(text) {
         return this.searchService.search(text);
     }
+    async cinema(district, period) {
+        return this.cinemaService.cinemas(+district, period);
+    }
 }
 exports.Csfd = Csfd;
 const movieScraper = new movie_service_1.MovieScraper();
 const userRatingsScraper = new user_ratings_service_1.UserRatingsScraper();
+const cinemaScraper = new cinema_service_1.CinemaScraper();
 const creatorScraper = new creator_service_1.CreatorScraper();
 const searchScraper = new search_service_1.SearchScraper();
-exports.csfd = new Csfd(userRatingsScraper, movieScraper, creatorScraper, searchScraper);
+exports.csfd = new Csfd(userRatingsScraper, movieScraper, creatorScraper, searchScraper, cinemaScraper);

package/interfaces/cinema.interface.d.ts

@@ -0,0 +1,23 @@
+import { CSFDMovieListItem } from './movie.interface';
+export interface CSFDCinema {
+    id: number;
+    name: string;
+    city: string;
+    url: string;
+    coords: {
+        lat: number;
+        lng: number;
+    };
+    region?: string;
+    screenings: CSFDCinemaGroupedFilmsByDate[];
+}
+export interface CSFDCinemaGroupedFilmsByDate {
+    date: string;
+    films: CSFDCinemaMovie[];
+}
+export interface CSFDCinemaMovie extends CSFDMovieListItem {
+    meta: CSFDCinemaMeta[];
+    showTimes: string[];
+}
+export type CSFDCinemaMeta = 'dubbing' | '3D' | 'subtitles' | string;
+export type CSFDCinemaPeriod = 'today' | 'weekend' | 'week' | 'tomorrow' | 'month';

package/interfaces/cinema.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-csfd-api",
-  "version": "2.13.1",
+  "version": "2.14.1",
   "description": "ČSFD API in JavaScript. Amazing NPM library for scrapping csfd.cz :)",
   "main": "./index.js",
   "author": "BART! <bart@bartweb.cz>",

package/services/cinema.service.d.ts

@@ -0,0 +1,6 @@
+import { CSFDCinema, CSFDCinemaPeriod } from '../interfaces/cinema.interface';
+export declare class CinemaScraper {
+    private cinema;
+    cinemas(district?: number, period?: CSFDCinemaPeriod): Promise<CSFDCinema[]>;
+    private buildCinemas;
+}

package/services/cinema.service.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CinemaScraper = void 0;
+const node_html_parser_1 = require("node-html-parser");
+const fetchers_1 = require("../fetchers");
+const vars_1 = require("../vars");
+const cinema_helper_1 = require("./../helpers/cinema.helper");
+class CinemaScraper {
+    async cinemas(district = 1, period = 'today') {
+        const url = (0, vars_1.cinemasUrl)(district, period);
+        const response = await (0, fetchers_1.fetchPage)(url);
+        const cinemasHtml = (0, node_html_parser_1.parse)(response);
+        const contentNode = cinemasHtml.querySelectorAll('#snippet--cinemas section.box');
+        this.buildCinemas(contentNode);
+        return this.cinema;
+    }
+    buildCinemas(contentNode) {
+        const cinemas = [];
+        contentNode.forEach((x) => {
+            const cinemaInfo = (0, cinema_helper_1.parseCinema)(x);
+            const cinema = {
+                id: (0, cinema_helper_1.getCinemaId)(x),
+                name: cinemaInfo === null || cinemaInfo === void 0 ? void 0 : cinemaInfo.name,
+                city: cinemaInfo === null || cinemaInfo === void 0 ? void 0 : cinemaInfo.city,
+                url: (0, cinema_helper_1.getCinemaUrl)(x),
+                coords: (0, cinema_helper_1.getCoords)(x),
+                screenings: (0, cinema_helper_1.getGroupedFilmsByDate)(x)
+            };
+            cinemas.push(cinema);
+        });
+        this.cinema = cinemas;
+    }
+}
+exports.CinemaScraper = CinemaScraper;

package/services/creator.service.js

@@ -7,7 +7,11 @@ const creator_helper_1 = require("../helpers/creator.helper");
 const vars_1 = require("../vars");
 class CreatorScraper {
     async creator(creatorId) {
-        const url = (0, vars_1.creatorUrl)(+creatorId);
+        const id = Number(creatorId);
+        if (isNaN(id)) {
+            throw new Error('node-csfd-api: creatorId must be a valid number');
+        }
+        const url = (0, vars_1.creatorUrl)(id);
         const response = await (0, fetchers_1.fetchPage)(url);
         const creatorHtml = (0, node_html_parser_1.parse)(response);
         const asideNode = creatorHtml.querySelector('.creator-about');

package/services/movie.service.js

@@ -7,7 +7,11 @@ const movie_helper_1 = require("../helpers/movie.helper");
 const vars_1 = require("../vars");
 class MovieScraper {
     async movie(movieId) {
-        const url = (0, vars_1.movieUrl)(+movieId);
+        const id = Number(movieId);
+        if (isNaN(id)) {
+            throw new Error('node-csfd-api: movieId must be a valid number');
+        }
+        const url = (0, vars_1.movieUrl)(id);
         const response = await (0, fetchers_1.fetchPage)(url);
         const movieHtml = (0, node_html_parser_1.parse)(response);
         const pageClasses = movieHtml.querySelector('.page-content').classNames.split(' ');

package/services/search.service.js

@@ -21,7 +21,7 @@ class SearchScraper {
         const movies = [];
         const users = [];
         const tvSeries = [];
-        moviesNode.map((m) => {
+        moviesNode.forEach((m) => {
             const url = (0, search_helper_1.getUrl)(m);
             const movie = {
                 id: (0, global_helper_1.parseIdFromUrl)(url),
@@ -39,7 +39,7 @@ class SearchScraper {
             };
             movies.push(movie);
         });
-        usersNode.map((m) => {
+        usersNode.forEach((m) => {
             const url = (0, search_user_helper_1.getUserUrl)(m);
             const user = {
                 id: (0, global_helper_1.parseIdFromUrl)(url),
@@ -50,7 +50,7 @@ class SearchScraper {
             };
             users.push(user);
         });
-        tvSeriesNode.map((m) => {
+        tvSeriesNode.forEach((m) => {
             const url = (0, search_helper_1.getUrl)(m);
             const user = {
                 id: (0, global_helper_1.parseIdFromUrl)(url),

package/vars.d.ts

@@ -1,4 +1,6 @@
+import { CSFDCinemaPeriod } from './interfaces/cinema.interface';
 export declare const userRatingsUrl: (user: string | number, page?: number) => string;
 export declare const movieUrl: (movie: number) => string;
 export declare const creatorUrl: (creator: number | string) => string;
+export declare const cinemasUrl: (district: number | string, period: CSFDCinemaPeriod) => string;
 export declare const searchUrl: (text: string) => string;

package/vars.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.searchUrl = exports.creatorUrl = exports.movieUrl = exports.userRatingsUrl = void 0;
+exports.searchUrl = exports.cinemasUrl = exports.creatorUrl = exports.movieUrl = exports.userRatingsUrl = void 0;
 const userRatingsUrl = (user, page) => `https://www.csfd.cz/uzivatel/${encodeURIComponent(user)}/hodnoceni/${page ? '?page=' + page : ''}`;
 exports.userRatingsUrl = userRatingsUrl;
 const movieUrl = (movie) => `https://www.csfd.cz/film/${encodeURIComponent(movie)}/prehled/`;
 exports.movieUrl = movieUrl;
 const creatorUrl = (creator) => `https://www.csfd.cz/tvurce/${encodeURIComponent(creator)}`;
 exports.creatorUrl = creatorUrl;
+const cinemasUrl = (district, period) => {
+    return `https://www.csfd.cz/kino/?period=${period}&district=${district}`;
+};
+exports.cinemasUrl = cinemasUrl;
 const searchUrl = (text) => `https://www.csfd.cz/hledat/?q=${encodeURIComponent(text)}`;
 exports.searchUrl = searchUrl;