wyzie-lib 2.3.0 → 2.4.0

package/README.md

@@ -5,5 +5,5 @@
   </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).
+Wyzie Lib is a package made for easily implementing [Wyzie Subs](https:
+project without all the fuss. [Read the docs](https:

package/lib/main.amd.js

@@ -17,7 +17,13 @@ define(["exports"], function(exports) {
     language,
     format,
     source,
+    release,
+    filename,
+    file,
+    fileName,
+    origin,
     hi,
+    refresh,
     ...extraParams
   }) {
     if (!tmdb_id && !imdb_id) {
@@ -37,7 +43,13 @@ define(["exports"], function(exports) {
       language: Array.isArray(language) ? language.join(",") : language,
       format: Array.isArray(format) ? format.join(",") : format,
       source: Array.isArray(source) ? source.join(",") : source,
-      hi
+      release: Array.isArray(release) ? release.join(",") : release,
+      filename: Array.isArray(filename) ? filename.join(",") : filename,
+      file: Array.isArray(file) ? file.join(",") : file,
+      fileName: Array.isArray(fileName) ? fileName.join(",") : fileName,
+      origin: Array.isArray(origin) ? origin.join(",") : origin,
+      hi,
+      refresh
     };
     Object.entries(queryParams).forEach(([key, value]) => {
       if (value !== void 0) {
@@ -136,8 +148,18 @@ ${textLines.join("\n")}
     }
     return response.json();
   }
+  async function getSources() {
+    const url = `${config.baseUrl}/sources`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch sources: ${response.status}`);
+    }
+    const data = await response.json();
+    return data.sources;
+  }
   exports.configure = configure;
   exports.getSeasonDetails = getSeasonDetails;
+  exports.getSources = getSources;
   exports.getTvDetails = getTvDetails;
   exports.parseToVTT = parseToVTT;
   exports.searchSubtitles = searchSubtitles;

package/lib/main.cjs

@@ -17,7 +17,13 @@ async function constructUrl({
   language,
   format,
   source,
+  release,
+  filename,
+  file,
+  fileName,
+  origin,
   hi,
+  refresh,
   ...extraParams
 }) {
   if (!tmdb_id && !imdb_id) {
@@ -37,7 +43,13 @@ async function constructUrl({
     language: Array.isArray(language) ? language.join(",") : language,
     format: Array.isArray(format) ? format.join(",") : format,
     source: Array.isArray(source) ? source.join(",") : source,
-    hi
+    release: Array.isArray(release) ? release.join(",") : release,
+    filename: Array.isArray(filename) ? filename.join(",") : filename,
+    file: Array.isArray(file) ? file.join(",") : file,
+    fileName: Array.isArray(fileName) ? fileName.join(",") : fileName,
+    origin: Array.isArray(origin) ? origin.join(",") : origin,
+    hi,
+    refresh
   };
   Object.entries(queryParams).forEach(([key, value]) => {
     if (value !== void 0) {
@@ -136,8 +148,18 @@ async function getSeasonDetails(id, season) {
   }
   return response.json();
 }
+async function getSources() {
+  const url = `${config.baseUrl}/sources`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch sources: ${response.status}`);
+  }
+  const data = await response.json();
+  return data.sources;
+}
 exports.configure = configure;
 exports.getSeasonDetails = getSeasonDetails;
+exports.getSources = getSources;
 exports.getTvDetails = getTvDetails;
 exports.parseToVTT = parseToVTT;
 exports.searchSubtitles = searchSubtitles;

package/lib/main.d.ts

@@ -42,6 +42,13 @@ export declare type EpisodeDetails = {
  */
 export declare function getSeasonDetails(id: number, season: number): Promise<SeasonDetails>;
 
+/**
+ * Fetches the list of currently enabled subtitle sources.
+ *
+ * @returns {Promise<string[]>} A promise that resolves to an array of enabled source names.
+ */
+export declare function getSources(): Promise<string[]>;
+
 /**
  * Fetches details for a TV show from TMDB.
  *
@@ -83,6 +90,12 @@ export declare type QueryParams = {
     release?: string;
     /** Filter by filename. */
     filename?: string;
+    file?: string;
+    fileName?: string;
+    /** Filter by content origin (e.g., WEB, BluRay). */
+    origin?: string;
+    /** Bypass cache and fetch fresh results from sources. */
+    refresh?: boolean;
 };
 
 /**
@@ -119,10 +132,16 @@ 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. */
+    /** Filter by specific release group or name (can be a list). */
     release?: string | string[];
-    /** Filter by filename. */
+    /** Filter by filename (aliases: file, fileName). */
     filename?: string | string[];
+    file?: string | string[];
+    fileName?: string | string[];
+    /** Filter by content origin (e.g., WEB, BluRay). */
+    origin?: string | string[];
+    /** Bypass cache and fetch fresh results from sources. */
+    refresh?: boolean;
     /** Additional parameters that can be used for filtering or other purposes. */
     [key: string]: any;
 } & (
@@ -169,6 +188,14 @@ export declare type SeasonSummary = {
     vote_average?: number;
 };
 
+/**
+ * Response from the /sources endpoint.
+ */
+export declare type SourcesResponse = {
+    /** List of currently enabled subtitle sources. */
+    sources: string[];
+};
+
 /**
  * Data structure representing a single subtitle object.
  */
@@ -194,13 +221,19 @@ export declare type SubtitleData = {
     /** The subtitle's source (ex: subdl, subf2m, opensubtitles). */
     source?: string | string[];
     /** The release name of the subtitle. */
-    release?: string;
+    release?: string | null;
     /** List of releases compatible with this subtitle. */
     releases?: string[];
     /** The original filename of the subtitle. */
-    fileName?: string;
+    fileName?: string | null;
+    /** Number of downloads on the source platform (if available). */
+    downloadCount?: number | null;
     /** The origin of the subtitle (e.g. DVD, WEB, BluRay). */
-    origin?: string;
+    origin?: string | null;
+    /** Which release value matched the user filter. */
+    matchedRelease?: string | null;
+    /** Which user-supplied filter matched. */
+    matchedFilter?: string | null;
 };
 
 /**

package/lib/main.iife.js

@@ -17,7 +17,13 @@ var main = function(exports) {
     language,
     format,
     source,
+    release,
+    filename,
+    file,
+    fileName,
+    origin,
     hi,
+    refresh,
     ...extraParams
   }) {
     if (!tmdb_id && !imdb_id) {
@@ -37,7 +43,13 @@ var main = function(exports) {
       language: Array.isArray(language) ? language.join(",") : language,
       format: Array.isArray(format) ? format.join(",") : format,
       source: Array.isArray(source) ? source.join(",") : source,
-      hi
+      release: Array.isArray(release) ? release.join(",") : release,
+      filename: Array.isArray(filename) ? filename.join(",") : filename,
+      file: Array.isArray(file) ? file.join(",") : file,
+      fileName: Array.isArray(fileName) ? fileName.join(",") : fileName,
+      origin: Array.isArray(origin) ? origin.join(",") : origin,
+      hi,
+      refresh
     };
     Object.entries(queryParams).forEach(([key, value]) => {
       if (value !== void 0) {
@@ -136,8 +148,18 @@ ${textLines.join("\n")}
     }
     return response.json();
   }
+  async function getSources() {
+    const url = `${config.baseUrl}/sources`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch sources: ${response.status}`);
+    }
+    const data = await response.json();
+    return data.sources;
+  }
   exports.configure = configure;
   exports.getSeasonDetails = getSeasonDetails;
+  exports.getSources = getSources;
   exports.getTvDetails = getTvDetails;
   exports.parseToVTT = parseToVTT;
   exports.searchSubtitles = searchSubtitles;

package/lib/main.js

@@ -15,7 +15,13 @@ async function constructUrl({
   language,
   format,
   source,
+  release,
+  filename,
+  file,
+  fileName,
+  origin,
   hi,
+  refresh,
   ...extraParams
 }) {
   if (!tmdb_id && !imdb_id) {
@@ -35,7 +41,13 @@ async function constructUrl({
     language: Array.isArray(language) ? language.join(",") : language,
     format: Array.isArray(format) ? format.join(",") : format,
     source: Array.isArray(source) ? source.join(",") : source,
-    hi
+    release: Array.isArray(release) ? release.join(",") : release,
+    filename: Array.isArray(filename) ? filename.join(",") : filename,
+    file: Array.isArray(file) ? file.join(",") : file,
+    fileName: Array.isArray(fileName) ? fileName.join(",") : fileName,
+    origin: Array.isArray(origin) ? origin.join(",") : origin,
+    hi,
+    refresh
   };
   Object.entries(queryParams).forEach(([key, value]) => {
     if (value !== void 0) {
@@ -134,9 +146,19 @@ async function getSeasonDetails(id, season) {
   }
   return response.json();
 }
+async function getSources() {
+  const url = `${config.baseUrl}/sources`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch sources: ${response.status}`);
+  }
+  const data = await response.json();
+  return data.sources;
+}
 export {
   configure,
   getSeasonDetails,
+  getSources,
   getTvDetails,
   parseToVTT,
   searchSubtitles,

package/lib/main.umd.cjs

@@ -19,7 +19,13 @@
     language,
     format,
     source,
+    release,
+    filename,
+    file,
+    fileName,
+    origin,
     hi,
+    refresh,
     ...extraParams
   }) {
     if (!tmdb_id && !imdb_id) {
@@ -39,7 +45,13 @@
       language: Array.isArray(language) ? language.join(",") : language,
       format: Array.isArray(format) ? format.join(",") : format,
       source: Array.isArray(source) ? source.join(",") : source,
-      hi
+      release: Array.isArray(release) ? release.join(",") : release,
+      filename: Array.isArray(filename) ? filename.join(",") : filename,
+      file: Array.isArray(file) ? file.join(",") : file,
+      fileName: Array.isArray(fileName) ? fileName.join(",") : fileName,
+      origin: Array.isArray(origin) ? origin.join(",") : origin,
+      hi,
+      refresh
     };
     Object.entries(queryParams).forEach(([key, value]) => {
       if (value !== void 0) {
@@ -138,8 +150,18 @@ ${textLines.join("\n")}
     }
     return response.json();
   }
+  async function getSources() {
+    const url = `${config.baseUrl}/sources`;
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch sources: ${response.status}`);
+    }
+    const data = await response.json();
+    return data.sources;
+  }
   exports2.configure = configure;
   exports2.getSeasonDetails = getSeasonDetails;
+  exports2.getSources = getSources;
   exports2.getTvDetails = getTvDetails;
   exports2.parseToVTT = parseToVTT;
   exports2.searchSubtitles = searchSubtitles;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wyzie-lib",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "icon": "https://i.postimg.cc/L5ppKYC5/cclogo.png",
   "license": "MIT",
   "keywords": [