zohlathu 1.0.0

package/README.md

@@ -0,0 +1,63 @@
+# zohlathu
+
+A Node.js package for fetching Mizo song lyrics from [www.zohlathu.in](https://www.zohlathu.in).
+
+## Installation
+
+You can install the package using npm:
+```bash
+npm install zohlathu
+```
+
+## Usage
+
+Since fetching data is an asynchronous operation, use `async/await` or `.then()`.
+
+```javascript
+const { get_lyrics } = require('zohlathu');
+
+async function fetchSong() {
+    const song_name = "C. Sanga - Tawnmang Lasi"; // Replace with the requested song
+    const lyrics = await get_lyrics(song_name); // Get the lyrics
+
+    if (lyrics) {
+        // Format the response
+        const response = `${lyrics.title}\n\n${lyrics.lyrics}\n\nSource: ${lyrics.source_url}`;
+        console.log(response);
+    } else {
+        console.log("Lyrics not found.");
+    }
+}
+
+fetchSong();
+```
+
+### Response Object format
+* `lyrics.title` = The title of the lyrics
+* `lyrics.lyrics` = The lyrics content
+* `lyrics.source_url` = The url of the original post
+
+## Handle Errors
+
+The function handles most errors internally and returns `null` if it fails. You can add your own `try...catch` block around the execution.
+
+```javascript
+const { get_lyrics } = require('zohlathu');
+
+async function safeFetch() {
+    try {
+        const song_name = "C. Sanga - Tawnmang Lasi";
+        const lyrics = await get_lyrics(song_name);
+        
+        if (lyrics) {
+            console.log(`${lyrics.title}\n\n${lyrics.lyrics}\n\nSource: ${lyrics.source_url}`);
+        }
+    } catch (e) {
+        console.error(`An error occurred: ${e.message}`);
+    }
+}
+
+safeFetch();
+```
+
+**Requirements:** Node.js 14 or higher.

package/index.js

@@ -0,0 +1,83 @@
+const Parser = require('rss-parser');
+const { htmlToText } = require('html-to-text');
+const ytSearch = require('yt-search');
+
+/**
+ * Fetch lyrics for the given song query
+ * * @param {string} query - Song name or artist to search for
+ * @returns {Promise<Object|null>} - Dictionary containing title and lyrics, or null if not found
+ */
+async function get_lyrics(query) {
+    await new Promise(resolve => setTimeout(resolve, 3000));
+
+    if (!query || typeof query !== 'string') {
+        console.error("Input validation error: Invalid search query. Must be a non-empty string.");
+        return null;
+    }
+
+    const base_url = "https://www.blogger.com/feeds/690973182178026088/posts/default";
+    let feed_url = "";
+
+    try {
+        const results = await ytSearch(query);
+        const videos = results.videos;
+
+        if (!videos || videos.length === 0) {
+            console.log(`No YouTube results found for query: ${query}`);
+            return null;
+        }
+
+        const titlep = videos[0].title.substring(0, 100);
+        const search_query = titlep.replace(/ /g, '+');
+        feed_url = `${base_url}?q=${search_query}`;
+
+    } catch (youtube_error) {
+        console.error(`Youtube error: ${youtube_error}`);
+        return null;
+    }
+
+    try {
+        const parser = new Parser({
+            customFields: {
+                item: ['content']
+            },
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)',
+                'Accept-Language': 'en-US,en;q=0.9',
+                'Accept': 'application/atom+xml,text/html'
+            }
+        });
+
+
+        const feed = await parser.parseURL(feed_url);
+
+        if (!feed.items || feed.items.length === 0) {
+            console.log(`No entries found in feed for query: ${query}`);
+            return null;
+        }
+
+        const entry = feed.items[0];
+
+
+        let content = htmlToText(entry.content, {
+            wordwrap: false,
+            preserveNewlines: true
+        });
+
+
+        const pattern = /\* \* \*[\s\S]*?\* \* \*/g;
+        const cleaned_content = content.replace(pattern, '').trim();
+
+        return {
+            title: entry.title,
+            lyrics: cleaned_content,
+            source_url: entry.link
+        };
+
+    } catch (feed_error) {
+        console.error(`Feed parsing or Unexpected error: ${feed_error}`);
+        return null;
+    }
+}
+
+module.exports = { get_lyrics };

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "zohlathu",
+  "version": "1.0.0",
+  "description": "A Node.js package for fetching Mizo song lyrics from www.zohlathu.in",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RSR-TG-Info/ZoHlathu-JS.git"
+  },
+  "keywords": [
+    "mizo",
+    "lyrics",
+    "zohlathu"
+  ],
+  "author": "RSR",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "rss-parser": "*",
+    "html-to-text": "*",
+    "yt-search": "*"
+  }
+}

package/test.js

@@ -0,0 +1,28 @@
+const { get_lyrics } = require('./index.js'); 
+
+async function runTest() {
+    console.log("Hla thu kan zawng mek e, lo nghak lawk rawh...");
+
+    // I hla zawn duh chu hetah hian i thlak thei ang
+    const songToSearch = "Tawngmang lasi"; 
+
+    try {
+        const result = await get_lyrics(songToSearch);
+
+        if (result) {
+            console.log("\n✅ HLA HMUH A NI!");
+            console.log("----------------------------------");
+            console.log("Hla Hming :", result.title);
+            console.log("Link      :", result.source_url);
+            console.log("----------------------------------");
+            console.log(result.lyrics);
+            console.log("----------------------------------");
+        } else {
+            console.log("\n❌ Pawi lutuk, he hla hi hmuh a ni lo.");
+        }
+    } catch (error) {
+        console.error("Harsatna a awm:", error);
+    }
+}
+
+runTest();