node-csfd-api 5.5.0 → 5.6.0-next.2

package/bin/export-ratings.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { csfd } from "../src/index.js";
+import { csfd } from "../index.js";
 import { writeFile } from "node:fs/promises";
 
 //#region src/bin/export-ratings.ts

package/bin/mcp-server.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { csfd } from "../src/index.js";
+import { csfd } from "../index.js";
 import { name, version } from "../package.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/bin/server.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { csfd } from "../src/index.js";
+import { csfd } from "../index.js";
 import { homepage, name, version } from "../package.js";
 import "dotenv/config";
 import express from "express";

package/cli.js

@@ -1,8 +1,12 @@
 #!/usr/bin/env node
 //#region src/cli.ts
-/**
-* Main CLI entry point for node-csfd-api.
-*/
+function getCommandName() {
+	const scriptPath = process.argv[1] ?? "";
+	const basename = scriptPath.split("/").pop() ?? "";
+	if (basename === "csfd" || basename === "node-csfd-api") return basename;
+	if (scriptPath.includes("node-csfd-api")) return "npx node-csfd-api";
+	return "csfd";
+}
 async function main() {
 	const args = process.argv.slice(2);
 	switch (args[0]) {
@@ -29,7 +33,7 @@ async function main() {
 				const userId = Number(userIdRaw);
 				if (!userIdRaw || isNaN(userId)) {
 					console.error("Error: Please provide a valid numeric User ID.");
-					console.log("Usage: npx node-csfd-api export ratings <userId> [options]");
+					console.log(`Usage: ${getCommandName()} export ratings <userId> [options]`);
 					process.exit(1);
 				}
 				const isLetterboxd = args.includes("--letterboxd");
@@ -55,7 +59,7 @@ async function main() {
 				}
 			} else if (args[1] === "letterboxd") {
 				console.warn("Deprecation Warning: \"export letterboxd\" is deprecated. Please use \"export ratings <id> --letterboxd\" instead.");
-				console.log("Usage: npx node-csfd-api export ratings <userId> --letterboxd");
+				console.log(`Usage: ${getCommandName()} export ratings <userId> --letterboxd`);
 				process.exit(1);
 			} else {
 				console.error(`Unknown export target: ${args[1]}`);
@@ -63,14 +67,19 @@ async function main() {
 				process.exit(1);
 			}
 			break;
+		case "--version":
+		case "-v":
+			console.log("5.6.0-next.2");
+			break;
 		default:
 			printUsage();
 			break;
 	}
 }
 function printUsage() {
+	const cmd = getCommandName();
 	console.log(`
-Usage: npx node-csfd-api <command> [options]
+Usage: ${cmd} <command> [options]
 
 Commands:
   server, api                Start the REST API server
@@ -81,6 +90,10 @@ Commands:
       --json                 Export to JSON format
       --letterboxd           Export to Letterboxd-compatible CSV format
   help                       Show this help message
+
+Flags:
+  --version, -v              Show version
+  --help, -h                 Show this help message
 `);
 }
 main().catch((error) => {

package/package.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 //#region package.json
 var name = "node-csfd-api";
-var version = "5.5.0";
+var version = "5.6.0-next.2";
 var homepage = "https://github.com/bartholomej/node-csfd-api#readme";
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-csfd-api",
-  "version": "5.5.0",
+  "version": "5.6.0-next.2",
   "description": "ČSFD API in JavaScript. Amazing NPM library for scrapping csfd.cz :)",
   "author": "BART! <bart@bartweb.cz>",
   "publishConfig": {
@@ -63,6 +63,9 @@
     },
     "./package.json": "./package.json"
   },
-  "bin": "cli.js",
+  "bin": {
+    "csfd": "cli.js",
+    "node-csfd-api": "cli.js"
+  },
   "sideEffects": false
 }

package/src/fetchers/fetch.polyfill.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-//#region src/fetchers/fetch.polyfill.ts
-const fetchSafe = typeof fetch === "function" && fetch || typeof global === "object" && global.fetch || typeof window !== "undefined" && window.fetch;
-
-//#endregion
-export { fetchSafe };

package/src/fetchers/index.js

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-import { fetchSafe } from "./fetch.polyfill.js";
-
-//#region src/fetchers/index.ts
-const browserProfiles = [
-	{
-		"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
-		"Sec-Ch-Ua": "\"Google Chrome\";v=\"131\", \"Chromium\";v=\"131\", \"Not_A Brand\";v=\"24\"",
-		"Sec-Ch-Ua-Platform": "\"Windows\""
-	},
-	{
-		"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
-		"Sec-Ch-Ua": "\"Google Chrome\";v=\"130\", \"Chromium\";v=\"130\", \"Not_A Brand\";v=\"24\"",
-		"Sec-Ch-Ua-Platform": "\"Windows\""
-	},
-	{
-		"User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
-		"Sec-Ch-Ua": "\"Google Chrome\";v=\"131\", \"Chromium\";v=\"131\", \"Not_A Brand\";v=\"24\"",
-		"Sec-Ch-Ua-Platform": "\"macOS\""
-	},
-	{
-		"User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
-		"Sec-Ch-Ua": "\"Google Chrome\";v=\"130\", \"Chromium\";v=\"130\", \"Not_A Brand\";v=\"24\"",
-		"Sec-Ch-Ua-Platform": "\"macOS\""
-	},
-	{
-		"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36 Edg/131.0.0.0",
-		"Sec-Ch-Ua": "\"Microsoft Edge\";v=\"131\", \"Chromium\";v=\"131\", \"Not_A Brand\";v=\"24\"",
-		"Sec-Ch-Ua-Platform": "\"Windows\""
-	},
-	{
-		"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36 Edg/130.0.0.0",
-		"Sec-Ch-Ua": "\"Microsoft Edge\";v=\"130\", \"Chromium\";v=\"130\", \"Not_A Brand\";v=\"24\"",
-		"Sec-Ch-Ua-Platform": "\"Windows\""
-	}
-];
-const randomProfile = () => browserProfiles[Math.floor(Math.random() * browserProfiles.length)];
-const baseHeaders = {
-	Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
-	"Accept-Language": "cs-CZ,cs;q=0.9,en-US;q=0.8,en;q=0.7",
-	"Accept-Encoding": "gzip, deflate, br",
-	"Cache-Control": "max-age=0",
-	Connection: "keep-alive",
-	"Sec-Ch-Ua-Mobile": "?0",
-	"Sec-Fetch-Dest": "document",
-	"Sec-Fetch-Mode": "navigate",
-	"Sec-Fetch-Site": "none",
-	"Sec-Fetch-User": "?1",
-	"Upgrade-Insecure-Requests": "1"
-};
-const fetchPage = async (url, optionsRequest) => {
-	try {
-		const mergedHeaders = new Headers({
-			...baseHeaders,
-			...randomProfile()
-		});
-		if (optionsRequest?.headers) new Headers(optionsRequest.headers).forEach((value, key) => mergedHeaders.set(key, value));
-		const { headers: _, ...restOptions } = optionsRequest || {};
-		const response = await fetchSafe(url, {
-			credentials: "omit",
-			...restOptions,
-			headers: mergedHeaders
-		});
-		if (!response.ok) throw new Error(`node-csfd-api: Bad response ${response.status} for url: ${url}`);
-		const html = await response.text();
-		if (html.includes("Making sure you're not a bot!")) console.warn("node-csfd-api: Trap detected.");
-		return html;
-	} catch (e) {
-		if (e instanceof Error) console.error(e.message);
-		else console.error(String(e));
-		return "Error";
-	}
-};
-
-//#endregion
-export { fetchPage };

package/src/helpers/cinema.helper.js

@@ -1,80 +0,0 @@
-#!/usr/bin/env node
-import { parseColor, parseIdFromUrl } from "./global.helper.js";
-
-//#region src/helpers/cinema.helper.ts
-const getCinemaColorRating = (el) => {
-	const classes = el?.classNames.split(" ") ?? [];
-	const last = classes.length ? classes[classes.length - 1] : void 0;
-	return last ? parseColor(last) : "unknown";
-};
-const getCinemaId = (el) => {
-	return +el?.id?.split("-")[1];
-};
-const getCinemaUrlId = (url) => {
-	if (!url) return null;
-	return parseIdFromUrl(url);
-};
-const getCinemaCoords = (el) => {
-	if (!el) return null;
-	const linkMapsEl = el.querySelector("a[href*=\"q=\"]");
-	if (!linkMapsEl) return null;
-	const [_, latLng] = linkMapsEl.getAttribute("href").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;
-};
-const getCinemaUrl = (el) => {
-	if (!el) return "";
-	return el.querySelector(".cinema-logo a")?.attributes.href ?? "";
-};
-const parseCinema = (el) => {
-	const [city, name] = el.querySelector("header h2").innerText.trim().split(" - ");
-	return {
-		city,
-		name
-	};
-};
-const getGroupedFilmsByDate = (el) => {
-	const divs = el.querySelectorAll(":scope > div");
-	return divs.map((_, index) => index).filter((index) => index % 2 === 0).map((index) => {
-		const [date, films] = divs.slice(index, index + 2);
-		return {
-			date: date?.firstChild?.textContent?.trim() ?? null,
-			films: getCinemaFilms("", films)
-		};
-	});
-};
-const getCinemaFilms = (date, el) => {
-	return el.querySelectorAll(".cinema-table tr").map((filmNode) => {
-		const url = filmNode.querySelector("td.name h3 a")?.attributes.href;
-		const id = url ? getCinemaUrlId(url) : null;
-		const title = filmNode.querySelector(".name h3")?.text.trim();
-		const colorRating = getCinemaColorRating(filmNode.querySelector(".name .icon"));
-		const showTimes = filmNode.querySelectorAll(".td-time")?.map((x) => x.textContent.trim());
-		const meta = filmNode.querySelectorAll(".td-title span")?.map((x) => x.text.trim());
-		return {
-			id,
-			title,
-			url,
-			colorRating,
-			showTimes,
-			meta: parseMeta(meta)
-		};
-	});
-};
-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;
-};
-
-//#endregion
-export { getCinemaCoords, getCinemaId, getCinemaUrl, getGroupedFilmsByDate, parseCinema };

package/src/helpers/creator.helper.js

@@ -1,69 +0,0 @@
-#!/usr/bin/env node
-import { addProtocol, parseColor, parseDate, parseIdFromUrl } from "./global.helper.js";
-
-//#region src/helpers/creator.helper.ts
-const getCreatorColorRating = (el) => {
-	const classes = el?.classNames.split(" ") ?? [];
-	const last = classes[classes.length - 1];
-	return parseColor(last);
-};
-const getCreatorId = (url) => {
-	return url ? parseIdFromUrl(url) : null;
-};
-const getCreatorName = (el) => {
-	return (el?.querySelector("h1"))?.innerText?.trim() ?? null;
-};
-const getCreatorBirthdayInfo = (el) => {
-	const infoBlock = el?.querySelector(".creator-profile-details p");
-	const text = infoBlock?.innerHTML.trim();
-	const birthPlaceRow = infoBlock?.querySelector(".info-place")?.innerText.trim();
-	const ageRow = infoBlock?.querySelector(".info")?.innerText.trim();
-	let birthday = null;
-	if (text) {
-		const birthdayRow = text.split("\n").find((x) => x.includes("nar."));
-		birthday = birthdayRow ? parseDate(parseBirthday(birthdayRow)) : null;
-	}
-	const age = ageRow ? +parseAge(ageRow) : null;
-	const birthPlace = birthPlaceRow ? parseBirthPlace(birthPlaceRow) : "";
-	return {
-		birthday,
-		age,
-		birthPlace
-	};
-};
-const getCreatorBio = (el) => {
-	return (el?.querySelector(".article-content p"))?.text?.trim().split("\n")[0]?.trim() || null;
-};
-const getCreatorPhoto = (el) => {
-	const src = el?.querySelector("img")?.getAttribute("src");
-	return src ? addProtocol(src) : null;
-};
-const parseBirthday = (text) => text.replace(/nar\./g, "").trim();
-const parseAge = (text) => {
-	const digits = text.replace(/[^\d]/g, "");
-	return digits ? Number(digits) : null;
-};
-const parseBirthPlace = (text) => text.trim().replace(/<br>/g, "").trim();
-const getCreatorFilms = (el) => {
-	const filmNodes = el?.querySelector(".updated-box")?.querySelectorAll("table tr") ?? [];
-	let yearCache = null;
-	return filmNodes.map((filmNode) => {
-		const id = getCreatorId(filmNode.querySelector("td.name .film-title-name")?.attributes?.href);
-		const title = filmNode.querySelector(".name")?.text?.trim();
-		const yearText = filmNode.querySelector(".year")?.text?.trim();
-		const year = yearText ? +yearText : null;
-		const colorRating = getCreatorColorRating(filmNode.querySelector(".name .icon"));
-		if (typeof year === "number" && !isNaN(year)) yearCache = +year;
-		const finalYear = year ?? yearCache;
-		if (id != null && title && finalYear != null) return {
-			id,
-			title,
-			year: finalYear,
-			colorRating
-		};
-		return null;
-	}).filter(Boolean);
-};
-
-//#endregion
-export { getCreatorBio, getCreatorBirthdayInfo, getCreatorFilms, getCreatorName, getCreatorPhoto };

package/src/helpers/global.helper.js

@@ -1,101 +0,0 @@
-#!/usr/bin/env node
-//#region src/helpers/global.helper.ts
-const LANG_PREFIX_REGEX = /^[a-z]{2,3}$/;
-const ISO8601_DURATION_REGEX = /(-)?P(?:([.,\d]+)Y)?(?:([.,\d]+)M)?(?:([.,\d]+)W)?(?:([.,\d]+)D)?T(?:([.,\d]+)H)?(?:([.,\d]+)M)?(?:([.,\d]+)S)?/;
-const parseIdFromUrl = (url) => {
-	if (!url) return null;
-	const parts = url.split("/");
-	const idParts = parts.filter((p) => /^\d+-/.test(p));
-	if (idParts.length > 0) return +idParts[idParts.length - 1].split("-")[0] || null;
-	return +parts[LANG_PREFIX_REGEX.test(parts[1]) ? 3 : 2]?.split("-")[0] || null;
-};
-const parseLastIdFromUrl = (url) => {
-	if (url) return +(url?.split("/")[3])?.split("-")[0] || null;
-	else return null;
-};
-const PAGE_COLORS = {
-	"page-lightgrey": "unknown",
-	"page-red": "good",
-	"page-blue": "average",
-	"page-grey": "bad"
-};
-const getColor = (cls) => {
-	return PAGE_COLORS[cls] || "unknown";
-};
-const RATING_COLORS = {
-	lightgrey: "unknown",
-	red: "good",
-	blue: "average",
-	grey: "bad"
-};
-const parseColor = (quality) => {
-	return RATING_COLORS[quality] || "unknown";
-};
-const FILM_TYPES = {
-	"TV film": "tv-film",
-	pořad: "tv-show",
-	seriál: "series",
-	"divadelní záznam": "theatrical",
-	koncert: "concert",
-	série: "season",
-	"studentský film": "student-film",
-	"amatérský film": "amateur-film",
-	"hudební videoklip": "music-video",
-	epizoda: "episode",
-	"video kompilace": "video-compilation",
-	film: "film"
-};
-const parseFilmType = (type) => {
-	return FILM_TYPES[type] || "film";
-};
-const addProtocol = (url) => {
-	return url.startsWith("//") ? "https:" + url : url;
-};
-const getDuration = (matches) => {
-	return {
-		sign: matches[1] === void 0 ? "+" : "-",
-		years: matches[2] === void 0 ? 0 : matches[2],
-		months: matches[3] === void 0 ? 0 : matches[3],
-		weeks: matches[4] === void 0 ? 0 : matches[4],
-		days: matches[5] === void 0 ? 0 : matches[5],
-		hours: matches[6] === void 0 ? 0 : matches[6],
-		minutes: matches[7] === void 0 ? 0 : matches[7],
-		seconds: matches[8] === void 0 ? 0 : matches[8]
-	};
-};
-const parseISO8601Duration = (iso) => {
-	const duration = getDuration(iso.match(ISO8601_DURATION_REGEX));
-	return +duration.hours * 60 + +duration.minutes;
-};
-/**
-* Parses a date string into a standardized YYYY-MM-DD format.
-* Supports:
-* - D.M.YYYY
-* - DD.MM.YYYY
-* - D. M. YYYY
-* - MM/DD/YYYY
-* - YYYY
-*/
-const parseDate = (date) => {
-	if (!date) return null;
-	const cleanDate = date.trim();
-	const dateMatch = cleanDate.match(/^(\d{1,2})\.\s*(\d{1,2})\.\s*(\d{4})$/);
-	if (dateMatch) {
-		const day = dateMatch[1].padStart(2, "0");
-		const month = dateMatch[2].padStart(2, "0");
-		return `${dateMatch[3]}-${month}-${day}`;
-	}
-	const slashMatch = cleanDate.match(/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/);
-	if (slashMatch) {
-		const month = slashMatch[1].padStart(2, "0");
-		const day = slashMatch[2].padStart(2, "0");
-		return `${slashMatch[3]}-${month}-${day}`;
-	}
-	const yearMatch = cleanDate.match(/^(\d{4})$/);
-	if (yearMatch) return `${yearMatch[1]}-01-01`;
-	return null;
-};
-const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
-
-//#endregion
-export { addProtocol, getColor, parseColor, parseDate, parseFilmType, parseISO8601Duration, parseIdFromUrl, parseLastIdFromUrl, sleep };