@heavstal/api 2.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HEAVSTAL TECH™
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,224 @@
+<div align="center">
+  <img src="https://heavstal.com.ng/ht_icon.svg" width="120" alt="Heavstal Tech Logo" />
+  <h1>@heavstal/api</h1>
+
+  <p>
+    <img alt="NPM Version" src="https://img.shields.io/npm/v/@heavstal/api?style=flat-square">
+    <img alt="Build Status" src="https://img.shields.io/github/actions/workflow/status/HeavstalTech/heavstaltech-api/test.yml?style=flat-square&label=tests">
+    <img alt="License" src="https://img.shields.io/npm/l/@heavstal/api?style=flat-square">
+  </p>
+</div>
+
+> [!WARNING]
+> **Migration Notice:** `@heavstaltech/api` has been renamed to **[@heavstal/api](https://www.npmjs.com/package/@heavstal/api)**. 
+> The legacy `@heavstaltech/api` package is now deprecated. Please update your dependencies to continue receiving security updates and new features.
+
+
+A powerful, zero-dependency multi-purpose SDK client for interacting with Heavstal Tech API Utilities. Supports ESM and CJS.
+
+This module provides streamlined programmatic access to media parsing, search engines, file compilation, and AI utility tools without requiring external dependencies like Puppeteer or Axios.
+
+---
+
+## Installation
+
+Install via npm:
+
+```bash
+npm install @heavstal/api
+```
+
+Install via yarn:
+
+```bash
+yarn add @heavstal/api
+```
+
+---
+
+## Authentication
+
+To use this SDK, you must have a valid API Key from [Heavstal Tech Credentials](https://heavstal.com.ng/credentials). The SDK supports two methods of authentication:
+
+### 1. Environment Variable (Recommended)
+The SDK will automatically detect your API key if it is set in your environment variables.
+
+```env
+# .env
+HEAVSTAL_API_KEY=ht_live_your_api_key_here
+```
+
+### 2. Manual Configuration Object
+If you prefer not to use environment variables, or need to switch keys dynamically, you can pass a configuration object as the final argument to any function.
+
+```javascript
+const config = { apiKey: "ht_live_your_api_key_here" };
+
+// Example passing the config
+const result = await downloader.tiktok("https://vt.tiktok.com/...", config);
+```
+
+---
+
+## Usage
+
+This library is a hybrid module, meaning it seamlessly supports both **CommonJS (`require`)** and **ES Modules (`import`)**.
+
+### ES Modules / TypeScript (`import`)
+```typescript
+import { downloader, search, tools } from '@heavstal/api';
+
+// Or import specific standalone methods
+import { tiktok, apk, unzipToText } from '@heavstal/api';
+```
+
+### CommonJS (`require`)
+```javascript
+const { downloader, search, tools } = require('@heavstal/api');
+
+// Or require specific standalone methods
+const { tiktok, apk, unzipToText } = require('@heavstal/api');
+```
+
+---
+
+## API Documentation
+
+### 1. Social Media Utilities
+
+**TikTok (Video & Slides)**
+Extract videos without watermarks, audio tracks, and slide images.
+```javascript
+// Video Extraction
+const video = await downloader.tiktok("https://vt.tiktok.com/..."); 
+console.log(video.no_watermark);
+
+// Image Slides Extraction
+const slide = await downloader.tiktokSlide("https://vt.tiktok.com/...");
+console.log(slide.slideImages);
+```
+
+**Instagram (Reels, Images, Videos)**
+Extract media from public Instagram posts.
+```javascript
+const ig = await downloader.igdl("https://www.instagram.com/p/...");
+console.log(ig);
+```
+
+**Facebook**
+Extract public Facebook Watch and post videos.
+```javascript
+const fb = await downloader.fbdl("https://fb.watch/...");
+```
+
+**Twitter / X**
+Extract media from X.com (Twitter). Returns standard and high-definition video links.
+```javascript
+const tweet = await downloader.xdl("https://x.com/user/status/...");
+console.log(tweet.video_hd);
+```
+
+### 2. YouTube Search & Extraction
+
+**Search**
+```javascript
+const results = await search.youtube("No Copyright Sounds");
+console.log(results[0].url); 
+```
+
+**Extract Audio / Video**
+```javascript
+// Extract MP3 Audio
+const audio = await downloader.ytmp3("https://youtu.be/...");
+
+// Extract MP4 Video
+const video = await downloader.ytmp4("https://youtu.be/...");
+
+// Play (Search and instantly extract first result)
+const song = await downloader.play("Adele Hello", "mp3");
+```
+
+### 3. Search Utilities
+
+**APK Metadata & Downloads**
+Search for Android applications and fetch high-speed download links.
+```javascript
+const app = await search.apk("WhatsApp");
+console.log(`Version: ${app.version} | Link: ${app.dl_url}`);
+```
+
+**Song Lyrics (LRCLIB & Genius)**
+Fetch accurate song metadata and lyrics.
+```javascript
+const song = await search.lyrics("Kendrick Lamar DNA");
+console.log(song.lyrics);
+```
+
+**Wattpad & Chords**
+```javascript
+// Search Wattpad stories
+const stories = await search.wattpad("Science Fiction");
+
+// Fetch Guitar Chords
+const chords = await search.chords("Ed Sheeran Perfect");
+```
+
+### 4. General & AI Tools
+
+**Repository/ZIP to Text Extractor**
+Downloads a remote ZIP file, recursively extracts it, and compiles it into a single text buffer. Highly optimized for feeding codebases into Large Language Models (LLMs).
+```javascript
+const fs = require('fs');
+
+// includeBinary: false skips images/PDFs, perfect for text/code extraction
+const codebase = await tools.unzip("https://github.com/user/repo/archive/main.zip", { 
+  includeBinary: false 
+});
+
+fs.writeFileSync(codebase.filename, codebase.buffer);
+```
+
+
+**Text to Speech (Google TTS)**
+Convert text into spoken audio buffer.
+```javascript
+// Second argument is the language code (e.g., 'en', 'ja', 'es')
+const audioBuffer = await tools.tts("Hello World", "en");
+```
+
+**Website Screenshot**
+Capture responsive screenshots of any given URL.
+```javascript
+// Device options: 'desktop', 'tablet', 'phone'
+const imgBuffer = await tools.ssweb("https://google.com", "desktop");
+```
+
+**Text Styling & Morse Code**
+```javascript
+// Generate stylized text variations
+const fonts = await tools.styleText("Heavstal Tech");
+
+// Morse code encoding/decoding
+const morseStr = await tools.morse("HELLO", "encode"); // Output: .... . .-.. .-.. ---
+```
+
+---
+
+## Heavstal Tech Ecosystem
+
+This package is part of the Heavstal Tech platform. For endpoint documentation, uptime status, and higher rate limits, please visit our official portals:
+
+* **Documentation:** [https://docs.heavstal.com.ng](https://docs.heavstal.com.ng)
+* **API Key:** [https://heavstal.com.ng/credentials](https://heavstal.com.ng/credentials)
+* **Pricing:** [https://heavstal.com.ng/pricing](https://heavstal.com.ng/pricing)
+
+---
+
+## License
+
+This project is licensed under the **MIT License**.
+
+<div align="center">
+  <p>Maintained by <a href="https://heavstal.com.ng">HEAVSTAL TECH</a></p>
+  <p><i>Building Tomorrow's Web, Today.</i></p>
+</div>

package/dist/index.d.mts

@@ -0,0 +1,221 @@
+interface Author {
+    name: string;
+    source: string;
+}
+declare const AUTHOR: Author;
+interface TikTokResult {
+    author: Author;
+    status: boolean;
+    title: string;
+    cover?: string;
+    origin_cover?: string;
+    no_watermark?: string;
+    watermark?: string;
+    music?: string;
+    views?: number | string;
+    likes?: number | string;
+    comments?: number | string;
+    shares?: number | string;
+    downloads?: number | string;
+    uniqueId?: string;
+    profileUrl?: string;
+    profileImage?: string;
+    hashtags?: string[];
+    slideImages?: string[];
+    author_name?: string;
+}
+interface SocialResult {
+    author: Author;
+    status: boolean;
+    type: 'video' | 'image';
+    title?: string;
+    thumbnail?: string;
+    url: string;
+}
+interface YouTubeResult {
+    author: Author;
+    title: string;
+    thumbnail: string;
+    channel: string;
+    published: string;
+    views: string;
+    url: string;
+    duration?: number | string;
+    status?: boolean;
+}
+interface YouTubeSearchResult {
+    type: 'video' | 'channel' | 'list' | 'live';
+    url: string;
+    title: string;
+    description?: string;
+    image?: string;
+    thumbnail?: string;
+    seconds?: number;
+    timestamp?: string;
+    views?: number;
+    ago?: string;
+    author?: {
+        name: string;
+        url: string;
+    };
+}
+interface UtilsResult {
+    author: Author;
+    status: boolean;
+    data: Buffer | string | any;
+}
+interface TwitterResult {
+    author: Author;
+    status: boolean;
+    desc: string;
+    thumbnail: string;
+    video_sd?: string;
+    video_hd?: string;
+    audio?: string;
+}
+interface LyricsResult {
+    author: Author;
+    status: boolean;
+    title: string;
+    artist: string;
+    image: string;
+    url: string;
+    lyrics: string;
+}
+interface ApkResult {
+    author: Author;
+    status: boolean;
+    name: string;
+    package_id: string;
+    version: string;
+    downloads: number;
+    size: string;
+    icon: string;
+    dl_url: string;
+    last_updated?: string;
+}
+interface HeavstalConfig {
+    apiKey?: string;
+}
+
+interface UnzipOptions {
+    includeBinary?: boolean;
+}
+declare const unzipToText: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+    author: typeof AUTHOR;
+    buffer: Buffer;
+    filename: string;
+}>;
+
+declare const tiktok: (input: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+declare const tiktokSlide: (url: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+
+declare const fbdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+declare const igdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+
+declare const twitter: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+
+declare const search$1: (query: string, config?: HeavstalConfig) => Promise<YouTubeSearchResult[]>;
+declare const ytmp3: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+declare const ytmp4: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+declare const play: (query: string, format?: "mp3" | "mp4", config?: HeavstalConfig) => Promise<YouTubeResult>;
+
+declare const ssweb: (url: string, device?: "desktop" | "tablet" | "phone", config?: HeavstalConfig) => Promise<Buffer>;
+declare const styleText: (text: string, config?: HeavstalConfig) => Promise<{
+    author: Author;
+    name: string;
+    result: string;
+}[]>;
+declare const wattpad: (query: string, config?: HeavstalConfig) => Promise<any[]>;
+declare const morse: (input: string, mode?: "encode" | "decode", config?: HeavstalConfig) => Promise<string>;
+declare const tts: (text: string, lang?: string, config?: HeavstalConfig) => Promise<Buffer>;
+declare const chords: (query: string, config?: HeavstalConfig) => Promise<any>;
+
+declare const ephoto: (style: string, text: string, config?: HeavstalConfig) => Promise<string>;
+
+declare const lyrics: (query: string, config?: HeavstalConfig) => Promise<LyricsResult>;
+
+declare const apk: (query: string, config?: HeavstalConfig) => Promise<ApkResult>;
+
+declare const downloader: {
+    tiktok: (input: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+    tiktokSlide: (url: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+    igdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+    fbdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+    twitter: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+    xdl: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+    ytmp3: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+    ytmp4: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+    play: (query: string, format?: "mp3" | "mp4", config?: HeavstalConfig) => Promise<YouTubeResult>;
+};
+declare const search: {
+    youtube: (query: string, config?: HeavstalConfig) => Promise<YouTubeSearchResult[]>;
+    wattpad: (query: string, config?: HeavstalConfig) => Promise<any[]>;
+    chords: (query: string, config?: HeavstalConfig) => Promise<any>;
+    lyrics: (query: string, config?: HeavstalConfig) => Promise<LyricsResult>;
+    apk: (query: string, config?: HeavstalConfig) => Promise<ApkResult>;
+};
+declare const tools: {
+    ssweb: (url: string, device?: "desktop" | "tablet" | "phone", config?: HeavstalConfig) => Promise<Buffer>;
+    unzipToText: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+        author: typeof AUTHOR;
+        buffer: Buffer;
+        filename: string;
+    }>;
+    unzip: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+        author: typeof AUTHOR;
+        buffer: Buffer;
+        filename: string;
+    }>;
+    styleText: (text: string, config?: HeavstalConfig) => Promise<{
+        author: Author;
+        name: string;
+        result: string;
+    }[]>;
+    morse: (input: string, mode?: "encode" | "decode", config?: HeavstalConfig) => Promise<string>;
+    tts: (text: string, lang?: string, config?: HeavstalConfig) => Promise<Buffer>;
+    ephoto: (style: string, text: string, config?: HeavstalConfig) => Promise<string>;
+};
+declare const _default: {
+    downloader: {
+        tiktok: (input: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+        tiktokSlide: (url: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+        igdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+        fbdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+        twitter: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+        xdl: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+        ytmp3: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+        ytmp4: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+        play: (query: string, format?: "mp3" | "mp4", config?: HeavstalConfig) => Promise<YouTubeResult>;
+    };
+    search: {
+        youtube: (query: string, config?: HeavstalConfig) => Promise<YouTubeSearchResult[]>;
+        wattpad: (query: string, config?: HeavstalConfig) => Promise<any[]>;
+        chords: (query: string, config?: HeavstalConfig) => Promise<any>;
+        lyrics: (query: string, config?: HeavstalConfig) => Promise<LyricsResult>;
+        apk: (query: string, config?: HeavstalConfig) => Promise<ApkResult>;
+    };
+    tools: {
+        ssweb: (url: string, device?: "desktop" | "tablet" | "phone", config?: HeavstalConfig) => Promise<Buffer>;
+        unzipToText: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+            author: typeof AUTHOR;
+            buffer: Buffer;
+            filename: string;
+        }>;
+        unzip: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+            author: typeof AUTHOR;
+            buffer: Buffer;
+            filename: string;
+        }>;
+        styleText: (text: string, config?: HeavstalConfig) => Promise<{
+            author: Author;
+            name: string;
+            result: string;
+        }[]>;
+        morse: (input: string, mode?: "encode" | "decode", config?: HeavstalConfig) => Promise<string>;
+        tts: (text: string, lang?: string, config?: HeavstalConfig) => Promise<Buffer>;
+        ephoto: (style: string, text: string, config?: HeavstalConfig) => Promise<string>;
+    };
+};
+
+export { AUTHOR, type ApkResult, type Author, type HeavstalConfig, type LyricsResult, type SocialResult, type TikTokResult, type TwitterResult, type UtilsResult, type YouTubeResult, type YouTubeSearchResult, apk, chords, _default as default, downloader, ephoto, fbdl, igdl, lyrics, morse, play, search, ssweb, styleText, tiktok, tiktokSlide, tools, tts, twitter, unzipToText, wattpad, twitter as xdl, search$1 as ytSearch, ytmp3, ytmp4 };

package/dist/index.d.ts

@@ -0,0 +1,221 @@
+interface Author {
+    name: string;
+    source: string;
+}
+declare const AUTHOR: Author;
+interface TikTokResult {
+    author: Author;
+    status: boolean;
+    title: string;
+    cover?: string;
+    origin_cover?: string;
+    no_watermark?: string;
+    watermark?: string;
+    music?: string;
+    views?: number | string;
+    likes?: number | string;
+    comments?: number | string;
+    shares?: number | string;
+    downloads?: number | string;
+    uniqueId?: string;
+    profileUrl?: string;
+    profileImage?: string;
+    hashtags?: string[];
+    slideImages?: string[];
+    author_name?: string;
+}
+interface SocialResult {
+    author: Author;
+    status: boolean;
+    type: 'video' | 'image';
+    title?: string;
+    thumbnail?: string;
+    url: string;
+}
+interface YouTubeResult {
+    author: Author;
+    title: string;
+    thumbnail: string;
+    channel: string;
+    published: string;
+    views: string;
+    url: string;
+    duration?: number | string;
+    status?: boolean;
+}
+interface YouTubeSearchResult {
+    type: 'video' | 'channel' | 'list' | 'live';
+    url: string;
+    title: string;
+    description?: string;
+    image?: string;
+    thumbnail?: string;
+    seconds?: number;
+    timestamp?: string;
+    views?: number;
+    ago?: string;
+    author?: {
+        name: string;
+        url: string;
+    };
+}
+interface UtilsResult {
+    author: Author;
+    status: boolean;
+    data: Buffer | string | any;
+}
+interface TwitterResult {
+    author: Author;
+    status: boolean;
+    desc: string;
+    thumbnail: string;
+    video_sd?: string;
+    video_hd?: string;
+    audio?: string;
+}
+interface LyricsResult {
+    author: Author;
+    status: boolean;
+    title: string;
+    artist: string;
+    image: string;
+    url: string;
+    lyrics: string;
+}
+interface ApkResult {
+    author: Author;
+    status: boolean;
+    name: string;
+    package_id: string;
+    version: string;
+    downloads: number;
+    size: string;
+    icon: string;
+    dl_url: string;
+    last_updated?: string;
+}
+interface HeavstalConfig {
+    apiKey?: string;
+}
+
+interface UnzipOptions {
+    includeBinary?: boolean;
+}
+declare const unzipToText: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+    author: typeof AUTHOR;
+    buffer: Buffer;
+    filename: string;
+}>;
+
+declare const tiktok: (input: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+declare const tiktokSlide: (url: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+
+declare const fbdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+declare const igdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+
+declare const twitter: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+
+declare const search$1: (query: string, config?: HeavstalConfig) => Promise<YouTubeSearchResult[]>;
+declare const ytmp3: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+declare const ytmp4: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+declare const play: (query: string, format?: "mp3" | "mp4", config?: HeavstalConfig) => Promise<YouTubeResult>;
+
+declare const ssweb: (url: string, device?: "desktop" | "tablet" | "phone", config?: HeavstalConfig) => Promise<Buffer>;
+declare const styleText: (text: string, config?: HeavstalConfig) => Promise<{
+    author: Author;
+    name: string;
+    result: string;
+}[]>;
+declare const wattpad: (query: string, config?: HeavstalConfig) => Promise<any[]>;
+declare const morse: (input: string, mode?: "encode" | "decode", config?: HeavstalConfig) => Promise<string>;
+declare const tts: (text: string, lang?: string, config?: HeavstalConfig) => Promise<Buffer>;
+declare const chords: (query: string, config?: HeavstalConfig) => Promise<any>;
+
+declare const ephoto: (style: string, text: string, config?: HeavstalConfig) => Promise<string>;
+
+declare const lyrics: (query: string, config?: HeavstalConfig) => Promise<LyricsResult>;
+
+declare const apk: (query: string, config?: HeavstalConfig) => Promise<ApkResult>;
+
+declare const downloader: {
+    tiktok: (input: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+    tiktokSlide: (url: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+    igdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+    fbdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+    twitter: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+    xdl: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+    ytmp3: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+    ytmp4: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+    play: (query: string, format?: "mp3" | "mp4", config?: HeavstalConfig) => Promise<YouTubeResult>;
+};
+declare const search: {
+    youtube: (query: string, config?: HeavstalConfig) => Promise<YouTubeSearchResult[]>;
+    wattpad: (query: string, config?: HeavstalConfig) => Promise<any[]>;
+    chords: (query: string, config?: HeavstalConfig) => Promise<any>;
+    lyrics: (query: string, config?: HeavstalConfig) => Promise<LyricsResult>;
+    apk: (query: string, config?: HeavstalConfig) => Promise<ApkResult>;
+};
+declare const tools: {
+    ssweb: (url: string, device?: "desktop" | "tablet" | "phone", config?: HeavstalConfig) => Promise<Buffer>;
+    unzipToText: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+        author: typeof AUTHOR;
+        buffer: Buffer;
+        filename: string;
+    }>;
+    unzip: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+        author: typeof AUTHOR;
+        buffer: Buffer;
+        filename: string;
+    }>;
+    styleText: (text: string, config?: HeavstalConfig) => Promise<{
+        author: Author;
+        name: string;
+        result: string;
+    }[]>;
+    morse: (input: string, mode?: "encode" | "decode", config?: HeavstalConfig) => Promise<string>;
+    tts: (text: string, lang?: string, config?: HeavstalConfig) => Promise<Buffer>;
+    ephoto: (style: string, text: string, config?: HeavstalConfig) => Promise<string>;
+};
+declare const _default: {
+    downloader: {
+        tiktok: (input: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+        tiktokSlide: (url: string, config?: HeavstalConfig) => Promise<TikTokResult>;
+        igdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+        fbdl: (url: string, config?: HeavstalConfig) => Promise<SocialResult[]>;
+        twitter: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+        xdl: (url: string, config?: HeavstalConfig) => Promise<TwitterResult>;
+        ytmp3: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+        ytmp4: (url: string, config?: HeavstalConfig) => Promise<YouTubeResult>;
+        play: (query: string, format?: "mp3" | "mp4", config?: HeavstalConfig) => Promise<YouTubeResult>;
+    };
+    search: {
+        youtube: (query: string, config?: HeavstalConfig) => Promise<YouTubeSearchResult[]>;
+        wattpad: (query: string, config?: HeavstalConfig) => Promise<any[]>;
+        chords: (query: string, config?: HeavstalConfig) => Promise<any>;
+        lyrics: (query: string, config?: HeavstalConfig) => Promise<LyricsResult>;
+        apk: (query: string, config?: HeavstalConfig) => Promise<ApkResult>;
+    };
+    tools: {
+        ssweb: (url: string, device?: "desktop" | "tablet" | "phone", config?: HeavstalConfig) => Promise<Buffer>;
+        unzipToText: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+            author: typeof AUTHOR;
+            buffer: Buffer;
+            filename: string;
+        }>;
+        unzip: (url: string, options?: UnzipOptions, config?: HeavstalConfig) => Promise<{
+            author: typeof AUTHOR;
+            buffer: Buffer;
+            filename: string;
+        }>;
+        styleText: (text: string, config?: HeavstalConfig) => Promise<{
+            author: Author;
+            name: string;
+            result: string;
+        }[]>;
+        morse: (input: string, mode?: "encode" | "decode", config?: HeavstalConfig) => Promise<string>;
+        tts: (text: string, lang?: string, config?: HeavstalConfig) => Promise<Buffer>;
+        ephoto: (style: string, text: string, config?: HeavstalConfig) => Promise<string>;
+    };
+};
+
+export { AUTHOR, type ApkResult, type Author, type HeavstalConfig, type LyricsResult, type SocialResult, type TikTokResult, type TwitterResult, type UtilsResult, type YouTubeResult, type YouTubeSearchResult, apk, chords, _default as default, downloader, ephoto, fbdl, igdl, lyrics, morse, play, search, ssweb, styleText, tiktok, tiktokSlide, tools, tts, twitter, unzipToText, wattpad, twitter as xdl, search$1 as ytSearch, ytmp3, ytmp4 };