node-csfd-api 5.6.0 → 5.6.2

package/README.md

@@ -565,16 +565,27 @@ Download `csfd-windows-x64.zip` from the [latest release](https://github.com/bar
 
 > 💡 The examples below use `csfd` (Options B, C & D). If you use npx, replace it with `npx node-csfd-api` — e.g. `npx node-csfd-api export ratings 912`.
 
-#### 1. Movie Details
+#### 1. Search
 
 ```bash
-csfd movie 535121
+csfd search tarantino
+# npx node-csfd-api search tarantino
+csfd search "blade runner" --json   # raw JSON output
+# npx node-csfd-api search "blade runner" --json
+```
+
+#### 2. Movie Details
+
+```bash
+csfd movie 535121             # by ID
 # npx node-csfd-api movie 535121
-csfd movie 535121 --json   # raw JSON output, pipe-friendly
+csfd movie "blade runner"     # by title — searches and shows the top result
+# npx node-csfd-api movie "blade runner"
+csfd movie 535121 --json      # raw JSON output, pipe-friendly
 # npx node-csfd-api movie 535121 --json
 ```
 
-#### 2. Export Ratings (CSV, JSON & Letterboxd)
+#### 3. Export Ratings (CSV, JSON & Letterboxd)
 
 > Backup your personal user ratings. _Use this tool just to keep a local copy of your data._
 

package/bin/search.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { csfd } from "../index.js";
+import { c } from "./utils.js";
+
+//#region src/bin/search.ts
+async function runSearch(query, json) {
+	const results = await csfd.search(query);
+	if (json) {
+		console.log(JSON.stringify(results, null, 2));
+		return;
+	}
+	printSearch(query, results);
+}
+function printSearch(query, results) {
+	const ratingDot = (colorRating) => colorRating === "good" ? c.green("●") : colorRating === "average" ? c.yellow("●") : colorRating === "bad" ? c.red("●") : c.dim("●");
+	const section = (label, count) => count > 0 ? `\n${c.bold(label)}  ${c.dim(`(${count})`)}` : null;
+	const total = results.movies.length + results.tvSeries.length + results.creators.length + results.users.length;
+	console.log("");
+	console.log(`${c.bold("Search results for")} ${c.cyan(`"${query}"`)}  ${c.dim(`— ${total} found`)}`);
+	console.log(c.dim("─".repeat(52)));
+	const movieLine = (r) => `  ${c.dim(String(r.id).padEnd(8))} ${ratingDot(r.colorRating)}  ${r.title}` + (r.year ? c.dim(`  ${r.year}`) : "") + (r.origins?.length ? c.dim(`  ${r.origins[0]}`) : "");
+	if (results.movies.length > 0) {
+		console.log(section("Movies", results.movies.length));
+		results.movies.forEach((r) => console.log(movieLine(r)));
+	}
+	if (results.tvSeries.length > 0) {
+		console.log(section("TV Series", results.tvSeries.length));
+		results.tvSeries.forEach((r) => console.log(movieLine(r)));
+	}
+	if (results.creators.length > 0) {
+		console.log(section("Creators", results.creators.length));
+		results.creators.forEach((r) => console.log(`  ${c.dim(String(r.id).padEnd(8))}    ${r.name}`));
+	}
+	if (results.users.length > 0) {
+		console.log(section("Users", results.users.length));
+		results.users.forEach((r) => console.log(`  ${c.dim(String(r.id).padEnd(8))}    ${r.user}` + (r.userRealName ? c.dim(`  (${r.userRealName})`) : "")));
+	}
+	if (total === 0) console.log(c.dim("  No results found."));
+	console.log("");
+}
+
+//#endregion
+export { runSearch };

package/cli.js

@@ -94,11 +94,45 @@ async function main() {
 				process.exit(1);
 			}
 			break;
+		case "search": {
+			const query = args.slice(1).filter((a) => !a.startsWith("--")).join(" ");
+			if (!query) {
+				console.error(err("Please provide a search query."));
+				console.log(c.dim(`  Usage: ${getCommandName()} search <query> [--json]`));
+				process.exit(1);
+			}
+			try {
+				const { runSearch } = await import("./bin/search.js");
+				await runSearch(query, args.includes("--json"));
+			} catch (error) {
+				console.error(err("Search failed:"), error);
+				process.exit(1);
+			}
+			break;
+		}
 		case "movie": {
-			const movieId = parseNumericArg(args[1], `${getCommandName()} movie <id> [--json]`);
+			const input = args.slice(1).filter((a) => !a.startsWith("--")).join(" ");
+			if (!input) {
+				console.error(err("Please provide a movie ID or title."));
+				console.log(c.dim(`  Usage: ${getCommandName()} movie <id|title> [--json]`));
+				process.exit(1);
+			}
+			const json = args.includes("--json");
 			try {
 				const { runMovieLookup } = await import("./bin/lookup-movie.js");
-				await runMovieLookup(movieId, args.includes("--json"));
+				const numericId = /^\d+$/.test(input) ? Number(input) : null;
+				if (numericId !== null) await runMovieLookup(numericId, json);
+				else {
+					const { csfd } = await import("./index.js");
+					const results = await csfd.search(input);
+					const first = results.movies[0] ?? results.tvSeries[0];
+					if (!first) {
+						console.error(err(`No movies found for "${input}".`));
+						process.exit(1);
+					}
+					console.log(c.dim(`  → ${first.title}${first.year ? ` (${first.year})` : ""}`));
+					await runMovieLookup(first.id, json);
+				}
 			} catch (error) {
 				console.error(err("Failed to fetch movie:"), error);
 				process.exit(1);
@@ -107,7 +141,7 @@ async function main() {
 		}
 		case "--version":
 		case "-v":
-			console.log(c.bold("5.6.0"));
+			console.log(c.bold("5.6.2"));
 			break;
 		case "update":
 			await runUpdate();
@@ -200,15 +234,15 @@ async function checkForUpdateInBackground() {
 				} catch {}
 			}
 		} catch {}
-		if (!latestVersion || compareSemver("5.6.0", latestVersion) >= 0) return;
+		if (!latestVersion || compareSemver("5.6.2", latestVersion) >= 0) return;
 		console.log("");
 		console.log(c.dim("  " + "─".repeat(44)));
-		console.log(`  ${c.yellow(c.bold("↑ Update available:"))} ${c.dim("5.6.0")} → ${c.bold(c.green(latestVersion))}`);
+		console.log(`  ${c.yellow(c.bold("↑ Update available:"))} ${c.dim("5.6.2")} → ${c.bold(c.green(latestVersion))}`);
 		console.log(`  ${c.dim("Run")} ${c.cyan(getCommandName() + " update")} ${c.dim("for upgrade instructions.")}`);
 	} catch {}
 }
 async function runUpdate() {
-	console.log(c.dim("Current version: ") + c.bold("5.6.0"));
+	console.log(c.dim("Current version: ") + c.bold("5.6.2"));
 	console.log(c.dim("Checking for updates..."));
 	let latest;
 	try {
@@ -221,7 +255,7 @@ async function runUpdate() {
 		console.error(err("Could not determine latest version."));
 		process.exit(1);
 	}
-	const cmp = compareSemver("5.6.0", latest);
+	const cmp = compareSemver("5.6.2", latest);
 	if (cmp === 0) {
 		console.log(c.green("✔ Already up to date."));
 		return;
@@ -234,7 +268,7 @@ async function runUpdate() {
 }
 function printUsage() {
 	const cmd = getCommandName();
-	const header = c.bold(c.cyan("csfd")) + " " + c.dim(`v5.6.0`);
+	const header = c.bold(c.cyan("csfd")) + " " + c.dim(`v5.6.2`);
 	const usage = c.bold("Usage:") + `  ${c.cyan(cmd)} ${c.dim("<command> [options]")}`;
 	const section = (title) => c.bold(title);
 	const cmd_ = (name) => "  " + c.cyan(name);
@@ -256,7 +290,8 @@ ${sub_("--letterboxd")}              ${desc("Letterboxd-compatible CSV")}
 ${cmd_("export reviews <userId>")}   ${desc("Export user reviews")}
 ${sub_("--csv")}                     ${desc("CSV format (default)")}
 ${sub_("--json")}                    ${desc("JSON format")}
-${cmd_("movie <id>")}                ${desc("Show movie details")}
+${cmd_("search <query>")}            ${desc("Search movies, series, creators and users")}
+${cmd_("movie <id|title>")}          ${desc("Show movie details (ID or film name)")}
 ${sub_("--json")}                    ${desc("Output raw JSON")}
 ${cmd_("update")}                    ${desc("Check for updates")}
 ${cmd_("help")}                      ${desc("Show this help")}

package/package.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 //#region package.json
 var name = "node-csfd-api";
-var version = "5.6.0";
+var version = "5.6.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.6.0",
+  "version": "5.6.2",
   "description": "ČSFD API in JavaScript. Amazing NPM library for scrapping csfd.cz :)",
   "author": "BART! <bart@bartweb.cz>",
   "publishConfig": {