wyzie-lib 2.2.6 → 2.2.8

package/LICENSE

@@ -1,7 +1,7 @@
-Copyright 2024 Bad Developer
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
+Copyright 2024 Bad Developer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
 THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,9 +1,9 @@
-<p align="center">
-  <a href="https://sub.wyzie.ru/">
-    <img src="https://i.postimg.cc/L5ppKYC5/cclogo.png" height="120">
-    <h1 align="center">Wyzie Lib</h1>
-  </a>
-</p>
-
-Wyzie Lib is a package made for easily implementing [Wyzie Subs](https://sub.wyzie.ru) into your
-project without all the fuss. [Read the docs](https://docs.wyzie.ru/subs/usage/package).
+<p align="center">
+  <a href="https://sub.wyzie.ru/">
+    <img src="https://i.postimg.cc/L5ppKYC5/cclogo.png" height="120">
+    <h1 align="center">Wyzie Lib</h1>
+  </a>
+</p>
+
+Wyzie Lib is a package made for easily implementing [Wyzie Subs](https://sub.wyzie.ru) into your
+project without all the fuss. [Read the docs](https://docs.wyzie.ru/subs/usage/package).

package/lib/main.amd.js

@@ -110,8 +110,37 @@ ${textLines.join("\n")}
       throw error;
     }
   }
+  async function searchTmdb(query, language = "en-US") {
+    const url = new URL(`${config.baseUrl}/api/tmdb/search`);
+    url.searchParams.append("q", query);
+    url.searchParams.append("language", language);
+    const response = await fetch(url.toString());
+    if (!response.ok) {
+      throw new Error(`Failed to search TMDB: ${response.status}`);
+    }
+    return response.json();
+  }
+  async function getTvDetails(id) {
+    const url = `${config.baseUrl}/api/tmdb/tv/${id}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch TV details: ${response.status}`);
+    }
+    return response.json();
+  }
+  async function getSeasonDetails(id, season) {
+    const url = `${config.baseUrl}/api/tmdb/tv/${id}/${season}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch season details: ${response.status}`);
+    }
+    return response.json();
+  }
   exports.configure = configure;
+  exports.getSeasonDetails = getSeasonDetails;
+  exports.getTvDetails = getTvDetails;
   exports.parseToVTT = parseToVTT;
   exports.searchSubtitles = searchSubtitles;
+  exports.searchTmdb = searchTmdb;
   Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 });

package/lib/main.cjs

@@ -110,6 +110,35 @@ ${textLines.join("\n")}
     throw error;
   }
 }
+async function searchTmdb(query, language = "en-US") {
+  const url = new URL(`${config.baseUrl}/api/tmdb/search`);
+  url.searchParams.append("q", query);
+  url.searchParams.append("language", language);
+  const response = await fetch(url.toString());
+  if (!response.ok) {
+    throw new Error(`Failed to search TMDB: ${response.status}`);
+  }
+  return response.json();
+}
+async function getTvDetails(id) {
+  const url = `${config.baseUrl}/api/tmdb/tv/${id}`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch TV details: ${response.status}`);
+  }
+  return response.json();
+}
+async function getSeasonDetails(id, season) {
+  const url = `${config.baseUrl}/api/tmdb/tv/${id}/${season}`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch season details: ${response.status}`);
+  }
+  return response.json();
+}
 exports.configure = configure;
+exports.getSeasonDetails = getSeasonDetails;
+exports.getTvDetails = getTvDetails;
 exports.parseToVTT = parseToVTT;
 exports.searchSubtitles = searchSubtitles;
+exports.searchTmdb = searchTmdb;

package/lib/main.d.ts

@@ -14,6 +14,42 @@ export declare type ConfigurationOptions = {
  */
 export declare function configure(options: ConfigurationOptions): void;
 
+/**
+ * Details of a TV Episode.
+ */
+export declare type EpisodeDetails = {
+    air_date?: string;
+    episode_number: number;
+    id: number;
+    name: string;
+    overview?: string;
+    production_code?: string;
+    runtime?: number | null;
+    season_number: number;
+    show_id?: number;
+    still_path?: string | null;
+    vote_average?: number;
+    vote_count?: number;
+    [key: string]: any;
+};
+
+/**
+ * Fetches details for a specific season of a TV show from TMDB.
+ *
+ * @param {number} id - The TMDB ID of the TV show.
+ * @param {number} season - The season number.
+ * @returns {Promise<SeasonDetails>} A promise that resolves to the season details.
+ */
+export declare function getSeasonDetails(id: number, season: number): Promise<SeasonDetails>;
+
+/**
+ * Fetches details for a TV show from TMDB.
+ *
+ * @param {number} id - The TMDB ID of the TV show.
+ * @returns {Promise<TvDetails>} A promise that resolves to the TV show details.
+ */
+export declare function getTvDetails(id: number): Promise<TvDetails>;
+
 /**
  * Parses subtitle content from a URL to VTT format.
  *
@@ -43,6 +79,10 @@ export declare type QueryParams = {
     hi?: boolean;
     /** The source where the subtitle will be scraped from. */
     source?: string;
+    /** Filter by specific release group or name. */
+    release?: string;
+    /** Filter by filename. */
+    filename?: string;
 };
 
 /**
@@ -79,6 +119,10 @@ export declare type SearchSubtitlesParams = (
     hi?: boolean;
     /** The source where the subtitle will be scraped. Accepts a single value or a list. */
     source?: string | string[];
+    /** Filter by specific release group or name. */
+    release?: string | string[];
+    /** Filter by filename. */
+    filename?: string | string[];
     /** Additional parameters that can be used for filtering or other purposes. */
     [key: string]: any;
 } & (
@@ -93,6 +137,38 @@ export declare type SearchSubtitlesParams = (
     episode?: never;
 });
 
+/**
+ * Searches TMDB for movies or TV shows.
+ *
+ * @param {string} query - The search query.
+ * @param {string} [language] - Optional language code (default: en-US).
+ * @returns {Promise<TmdbSearchResult[]>} A promise that resolves to an array of TMDB search results.
+ */
+export declare function searchTmdb(query: string, language?: string): Promise<TmdbSearchResult[]>;
+
+/**
+ * Details of a specific TV Season.
+ */
+export declare type SeasonDetails = {
+    episodes: EpisodeDetails[];
+    season_number: number;
+    id: string;
+};
+
+/**
+ * Summary of a TV season.
+ */
+export declare type SeasonSummary = {
+    air_date?: string;
+    episode_count?: number;
+    id: number;
+    name: string;
+    overview?: string;
+    poster_path?: string | null;
+    season_number: number;
+    vote_average?: number;
+};
+
 /**
  * Data structure representing a single subtitle object.
  */
@@ -117,6 +193,42 @@ export declare type SubtitleData = {
     language: string;
     /** The subtitle's source (ex: subdl, subf2m, opensubtitles). */
     source?: string | string[];
+    /** The release name of the subtitle. */
+    release?: string;
+    /** List of releases compatible with this subtitle. */
+    releases?: string[];
+    /** The original filename of the subtitle. */
+    fileName?: string;
+    /** The origin of the subtitle (e.g. DVD, WEB, BluRay). */
+    origin?: string;
+};
+
+/**
+ * Result object from a TMDB search.
+ */
+export declare type TmdbSearchResult = {
+    id: number;
+    media_type: string;
+    title?: string;
+    name?: string;
+    original_title?: string;
+    original_name?: string;
+    overview?: string;
+    release_date?: string;
+    first_air_date?: string;
+    poster_path?: string | null;
+    backdrop_path?: string | null;
+    popularity?: number;
+    vote_average?: number;
+};
+
+/**
+ * Details of a TV Show.
+ */
+export declare type TvDetails = {
+    seasons: SeasonSummary[];
+    name: string;
+    id: number;
 };
 
 export { }

package/lib/main.iife.js

@@ -110,9 +110,38 @@ ${textLines.join("\n")}
       throw error;
     }
   }
+  async function searchTmdb(query, language = "en-US") {
+    const url = new URL(`${config.baseUrl}/api/tmdb/search`);
+    url.searchParams.append("q", query);
+    url.searchParams.append("language", language);
+    const response = await fetch(url.toString());
+    if (!response.ok) {
+      throw new Error(`Failed to search TMDB: ${response.status}`);
+    }
+    return response.json();
+  }
+  async function getTvDetails(id) {
+    const url = `${config.baseUrl}/api/tmdb/tv/${id}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch TV details: ${response.status}`);
+    }
+    return response.json();
+  }
+  async function getSeasonDetails(id, season) {
+    const url = `${config.baseUrl}/api/tmdb/tv/${id}/${season}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch season details: ${response.status}`);
+    }
+    return response.json();
+  }
   exports.configure = configure;
+  exports.getSeasonDetails = getSeasonDetails;
+  exports.getTvDetails = getTvDetails;
   exports.parseToVTT = parseToVTT;
   exports.searchSubtitles = searchSubtitles;
+  exports.searchTmdb = searchTmdb;
   Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
   return exports;
 }({});

package/lib/main.js

@@ -108,8 +108,37 @@ ${textLines.join("\n")}
     throw error;
   }
 }
+async function searchTmdb(query, language = "en-US") {
+  const url = new URL(`${config.baseUrl}/api/tmdb/search`);
+  url.searchParams.append("q", query);
+  url.searchParams.append("language", language);
+  const response = await fetch(url.toString());
+  if (!response.ok) {
+    throw new Error(`Failed to search TMDB: ${response.status}`);
+  }
+  return response.json();
+}
+async function getTvDetails(id) {
+  const url = `${config.baseUrl}/api/tmdb/tv/${id}`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch TV details: ${response.status}`);
+  }
+  return response.json();
+}
+async function getSeasonDetails(id, season) {
+  const url = `${config.baseUrl}/api/tmdb/tv/${id}/${season}`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch season details: ${response.status}`);
+  }
+  return response.json();
+}
 export {
   configure,
+  getSeasonDetails,
+  getTvDetails,
   parseToVTT,
-  searchSubtitles
+  searchSubtitles,
+  searchTmdb
 };

package/lib/main.umd.cjs

@@ -112,8 +112,37 @@ ${textLines.join("\n")}
       throw error;
     }
   }
+  async function searchTmdb(query, language = "en-US") {
+    const url = new URL(`${config.baseUrl}/api/tmdb/search`);
+    url.searchParams.append("q", query);
+    url.searchParams.append("language", language);
+    const response = await fetch(url.toString());
+    if (!response.ok) {
+      throw new Error(`Failed to search TMDB: ${response.status}`);
+    }
+    return response.json();
+  }
+  async function getTvDetails(id) {
+    const url = `${config.baseUrl}/api/tmdb/tv/${id}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch TV details: ${response.status}`);
+    }
+    return response.json();
+  }
+  async function getSeasonDetails(id, season) {
+    const url = `${config.baseUrl}/api/tmdb/tv/${id}/${season}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch season details: ${response.status}`);
+    }
+    return response.json();
+  }
   exports2.configure = configure;
+  exports2.getSeasonDetails = getSeasonDetails;
+  exports2.getTvDetails = getTvDetails;
   exports2.parseToVTT = parseToVTT;
   exports2.searchSubtitles = searchSubtitles;
+  exports2.searchTmdb = searchTmdb;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
 });

package/package.json

@@ -1,76 +1,76 @@
-{
-  "name": "wyzie-lib",
-  "version": "2.2.6",
-  "icon": "https://i.postimg.cc/L5ppKYC5/cclogo.png",
-  "license": "MIT",
-  "keywords": [
-    "wyzie-subs",
-    "wyzie subs",
-    "wyzie api",
-    "subtitle",
-    "search",
-    "library",
-    "typescript",
-    "vite",
-    "fast",
-    "scraper",
-    "subtitle scraper",
-    "open subtitles"
-  ],
-  "type": "module",
-  "main": "./lib/main.js",
-  "types": "./lib/main.d.ts",
-  "files": [
-    "./lib"
-  ],
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./lib/main.d.ts",
-        "default": "./lib/main.js"
-      },
-      "require": {
-        "types": "./lib/main.d.ts",
-        "default": "./lib/main.cjs"
-      },
-      "umd": {
-        "types": "./lib/main.d.ts",
-        "default": "./lib/main.umd.cjs"
-      },
-      "es": {
-        "types": "./lib/main.d.ts",
-        "default": "./lib/main.js"
-      },
-      "cjs": {
-        "types": "./lib/main.d.ts",
-        "default": "./lib/main.cjs"
-      },
-      "iife": {
-        "types": "./lib/main.d.ts",
-        "default": "./lib/main.iife.js"
-      },
-      "amd": {
-        "types": "./lib/main.d.ts",
-        "default": "./lib/main.amd.js"
-      }
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/itzcozi/wyzie-lib.git"
-  },
-  "devDependencies": {
-    "prettier": "^3.6.0",
-    "typescript": "^5.8.3",
-    "vite": "^4.5.14",
-    "vite-plugin-dts": "^4.5.4",
-    "vitest": "^2.1.9"
-  },
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build && tsc",
-    "test": "npx vitest",
-    "format": "prettier --log-level warn --write \"{src/**/*.{ts},*.{ts,js,html,css,json,md,xml}}\"",
-    "preview": "vite preview"
-  }
-}
+{
+  "name": "wyzie-lib",
+  "version": "2.2.8",
+  "icon": "https://i.postimg.cc/L5ppKYC5/cclogo.png",
+  "license": "MIT",
+  "keywords": [
+    "wyzie-subs",
+    "wyzie subs",
+    "wyzie api",
+    "subtitle",
+    "search",
+    "library",
+    "typescript",
+    "vite",
+    "fast",
+    "scraper",
+    "subtitle scraper",
+    "open subtitles"
+  ],
+  "type": "module",
+  "main": "./lib/main.js",
+  "types": "./lib/main.d.ts",
+  "files": [
+    "./lib"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./lib/main.d.ts",
+        "default": "./lib/main.js"
+      },
+      "require": {
+        "types": "./lib/main.d.ts",
+        "default": "./lib/main.cjs"
+      },
+      "umd": {
+        "types": "./lib/main.d.ts",
+        "default": "./lib/main.umd.cjs"
+      },
+      "es": {
+        "types": "./lib/main.d.ts",
+        "default": "./lib/main.js"
+      },
+      "cjs": {
+        "types": "./lib/main.d.ts",
+        "default": "./lib/main.cjs"
+      },
+      "iife": {
+        "types": "./lib/main.d.ts",
+        "default": "./lib/main.iife.js"
+      },
+      "amd": {
+        "types": "./lib/main.d.ts",
+        "default": "./lib/main.amd.js"
+      }
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itzcozi/wyzie-lib.git"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc",
+    "test": "npx vitest",
+    "format": "prettier --log-level warn --write \"{src/**/*.{ts},*.{ts,js,html,css,json,md,xml}}\"",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3",
+    "vite": "^4.5.14",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^2.1.9"
+  }
+}