@heavstaltech/api 1.0.4 → 1.2.6

package/README.md

@@ -240,6 +240,50 @@ const bufferJP = await tools.tts("Konnichiwa", "ja");
 fs.writeFileSync("voice.mp3", buffer);
 ```
 
+
+### 5. Image Makers (Ephoto360 - Temporarily Unavailable)
+
+Generate high-quality text effects like Glitch, Neon, and Gold.
+
+**Supported Styles:** `glitchtext`, `writetext`, `advancedglow`, `typographytext`, `pixelglitch`, `neonglitch`, `flagtext`, `flag3dtext`, `deletingtext`, `blackpinkstyle`, `glowingtext`, `underwatertext`, `logomaker`, `cartoonstyle`, `papercutstyle`, `watercolortext`, `effectclouds`, `blackpinklogo`, `gradienttext`, `summerbeach`, `luxurygold`, `multicoloredneon`, `sandsummer`, `galaxywallpaper`, `1917style`, `makingneon`, `royaltext`, `freecreate`, `galaxystyle`, `lighteffects`
+
+```javascript
+import { tools } from '@heavstaltech/api';
+
+const imageUrl = await tools.ephoto("glitchtext", "Heavstal Tech");
+console.log(imageUrl); 
+// Output: https://en.ephoto360.com/....jpg
+```
+
+
+#### Lyrics Search
+Fetch song lyrics and metadata. Uses a robust multi-source engine (LRCLIB + Genius).
+
+```javascript
+import { search } from '@heavstaltech/api';
+
+const song = await search.lyrics("Kendrick Lamar DNA");
+
+console.log(`Title: ${song.title}`);
+console.log(`Artist: ${song.artist}`);
+console.log(`Lyrics:\n${song.lyrics}`);
+```
+
+#### Zip to Text Extractor (LLM Context)
+Download a remote ZIP file (like a GitHub repo), extract all files recursively, and compile them into a single text buffer. Perfect for feeding codebases to AI & others.
+
+```javascript
+import { tools } from '@heavstaltech/api';
+import fs from 'fs';
+
+// 1. Extract from URL
+const { buffer, filename } = await tools.unzip("https://github.com/octocat/Hello-World/archive/master.zip");
+
+// 2. Save to file
+fs.writeFileSync(filename, buffer);
+console.log("Extraction complete!");
+```
+
 ---
 
 ## 📝 License

package/dist/index.d.mts

@@ -73,6 +73,15 @@ interface TwitterResult {
     video_hd?: string;
     audio?: string;
 }
+interface LyricsResult {
+    author: Author;
+    status: boolean;
+    title: string;
+    artist: string;
+    image: string;
+    url: string;
+    lyrics: string;
+}
 
 /**
  * Main TikTok Function
@@ -126,6 +135,14 @@ declare const morse: (input: string, mode?: "encode" | "decode") => Promise<stri
 declare const tts: (text: string, lang?: string) => Promise<Buffer>;
 declare const chords: (query: string) => Promise<any>;
 
+declare const lyrics: (query: string) => Promise<LyricsResult>;
+
+declare const unzipToText: (url: string) => Promise<{
+    author: typeof AUTHOR;
+    buffer: Buffer;
+    filename: string;
+}>;
+
 declare const downloader: {
     tiktok: (input: string) => Promise<TikTokResult>;
     tiktokSlide: (url: string) => Promise<TikTokResult>;
@@ -141,10 +158,21 @@ declare const search: {
     youtube: (query: string) => Promise<YouTubeSearchResult[]>;
     wattpad: (query: string) => Promise<any[]>;
     chords: (query: string) => Promise<any>;
+    lyrics: (query: string) => Promise<LyricsResult>;
 };
 declare const tools: {
     ssweb: (url: string, device?: "desktop" | "tablet" | "phone") => Promise<Buffer>;
     remini: (imageUrl: string, method?: "enhance" | "recolor" | "dehaze") => Promise<Buffer>;
+    unzipToText: (url: string) => Promise<{
+        author: typeof AUTHOR;
+        buffer: Buffer;
+        filename: string;
+    }>;
+    unzip: (url: string) => Promise<{
+        author: typeof AUTHOR;
+        buffer: Buffer;
+        filename: string;
+    }>;
     styleText: (text: string) => Promise<{
         author: Author;
         name: string;
@@ -169,10 +197,21 @@ declare const _default: {
         youtube: (query: string) => Promise<YouTubeSearchResult[]>;
         wattpad: (query: string) => Promise<any[]>;
         chords: (query: string) => Promise<any>;
+        lyrics: (query: string) => Promise<LyricsResult>;
     };
     tools: {
         ssweb: (url: string, device?: "desktop" | "tablet" | "phone") => Promise<Buffer>;
         remini: (imageUrl: string, method?: "enhance" | "recolor" | "dehaze") => Promise<Buffer>;
+        unzipToText: (url: string) => Promise<{
+            author: typeof AUTHOR;
+            buffer: Buffer;
+            filename: string;
+        }>;
+        unzip: (url: string) => Promise<{
+            author: typeof AUTHOR;
+            buffer: Buffer;
+            filename: string;
+        }>;
         styleText: (text: string) => Promise<{
             author: Author;
             name: string;
@@ -183,4 +222,4 @@ declare const _default: {
     };
 };
 
-export { AUTHOR, type Author, type SocialResult, type TikTokResult, type TwitterResult, type UtilsResult, type YouTubeResult, type YouTubeSearchResult, chords, _default as default, downloader, fbdl, igdl, morse, play, remini, search, ssweb, styleText, tiktok, tiktokSlide, tools, tts, twitter, wattpad, twitter as xdl, search$1 as ytSearch, ytmp3, ytmp4 };
+export { AUTHOR, type Author, type LyricsResult, type SocialResult, type TikTokResult, type TwitterResult, type UtilsResult, type YouTubeResult, type YouTubeSearchResult, chords, _default as default, downloader, fbdl, igdl, lyrics, morse, play, remini, search, ssweb, styleText, tiktok, tiktokSlide, tools, tts, twitter, unzipToText, wattpad, twitter as xdl, search$1 as ytSearch, ytmp3, ytmp4 };

package/dist/index.d.ts

@@ -73,6 +73,15 @@ interface TwitterResult {
     video_hd?: string;
     audio?: string;
 }
+interface LyricsResult {
+    author: Author;
+    status: boolean;
+    title: string;
+    artist: string;
+    image: string;
+    url: string;
+    lyrics: string;
+}
 
 /**
  * Main TikTok Function
@@ -126,6 +135,14 @@ declare const morse: (input: string, mode?: "encode" | "decode") => Promise<stri
 declare const tts: (text: string, lang?: string) => Promise<Buffer>;
 declare const chords: (query: string) => Promise<any>;
 
+declare const lyrics: (query: string) => Promise<LyricsResult>;
+
+declare const unzipToText: (url: string) => Promise<{
+    author: typeof AUTHOR;
+    buffer: Buffer;
+    filename: string;
+}>;
+
 declare const downloader: {
     tiktok: (input: string) => Promise<TikTokResult>;
     tiktokSlide: (url: string) => Promise<TikTokResult>;
@@ -141,10 +158,21 @@ declare const search: {
     youtube: (query: string) => Promise<YouTubeSearchResult[]>;
     wattpad: (query: string) => Promise<any[]>;
     chords: (query: string) => Promise<any>;
+    lyrics: (query: string) => Promise<LyricsResult>;
 };
 declare const tools: {
     ssweb: (url: string, device?: "desktop" | "tablet" | "phone") => Promise<Buffer>;
     remini: (imageUrl: string, method?: "enhance" | "recolor" | "dehaze") => Promise<Buffer>;
+    unzipToText: (url: string) => Promise<{
+        author: typeof AUTHOR;
+        buffer: Buffer;
+        filename: string;
+    }>;
+    unzip: (url: string) => Promise<{
+        author: typeof AUTHOR;
+        buffer: Buffer;
+        filename: string;
+    }>;
     styleText: (text: string) => Promise<{
         author: Author;
         name: string;
@@ -169,10 +197,21 @@ declare const _default: {
         youtube: (query: string) => Promise<YouTubeSearchResult[]>;
         wattpad: (query: string) => Promise<any[]>;
         chords: (query: string) => Promise<any>;
+        lyrics: (query: string) => Promise<LyricsResult>;
     };
     tools: {
         ssweb: (url: string, device?: "desktop" | "tablet" | "phone") => Promise<Buffer>;
         remini: (imageUrl: string, method?: "enhance" | "recolor" | "dehaze") => Promise<Buffer>;
+        unzipToText: (url: string) => Promise<{
+            author: typeof AUTHOR;
+            buffer: Buffer;
+            filename: string;
+        }>;
+        unzip: (url: string) => Promise<{
+            author: typeof AUTHOR;
+            buffer: Buffer;
+            filename: string;
+        }>;
         styleText: (text: string) => Promise<{
             author: Author;
             name: string;
@@ -183,4 +222,4 @@ declare const _default: {
     };
 };
 
-export { AUTHOR, type Author, type SocialResult, type TikTokResult, type TwitterResult, type UtilsResult, type YouTubeResult, type YouTubeSearchResult, chords, _default as default, downloader, fbdl, igdl, morse, play, remini, search, ssweb, styleText, tiktok, tiktokSlide, tools, tts, twitter, wattpad, twitter as xdl, search$1 as ytSearch, ytmp3, ytmp4 };
+export { AUTHOR, type Author, type LyricsResult, type SocialResult, type TikTokResult, type TwitterResult, type UtilsResult, type YouTubeResult, type YouTubeSearchResult, chords, _default as default, downloader, fbdl, igdl, lyrics, morse, play, remini, search, ssweb, styleText, tiktok, tiktokSlide, tools, tts, twitter, unzipToText, wattpad, twitter as xdl, search$1 as ytSearch, ytmp3, ytmp4 };

package/dist/index.js

@@ -8,6 +8,7 @@ var ytdl = require('@distube/ytdl-core');
 var yts = require('yt-search');
 var FormData = require('form-data');
 var https = require('https');
+var AdmZip = require('adm-zip');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -35,6 +36,7 @@ var ytdl__default = /*#__PURE__*/_interopDefault(ytdl);
 var yts__default = /*#__PURE__*/_interopDefault(yts);
 var FormData__default = /*#__PURE__*/_interopDefault(FormData);
 var https__default = /*#__PURE__*/_interopDefault(https);
+var AdmZip__default = /*#__PURE__*/_interopDefault(AdmZip);
 
 // src/dl/tiktok.ts
 
@@ -728,6 +730,195 @@ var chords = async (query) => {
     throw new Error(`Chords Failed: ${error.message}`);
   }
 };
+var USER_AGENTS4 = [
+  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+];
+var getRandomHeaders4 = () => ({
+  "User-Agent": USER_AGENTS4[Math.floor(Math.random() * USER_AGENTS4.length)]
+});
+var fetchLrcLib = async (query) => {
+  const searchUrl = `https://lrclib.net/api/search?q=${encodeURIComponent(query)}`;
+  const { data } = await axios4__default.default.get(searchUrl, { headers: getRandomHeaders4() });
+  if (!Array.isArray(data) || data.length === 0) {
+    throw new Error("No lyrics found on LRCLIB.");
+  }
+  const track = data.find((t) => t.plainLyrics) || data[0];
+  if (!track.plainLyrics && !track.syncedLyrics) {
+    throw new Error("Track found but no lyrics content.");
+  }
+  return {
+    author: AUTHOR,
+    status: true,
+    title: track.trackName,
+    artist: track.artistName,
+    image: track.albumArt || "https://ibb.co/fVyg0TN6",
+    url: `https://lrclib.net/api/get/${track.id}`,
+    lyrics: track.plainLyrics || track.syncedLyrics
+  };
+};
+var fetchGenius = async (query) => {
+  const searchUrl = `https://genius.com/api/search/multi?per_page=1&q=${encodeURIComponent(query)}`;
+  const { data } = await axios4__default.default.get(searchUrl, {
+    headers: { ...getRandomHeaders4(), "Referer": "https://genius.com/" }
+  });
+  const hit = data.response?.sections?.find((s) => s.type === "song")?.hits?.[0]?.result;
+  if (!hit) throw new Error("No songs found on Genius.");
+  return {
+    author: AUTHOR,
+    status: true,
+    title: hit.title,
+    artist: hit.artist_names,
+    image: hit.song_art_image_thumbnail_url,
+    url: hit.url,
+    lyrics: `[Lyrics available at source]
+${hit.url}`
+  };
+};
+var lyrics = async (query) => {
+  try {
+    return await fetchLrcLib(query);
+  } catch (lrcError) {
+    try {
+      return await fetchGenius(query);
+    } catch (geniusError) {
+      throw new Error(`Lyrics lookup failed. LRCLIB: ${lrcError}. Genius: ${geniusError.message}`);
+    }
+  }
+};
+var USER_AGENTS5 = [
+  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+];
+var TEXT_EXTENSIONS = [
+  "js",
+  "ts",
+  "jsx",
+  "tsx",
+  "json",
+  "html",
+  "css",
+  "scss",
+  "less",
+  "md",
+  "txt",
+  "yml",
+  "yaml",
+  "sql",
+  "py",
+  "java",
+  "c",
+  "cpp",
+  "h",
+  "cs",
+  "php",
+  "rb",
+  "go",
+  "rs",
+  "swift",
+  "kt",
+  "xml",
+  "svg",
+  "env",
+  "gitignore",
+  "dockerfile",
+  "sh",
+  "bat",
+  "conf",
+  "ini",
+  "properties"
+];
+var BINARY_EXTENSIONS = [
+  "png",
+  "jpg",
+  "jpeg",
+  "gif",
+  "webp",
+  "ico",
+  "bmp",
+  "tiff",
+  "mp3",
+  "wav",
+  "ogg",
+  "mp4",
+  "webm",
+  "mov",
+  "mkv",
+  "zip",
+  "tar",
+  "gz",
+  "7z",
+  "rar"
+];
+var unzipToText = async (url) => {
+  try {
+    const response = await axios4__default.default.get(url, {
+      responseType: "arraybuffer",
+      headers: {
+        "User-Agent": USER_AGENTS5[Math.floor(Math.random() * USER_AGENTS5.length)]
+      }
+    });
+    const zipBuffer = Buffer.from(response.data);
+    const zip = new AdmZip__default.default(zipBuffer);
+    const zipEntries = zip.getEntries();
+    let output = `EXTRACTED BY HEAVSTAL TECH
+SOURCE: ${url}
+DATE: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+`;
+    for (const entry of zipEntries) {
+      if (entry.isDirectory) continue;
+      const path = entry.entryName;
+      const ext = path.split(".").pop()?.toLowerCase() || "";
+      output += `================================================================================
+`;
+      output += `FILE: ${path}
+`;
+      output += `================================================================================
+`;
+      try {
+        if (ext === "pdf") {
+          output += `[File contents not extracted - PDF Document]
+
+`;
+        } else if (BINARY_EXTENSIONS.includes(ext)) {
+          const b64 = entry.getData().toString("base64");
+          const mime = ext === "mp3" ? "audio/mpeg" : `image/${ext}`;
+          output += `data:${mime};base64,${b64}
+
+`;
+        } else if (TEXT_EXTENSIONS.includes(ext) || !ext) {
+          const content = entry.getData().toString("utf8");
+          output += `${content}
+
+`;
+        } else {
+          const buffer = entry.getData();
+          if (buffer.includes(0)) {
+            output += `data:application/octet-stream;base64,${buffer.toString("base64")}
+
+`;
+          } else {
+            output += `${buffer.toString("utf8")}
+
+`;
+          }
+        }
+      } catch (err) {
+        output += `[Error reading file: ${err.message}]
+
+`;
+      }
+    }
+    return {
+      author: AUTHOR,
+      buffer: Buffer.from(output, "utf-8"),
+      filename: "extracted_codebase.txt"
+    };
+  } catch (error) {
+    throw new Error(`Unzip Failed: ${error.message}`);
+  }
+};
 
 // src/index.ts
 var downloader = {
@@ -744,14 +935,18 @@ var downloader = {
 var search2 = {
   youtube: search,
   wattpad,
-  chords
+  chords,
+  lyrics
 };
 var tools = {
   ssweb,
   remini,
+  unzipToText,
+  unzip: unzipToText,
   styleText,
   morse,
   tts
+  //  ephoto
 };
 var index_default = {
   downloader,
@@ -765,6 +960,7 @@ exports.default = index_default;
 exports.downloader = downloader;
 exports.fbdl = fbdl;
 exports.igdl = igdl;
+exports.lyrics = lyrics;
 exports.morse = morse;
 exports.play = play;
 exports.remini = remini;
@@ -776,6 +972,7 @@ exports.tiktokSlide = tiktokSlide;
 exports.tools = tools;
 exports.tts = tts;
 exports.twitter = twitter;
+exports.unzipToText = unzipToText;
 exports.wattpad = wattpad;
 exports.xdl = twitter;
 exports.ytSearch = search;