better-ani-scraped 1.6.4 → 1.6.6

package/DOCUMENTATION.md

@@ -28,7 +28,7 @@ const crunchyroll = new AnimeScraper('crunchyroll') //for Crunchyroll
 ## `AnimeScraper("animesama")` methods
 
 - [searchAnime](#animesamasearchanimequery-limit--10-wantedlanguages--vostfr-vf-vastfr-wantedtypes--anime-film-page--null)
-- [getSeasons](#animesamagetseasonsanimeurl-language--vostfr)
+- [getSeasons](#animesamagetseasonsanimeurl-language--vostfr-vf-va-vkr-vcn-vqc-vf1-vf2)
 - [getEpisodeTitles](#animesamagetepisodetitlesseasonurl-customchromiumpath)
 - [getEmbed](#animesamagetembedseasonurl-hostpriority--sendvid-sibnet-vidmoly-oneupload-allhost--false-includeinfo--false-customchromiumpath)
 - [getAnimeInfo](#animesamagetanimeinfoanimeurl)
@@ -63,22 +63,26 @@ Searches for anime titles that match the given query.
 
 ---
 
-### `animesama.getSeasons(animeUrl, language = "vostfr")`
-Fetches all available seasons of an anime in the specified language.
+### `animesama.getSeasons(animeUrl, languagePriority = ["vostfr", "vf", "va", "vkr", "vcn", "vqc", "vf1", "vf2"])`
+Fetches all available seasons of an anime in the first valid language specified.
 
 - **Parameters:**
   - `animeUrl` *(string)*: The full URL of the anime.
-  - `language` *(string)*: Language to filter by (default: "vostfr").
+  - `languagePriority` *(string[])*: Array of preferred language.
 - **Returns:**  
   Either an array of season objects:
   ```js
-  [
-    { 
-      title: string, 
-      url: string 
-    },
-    ...
-  ]
+  {
+    language: string,
+    seasons: [
+      { 
+        title: string, 
+        url: string 
+      },
+      ...
+    ]
+  }
+  
   ```
   Else, an error object if the language is not available.
 
@@ -164,17 +168,17 @@ Checks which languages are available for a given anime season (Avoid using `numb
   - `wantedLanguages` *(string[])*: Language codes to check (e.g., ["vostfr", "vf", "va", ...]).
   - `numberEpisodes` *(boolean)*: If `true`, also fetches the number of episodes in each language.
 - **Returns:**  
-  Array of objects containing available languages and their episode count:
+  Array of objects containing available languages and their episode count if numberEpisodes is true:
   ```js
   [
     {
       language: string,
-      episodeCount: number //if numberEpisodes = true
+      episodeCount: number 
     },
     ...
   ]
   ```
-
+  Or an array of available languages
 ---
 
 ### `animesama.getAllAnime(wantedLanguages = ["vostfr", "vf", "vastfr"], wantedTypes = ["Anime", "Film"], page = null, output = "anime_list.json", get_seasons = false)`

package/examples/animesama/example_usage_getAvailableLanguages.js

@@ -2,7 +2,7 @@ import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-s
 
 const main = async () => {
   const animesama = new AnimeScraper('animesama');
-  const seasonUrl = "https://anime-sama.fr/catalogue/aggretsuko/saison1/vf/";
+  const seasonUrl = "https://anime-sama.fr/catalogue/86-eighty-six/saison1/vostfr/";
 
   const animeLanguages = await animesama.getAvailableLanguages(seasonUrl, ["vostfr", "vf", "va", "vkr","vcn", "vqc", "vf1", "vf2"], false);
   console.log(animeLanguages);

package/examples/animesama/example_usage_getSeasons.js

@@ -1,10 +1,10 @@
-import { AnimeScraper, getVideoUrlFromEmbed } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
+import { AnimeScraper } from "../../index.js"; // REPLACE BY "from 'better-ani-scraped';"
 
 const main = async () => {
   const animesama = new AnimeScraper('animesama');
-  const animeUrl = "https://anime-sama.fr/catalogue/one-piece/";
+  const animeUrl = "https://anime-sama.fr/catalogue/sword-art-online";
   
-  const seasons = await animesama.getSeasons(animeUrl, "vostfr");
+  const seasons = await animesama.getSeasons(animeUrl, ["vostfr", "vf"]);
   console.log("Seasons:", seasons);
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-ani-scraped",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "description": "Scrape anime data from different sources (only anime-sama.fr for the moment)",
   "main": "index.js",
   "scripts": {

package/scrapers/animesama.js

@@ -118,62 +118,60 @@ export async function searchAnime(
   return results;
 }
 
-export async function getSeasons(animeUrl, language = "vostfr") {
+export async function getSeasons(animeUrl, languagePriority = ["vostfr", "vf", "va", "vkr", "vcn", "vqc", "vf1", "vf2"]) {
   const res = await axios.get(animeUrl, { headers: getHeaders(CATALOGUE_URL) });
   const html = res.data;
 
-  // Only keep the part before the Kai section
   const mainAnimeOnly = html.split("Anime Version Kai")[0];
-
   const $ = cheerio.load(mainAnimeOnly);
   const scriptTags = $("script")
     .toArray()
-    .filter((script) => {
-      return $(script).html().includes("panneauAnime");
-    });
+    .filter(script => $(script).html().includes("panneauAnime"));
 
   const animeName = animeUrl.split("/")[4];
-  const seasons = [];
-  let languageAvailable = false;
+  let seasons = [];
 
-  for (let script of scriptTags) {
-    const content = $(script).html();
+  for (const language of languagePriority) {
+    seasons = [];
+    let languageAvailable = false;
 
-    // Remove anything inside comments either ("/* */" or "//")
-    const uncommentedContent = content
-      .replace(/\/\*[\s\S]*?\*\//g, "")
-      .replace(/\/\/.*$/gm, "");
+    for (let script of scriptTags) {
+      const content = $(script).html();
 
-    const matches = [
-      ...uncommentedContent.matchAll(/panneauAnime\("([^"]+)", "([^"]+)"\);/g),
-    ];
+      const uncommentedContent = content
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        .replace(/\/\/.*$/gm, "");
 
-    for (let match of matches) {
-      const title = match[1];
-      const href = match[2].split("/")[0];
-      const fullUrl = `${CATALOGUE_URL}/${animeName}/${href}/${language}`;
+      const matches = [...uncommentedContent.matchAll(/panneauAnime\("([^"]+)", "([^"]+)"\);/g)];
 
-      try {
-        const check = await axios.head(fullUrl, {
-          headers: getHeaders(animeUrl),
-        });
-        if (check.status === 200) {
-          languageAvailable = true;
-          seasons.push({ title, url: fullUrl });
+      for (let match of matches) {
+        const title = match[1];
+        const href = match[2].split("/")[0];
+        const fullUrl = `${CATALOGUE_URL}/${animeName}/${href}/${language}`;
+
+        try {
+          const check = await axios.head(fullUrl, {
+            headers: getHeaders(animeUrl),
+          });
+          if (check.status === 200) {
+            languageAvailable = true;
+            seasons.push({ title, url: fullUrl });
+          }
+        } catch (err) {
+          // Ignore invalid URLs
         }
-      } catch (err) {
-        // Ignore missing URLs
       }
     }
-  }
 
-  if (!languageAvailable) {
-    return { error: `Language "${language}" is not available for this anime.` };
+    if (languageAvailable) {
+      return { language, seasons };
+    }
   }
 
-  return seasons;
+  return { error: "No language available in : " + languagePriority.join(", ") };
 }
 
+
 export async function getEpisodeTitles(seasonUrl, customChromiumPath) {
   let browser;
   try {
@@ -377,7 +375,7 @@ export async function getAvailableLanguages(
           const episodeCount = (await getEmbed(languageUrl)).length;
           languageLinks.push({ language: language.toUpperCase(), episodeCount: episodeCount });
         } else {
-          languageLinks.push({ language: language.toUpperCase()});
+          languageLinks.push(language.toUpperCase());
         }
         
       }