wyzie-lib 2.0.6 → 2.0.8

package/README.md

@@ -3,7 +3,7 @@
 Wyzie Lib is a package made for easily implementing [Wyzie Subs](https://sub.wyzie.ru) into your
 project without all the fuss. [Read our source code!](https://github.com/itzcozi/wyzie-lib)
 
-<sup>2.0 Out Now!</sup>
+<sup>New VTT Parser!</sup>
 
 ## Features
 
@@ -34,11 +34,19 @@ yarn add wyzie-lib
 ## Usage
 
 ```ts
-import { type SubtitleData, searchSubtitles } from "wyzie-lib";
+import { type SubtitleData, searchSubtitles, parseToVTT } from "wyzie-lib";
 
-// IMDB is faster then TMDB due to less API calls behind the scenes
-const data: SubtitleData[] = await searchSubtitles({ tmdb_id: 286217 });
-console.log(data[0]); // Prints the object of the first subtitle provided in the search
+const params = { tmdb_id: 286217 };
+
+// Fetches all subtitles for the media with the TMDB ID 286217
+// -----------------------------------------------------------
+const data: SubtitleData[] = await searchSubtitles(params);
+console.log(data[0].id); // Prints the ID of the first subtitle object
+
+// Converts the first subtitle to VTT format using the previous parameters provided
+// --------------------------------------------------------------------------------
+const vttContent = await parseToVTT(params, 0); // Use the first subtitle URL for convenience
+console.log(vttContent); // Prints the raw VTT content
 ```
 
 ### Parameters
@@ -62,35 +70,35 @@ console.log(data[0]); // Prints the object of the first subtitle provided in the
 ```ts
 interface SearchSubtitlesParams {
   // Parameters for the searchSubtitles() function
-  tmdb_id?: number; // Parsed automatically by the API to recognize if its TMDB or IMDB
-  imdb_id?: number; // Parsed automatically by the API to recognize if its TMDB or IMDB
+  tmdb_id?: number;           // Parsed automatically by the API to recognize if its TMDB or IMDB
+  imdb_id?: number;           // Parsed automatically by the API to recognize if its TMDB or IMDB
   season?: number;
-  episode?: number; // Season is required if episode is provided
-  language?: string; // ISO 3166 code
-  format?: string; // Subtitle file format
-  hi?: boolean; // If the subtitle is hearing impaired
+  episode?: number;           // Season is required if episode is provided
+  language?: string;          // ISO 3166 code
+  format?: string;            // Subtitle file format
+  hi?: boolean;               // If the subtitle is hearing impaired
 }
 
 interface QueryParams {
   // Parameters for the wyzie-subs API
-  id: string; // (Required) The TMDB or IMDB ID of the movie or TV show
-  season?: number; // The season of the TV show (Required if episode is provided)
-  episode?: number; // The episode of the TV show (Required if season is provided)
-  language?: string; // ISO 3166 code
-  format?: string; // Subtitle file format
-  hi?: boolean; // If the subtitle is hearing impaired
+  id: string;                 // (Required) The TMDB or IMDB ID of the movie or TV show
+  season?: number;            // The season of the TV show (Required if episode is provided)
+  episode?: number;           // The episode of the TV show (Required if season is provided)
+  language?: string;          // ISO 3166 code
+  format?: string;            // Subtitle file format
+  hi?: boolean;               // If the subtitle is hearing impaired
 }
 
 type SubtitleData = {
   // Data returned by the API
-  id: string; // Unique ID of the subtitle from opensubtitles
-  url: string; // Direct download link of the subtitle
-  format: string; // Subtitle file format
+  id: string;                 // Unique ID of the subtitle from opensubtitles
+  url: string;                // Direct download link of the subtitle
+  format: string;             // Subtitle file format
   isHearingImpaired: boolean; // If the subtitle is hearing impaired
-  flagUrl: string; // Flag of the language
-  media: string; // Media name of the subtitle
-  display: string; // Actual name of the language
-  language: string; // ISO 3166 code
+  flagUrl: string;            // Flag of the language
+  media: string;              // Media name of the subtitle
+  display: string;            // Actual name of the language
+  language: string;           // ISO 3166 code
 };
 ```
 

package/dist/types/funcs.d.ts

@@ -0,0 +1,7 @@
+import { SearchSubtitlesParams, SubtitleData } from "./types";
+export declare function searchSubtitles(params: SearchSubtitlesParams & {
+    parseVTT?: boolean;
+}): Promise<SubtitleData[] | {
+    subtitles: SubtitleData[];
+    vttContent: string;
+}>;

package/dist/types/main.d.ts

@@ -0,0 +1,4 @@
+import { SearchSubtitlesParams, SubtitleData, QueryParams } from "./types";
+import { searchSubtitles } from "./funcs";
+export { searchSubtitles };
+export type { SubtitleData, SearchSubtitlesParams, QueryParams };

package/dist/types/types.d.ts

@@ -0,0 +1,28 @@
+export interface SearchSubtitlesParams {
+    tmdb_id?: number;
+    imdb_id?: number;
+    season?: number;
+    episode?: number;
+    language?: string;
+    format?: string;
+    hi?: boolean;
+    parseVTT?: boolean;
+}
+export type SubtitleData = {
+    id: string;
+    url: string;
+    format: string;
+    isHearingImpaired: boolean;
+    flagUrl: string;
+    media: string;
+    display: string;
+    language: string;
+};
+export interface QueryParams {
+    id: string;
+    season?: number;
+    episode?: number;
+    language?: string;
+    format?: string;
+    hi?: boolean;
+}

package/dist/wyzie-lib.cjs.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});async function h({tmdb_id:n,imdb_id:t,season:r,episode:o,language:u,format:f,hi:d}){const c=new URL("https://sub.wyzie.ru/search"),s={id:String(n||t),season:r,episode:o,language:u,format:f,hi:d};return Object.entries(s).forEach(([i,a])=>{a!==void 0&&c.searchParams.append(i,a)}),c}async function p(n){const t=await fetch(n.toString());if(!t.ok)throw new Error(`HTTP error! status: ${t.status}`);return t.json()}async function w(n){try{const t=await fetch(n);if(!t.ok)throw new Error(`Failed to fetch subtitle content: ${t.status}`);const o=(await t.text()).replace(/\r\n/g,`
+`).replace(/\r/g,`
+`).trim();let u=`WEBVTT
+
+`;const f=o.split(/\n\n+/);for(const c of f){if(!c.trim())continue;const s=c.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0);if(s.length<2)continue;const i=s.findIndex(e=>/^\d{1,2}:\d{2}(?::\d{2})?[,\.]\d{3}(?:\.|,)?\s*-->\s*\d{1,2}:\d{2}(?::\d{2})?[,\.]\d{3}(?:\.|,)?$/.test(e));if(i===-1)continue;const a=s.slice(i+1).filter(e=>!/^\d+$/.test(e)).filter(e=>e.length>0);if(a.length===0)continue;let l=s[i];l=l.replace(/[,.](?=\s*-->)/,"").replace(/[,.]$/,""),l=l.replace(/,(\d{3})/g,".$1"),u+=`${l}
+${a.join(`
+`)}
+
+`}return u.replace(/\n{3,}/g,`
+
+`).trim()+`
+
+`}catch(t){throw console.error("Error in parseToVTT:",t),t}}async function g(n){try{const t=await h(n),r=await p(t);if(n.parseVTT&&r.length>0){const o=await w(r[0].url);return{subtitles:r,vttContent:o}}return r}catch(t){throw new Error(`Error fetching subtitles: ${t}`)}}exports.searchSubtitles=g;

package/dist/wyzie-lib.es.js

@@ -0,0 +1,85 @@
+async function d({
+  tmdb_id: e,
+  imdb_id: t,
+  season: r,
+  episode: s,
+  language: u,
+  format: f,
+  hi: h
+}) {
+  const c = new URL("https://sub.wyzie.ru/search"), o = {
+    id: String(e || t),
+    season: r,
+    episode: s,
+    language: u,
+    format: f,
+    hi: h
+  };
+  return Object.entries(o).forEach(([i, a]) => {
+    a !== void 0 && c.searchParams.append(i, a);
+  }), c;
+}
+async function p(e) {
+  const t = await fetch(e.toString());
+  if (!t.ok)
+    throw new Error(`HTTP error! status: ${t.status}`);
+  return t.json();
+}
+async function w(e) {
+  try {
+    const t = await fetch(e);
+    if (!t.ok)
+      throw new Error(`Failed to fetch subtitle content: ${t.status}`);
+    const s = (await t.text()).replace(/\r\n/g, `
+`).replace(/\r/g, `
+`).trim();
+    let u = `WEBVTT
+
+`;
+    const f = s.split(/\n\n+/);
+    for (const c of f) {
+      if (!c.trim())
+        continue;
+      const o = c.split(`
+`).map((n) => n.trim()).filter((n) => n.length > 0);
+      if (o.length < 2)
+        continue;
+      const i = o.findIndex(
+        (n) => /^\d{1,2}:\d{2}(?::\d{2})?[,\.]\d{3}(?:\.|,)?\s*-->\s*\d{1,2}:\d{2}(?::\d{2})?[,\.]\d{3}(?:\.|,)?$/.test(n)
+      );
+      if (i === -1)
+        continue;
+      const a = o.slice(i + 1).filter((n) => !/^\d+$/.test(n)).filter((n) => n.length > 0);
+      if (a.length === 0)
+        continue;
+      let l = o[i];
+      l = l.replace(/[,.](?=\s*-->)/, "").replace(/[,.]$/, ""), l = l.replace(/,(\d{3})/g, ".$1"), u += `${l}
+${a.join(`
+`)}
+
+`;
+    }
+    return u.replace(/\n{3,}/g, `
+
+`).trim() + `
+
+`;
+  } catch (t) {
+    throw console.error("Error in parseToVTT:", t), t;
+  }
+}
+async function g(e) {
+  try {
+    const t = await d(e), r = await p(t);
+    if (e.parseVTT && r.length > 0) {
+      const s = await w(r[0].url);
+      return { subtitles: r, vttContent: s };
+    }
+    return r;
+  } catch (t) {
+    throw new Error(`Error fetching subtitles: ${t}`);
+  }
+}
+export {
+  g as searchSubtitles
+};

package/dist/wyzie-lib.iife.js

@@ -0,0 +1,14 @@
+var WyzieLib=function(f){"use strict";async function p({tmdb_id:e,imdb_id:t,season:r,episode:s,language:u,format:d,hi:h}){const c=new URL("https://sub.wyzie.ru/search"),o={id:String(e||t),season:r,episode:s,language:u,format:d,hi:h};return Object.entries(o).forEach(([i,a])=>{a!==void 0&&c.searchParams.append(i,a)}),c}async function w(e){const t=await fetch(e.toString());if(!t.ok)throw new Error(`HTTP error! status: ${t.status}`);return t.json()}async function g(e){try{const t=await fetch(e);if(!t.ok)throw new Error(`Failed to fetch subtitle content: ${t.status}`);const s=(await t.text()).replace(/\r\n/g,`
+`).replace(/\r/g,`
+`).trim();let u=`WEBVTT
+
+`;const d=s.split(/\n\n+/);for(const c of d){if(!c.trim())continue;const o=c.split(`
+`).map(n=>n.trim()).filter(n=>n.length>0);if(o.length<2)continue;const i=o.findIndex(n=>/^\d{1,2}:\d{2}(?::\d{2})?[,\.]\d{3}(?:\.|,)?\s*-->\s*\d{1,2}:\d{2}(?::\d{2})?[,\.]\d{3}(?:\.|,)?$/.test(n));if(i===-1)continue;const a=o.slice(i+1).filter(n=>!/^\d+$/.test(n)).filter(n=>n.length>0);if(a.length===0)continue;let l=o[i];l=l.replace(/[,.](?=\s*-->)/,"").replace(/[,.]$/,""),l=l.replace(/,(\d{3})/g,".$1"),u+=`${l}
+${a.join(`
+`)}
+
+`}return u.replace(/\n{3,}/g,`
+
+`).trim()+`
+
+`}catch(t){throw console.error("Error in parseToVTT:",t),t}}async function b(e){try{const t=await p(e),r=await w(t);if(e.parseVTT&&r.length>0){const s=await g(r[0].url);return{subtitles:r,vttContent:s}}return r}catch(t){throw new Error(`Error fetching subtitles: ${t}`)}}return f.searchSubtitles=b,Object.defineProperty(f,Symbol.toStringTag,{value:"Module"}),f}({});

package/dist/wyzie-lib.umd.js

@@ -0,0 +1,14 @@
+(function(o,i){typeof exports=="object"&&typeof module<"u"?i(exports):typeof define=="function"&&define.amd?define(["exports"],i):(o=typeof globalThis<"u"?globalThis:o||self,i(o.WyzieLib={}))})(this,function(o){"use strict";async function i({tmdb_id:n,imdb_id:t,season:r,episode:c,language:d,format:h,hi:p}){const a=new URL("https://sub.wyzie.ru/search"),s={id:String(n||t),season:r,episode:c,language:d,format:h,hi:p};return Object.entries(s).forEach(([l,u])=>{u!==void 0&&a.searchParams.append(l,u)}),a}async function w(n){const t=await fetch(n.toString());if(!t.ok)throw new Error(`HTTP error! status: ${t.status}`);return t.json()}async function T(n){try{const t=await fetch(n);if(!t.ok)throw new Error(`Failed to fetch subtitle content: ${t.status}`);const c=(await t.text()).replace(/\r\n/g,`
+`).replace(/\r/g,`
+`).trim();let d=`WEBVTT
+
+`;const h=c.split(/\n\n+/);for(const a of h){if(!a.trim())continue;const s=a.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0);if(s.length<2)continue;const l=s.findIndex(e=>/^\d{1,2}:\d{2}(?::\d{2})?[,\.]\d{3}(?:\.|,)?\s*-->\s*\d{1,2}:\d{2}(?::\d{2})?[,\.]\d{3}(?:\.|,)?$/.test(e));if(l===-1)continue;const u=s.slice(l+1).filter(e=>!/^\d+$/.test(e)).filter(e=>e.length>0);if(u.length===0)continue;let f=s[l];f=f.replace(/[,.](?=\s*-->)/,"").replace(/[,.]$/,""),f=f.replace(/,(\d{3})/g,".$1"),d+=`${f}
+${u.join(`
+`)}
+
+`}return d.replace(/\n{3,}/g,`
+
+`).trim()+`
+
+`}catch(t){throw console.error("Error in parseToVTT:",t),t}}async function b(n){try{const t=await i(n),r=await w(t);if(n.parseVTT&&r.length>0){const c=await T(r[0].url);return{subtitles:r,vttContent:c}}return r}catch(t){throw new Error(`Error fetching subtitles: ${t}`)}}o.searchSubtitles=b,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wyzie-lib",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "icon": "https://i.postimg.cc/L5ppKYC5/cclogo.png",
   "license": "MIT",
   "keywords": [
@@ -29,15 +29,15 @@
     }
   },
   "devDependencies": {
-    "@eslint/js": "^9.14.0",
-    "eslint": "^9.14.0",
+    "@eslint/js": "^9.17.0",
+    "eslint": "^9.17.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-prettier": "^5.2.1",
-    "globals": "^15.12.0",
-    "prettier": "^3.3.3",
-    "typescript": "^5.6.3",
-    "typescript-eslint": "^8.14.0",
+    "globals": "^15.14.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.19.0",
     "vite": "^4.5.5"
   },
   "scripts": {