aqualink 2.3.2 → 2.4.0

package/README.md

@@ -1,76 +1,95 @@
-# AquaLink
-An Stable, performant, Recourse friendly and fast lavalink wrapper
-
-This code is based in riffy, but its an 100% Rewrite made from scratch...
-
-# Why use AquaLink
-- Only uses 1 dependecy (ws for websocket, atm)
-- HTTP1.1 / HTTP2 Support
-- Very Low memory comsuption
-- Built in Queue manager
-- Lots of features to use
-- Lowest CPU Usage
-- Very fast (mine take less than 1 second to load an song!)
-- 1 Player created = ~1 - 0,5 mb per player
-- Auto clean Up memory when song finishes / bot leave the vc (Now Options supported!)
-- Plugin system
-- Lavalink v4.0.8 | v4.1.0 Support (Nodelink works, but only with play etc, more support soon)
-- Youtube and Spotify support (Soundcloud, deezer, vimeo, etc also works...)
-- Minimal Requests to the lavalink server (helps the lavalink recourses!)
-- Playlist support (My mix playlists, youtube playlists, spotify playlists, etc)
-- Lyrics Support by Lavalink
-  - https://github.com/topi314/LavaLyrics (RECOMMENDED)
-  - https://github.com/DRSchlaubi/lyrics.kt (?)
-  - https://github.com/DuncteBot/java-timed-lyrics (RECOMMENDED)
-
-
-# Tralalero Tralala 2.3.0 Released
----
-
-- now is ~21% more lightweight, reduced disk space
-
-- Improved the `AQUA` module
-  - 3x better cleanup system
-  - Fixed some memory leaks
-  - Improved long process support
-  - Faster node caching
-
-- Remade the `Player` module
-  - Added circular buffer for previousTracks (way more memory efficient)
-  - Reorganized the event handlings
-  - Way better Memory management
-
-- Rewrite the `Node` system
-  - Fixed an memory leak in connections
-  - Improved the overal speed
-  - Improved code readbility / modules
-  - improved cleanup System
-  - Better long runtime
-  - Rewrite the Filter system
-
-- Improved `Rest` code
-  - Fixed lyrics (both search and get)
-  - Better chunks system for more performance
-
-- Improved `fetchImage` speed and recourses
-
-# Docs (Wiki)
-- https://toddythenoobdud.github.io/aqualink.github.io/
-
-- Example bot: https://github.com/ToddyTheNoobDud/Kenium-Music
-
-- Discord support: https://discord.com/invite/K4CVv84VBC
-
-
-# How to install
-
-`npm install aqualink`
-
-`pnpm install aqualink`
-
-# Basic usage
+<div align="center">
+
+<p align="center">
+  <img src="https://capsule-render.vercel.app/api?type=wave&color=0099FF&height=300&section=header&text=Aqualink&fontSize=90&fontAlignY=35&animation=twinkling&fontColor=ffffff&desc=The%20Ultimate%20Lavalink%20Wrapper&descSize=25&descAlignY=60" />
+</p>
+
+[![NPM Downloads](https://img.shields.io/npm/dw/aqualink.svg?style=for-the-badge&color=3498db)](https://www.npmjs.com/package/aqualink)
+[![NPM Version](https://img.shields.io/npm/v/aqualink?color=0061ff&label=Aqualink&style=for-the-badge&logo=npm)](https://www.npmjs.com/package/aqualink)
+[![GitHub Stars](https://img.shields.io/github/stars/ToddyTheNoobDud/AquaLink?color=00bfff&style=for-the-badge&logo=github)](https://github.com/ToddyTheNoobDud/AquaLink/stargazers)
+[![Discord](https://img.shields.io/discord/1346930640049803266?color=7289da&label=Discord&logo=discord&style=for-the-badge)](https://discord.gg/K4CVv84VBC)
+
+<br />
+
+<p align="center">
+  <img src="https://readme-typing-svg.herokuapp.com?font=Montserrat&duration=3000&pause=1000&color=0099FF&center=true&vCenter=true&width=600&lines=Powerful+Audio+Streaming+for+Discord+Bots;Optimized+for+Lavalink+v4+%26+Node.js;Industry-Leading+Performance;Easy+to+Implement%2C+Hard+to+Master" />
+</p>
+
+</div>
+
+<div align="center">
+  <h3>🌊 REIMAGINING AUDIO STREAMING FOR DISCORD 🌊</h3>
+  <h4>Experience crystal-clear audio with unmatched stability</h4>
+</div>
+
+<br />
+
+## 💎 Why Choose Aqualink?
+
+<div align="center">
+  <table>
+    <tr>
+      <td align="center" width="33%">
+        <h3>🚀</h3>
+        <h4>Performance First</h4>
+        <p>Optimized architecture with 50% less latency than other wrappers</p>
+      </td>
+      <td align="center" width="33%">
+        <h3>🛠️</h3>
+        <h4>Developer Friendly</h4>
+        <p>Intuitive API with extensive documentation and CJS/ESM support</p>
+      </td>
+      <td align="center" width="33%">
+        <h3>🔌</h3>
+        <h4>Extendable</h4>
+        <p>Plugin ecosystem for custom functionality and seamless integration</p>
+      </td>
+    </tr>
+  </table>
+</div>
+
+## 🔥 Feature Highlights
+
+<div align="center">
+  <table>
+    <tr>
+      <td align="center" width="25%">
+        <img src="https://img.icons8.com/fluent/48/000000/filter.png"/>
+        <h4>Advanced Filters</h4>
+        <p>EQ, Bass Boost, Nightcore & more</p>
+      </td>
+      <td align="center" width="25%">
+        <img src="https://img.icons8.com/fluent/48/000000/cloud-backup-restore.png"/>
+        <h4>Fail-Safe System</h4>
+        <p>Auto-reconnect & queue preservation</p>
+      </td>
+      <td align="center" width="25%">
+        <img src="https://img.icons8.com/fluent/48/000000/bar-chart.png"/>
+        <h4>Real-time Analytics</h4>
+        <p>Performance monitoring & insights</p>
+      </td>
+      <td align="center" width="25%">
+        <img src="https://img.icons8.com/fluent/48/000000/settings.png"/>
+        <h4>Customizable</h4>
+        <p>Adapt to your specific needs</p>
+      </td>
+    </tr>
+  </table>
+</div>
+
+## 📦 Resources
+
+<div align="center">
+  <a href="https://discord.gg/BNrPCvgrCf">
+    <img src="https://img.shields.io/badge/Support_Server-3498db?style=for-the-badge&logo=discord&logoColor=white" />
+  </a>
+</div>
+
+## 💻 Quick Start
 
 ```javascript
+npm install aqualink
+
 // If you're using Module, use this:
 // import { createRequire } from 'module';
 // const require = createRequire(import.meta.url);
@@ -141,8 +160,8 @@ client.on("messageCreate", async (message) => {
 
     if (resolve.loadType === 'playlist') {
         await message.channel.send(`Added ${resolve.tracks.length} songs from ${resolve.playlistInfo.name} playlist.`);
-        for (const track of result.tracks) {
-          player.queue.add(track);
+        for (const track of resolve.tracks) {
+            player.queue.add(track)
         }
         if (!player.playing && !player.paused) return player.play();
 
@@ -169,4 +188,163 @@ client.aqua.on("nodeError", (node, error) => {
 });
 
 client.login("Yourtokenhere");
-```
+```
+
+## 🌟 Featured Projects
+
+<div align="center">
+<table>
+<tr>
+<td align="center" width="50%">
+  <img width="120" height="120" src="https://img.icons8.com/fluent/240/000000/musical-notes.png"/>
+  <br/>
+  <img src="https://img.shields.io/badge/Rive-0061ff?style=for-the-badge&logo=discord&logoColor=white" /><br />
+  <a href="https://discord.com/oauth2/authorize?client_id=1350601402325405806">Add to Discord</a>
+</td>
+<td align="center" width="50%">
+  <img width="120" height="120" src="https://img.icons8.com/fluent/240/000000/water-element.png"/>
+  <br/>
+  <img src="https://img.shields.io/badge/Kenium-00bfff?style=for-the-badge&logo=discord&logoColor=white" /><br />
+  <a href="https://discord.com/oauth2/authorize?client_id=1202232935311495209">Add to Discord</a>
+</td>
+</tr>
+</table>
+</div>
+
+[View All Projects →](https://github.com/ToddyTheNoobDud/AquaLink#used-by)
+</div>
+
+
+**300+** weekly downloads • **3+** GitHub stars • **3+** Discord bots
+
+</div>
+
+## 📖 Documentation
+
+For detailed usage, API references, and examples, check out our official documentation:
+
+[![Docs](https://img.shields.io/badge/Documentation-0099FF?style=for-the-badge&logo=readthedocs&logoColor=white)](https://toddythenoobdud.github.io/aqualink.github.io)
+
+📌 **Get Started Quickly**
+- Installation guide
+- API methods
+- Advanced features
+- Troubleshooting
+
+🔗 Visit: **[Aqualink Docs](https://toddythenoobdud.github.io/aqualink.github.io)**
+
+## 👑 Premium Bots Using Aqualink
+
+| Bot | Invite Link | Features |
+|-----|-------------|----------|
+| Rive | [Add to Discord](https://discord.com/oauth2/authorize?client_id=1350601402325405806) | Music playback, Queue management |
+| Kenium | [Add to Discord](https://discord.com/oauth2/authorize?client_id=1202232935311495209) | Audio streaming, Discord integration |
+
+## 🛠️ Advanced Features
+
+<div align="center">
+  <table>
+    <tr>
+      <td>
+        <h4>🎛️ Audio Filters</h4>
+        <ul>
+          <li>Equalizer (15-band)</li>
+          <li>Bass Boost & Bass Cut</li>
+          <li>Nightcore & Vaporwave</li>
+          <li>8D Audio & Rotation</li>
+          <li>Karaoke & Channel Mixing</li>
+        </ul>
+      </td>
+      <td>
+        <h4>🔄 Queue Management</h4>
+        <ul>
+          <li>Shuffle & Loop modes</li>
+          <li>Queue history & navigation</li>
+          <li>Auto playlist continuation</li>
+          <li>Skip voting systems</li>
+          <li>Playlist import/export</li>
+        </ul>
+      </td>
+      <td>
+        <h4>📊 Monitoring</h4>
+        <ul>
+          <li>Resource utilization</li>
+          <li>Performance metrics</li>
+          <li>Automatic issue detection</li>
+          <li>Node health tracking</li>
+          <li>Load balancing</li>
+        </ul>
+      </td>
+    </tr>
+  </table>
+</div>
+
+## 👥 Contributors
+
+<div align="center">
+
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="50%">
+        <a href="https://github.com/pomicee">
+          <img src="https://avatars.githubusercontent.com/u/134554554?v=4?s=100" width="100px;" alt="pomicee"/>
+          <br />
+          <sub><b>pomicee</b></sub>
+        </a>
+        <br />
+        <a href="#code-pomicee" title="Code">💻</a>
+        <a href="#doc-pomicee" title="Documentation">📖</a>
+      </td>
+      <td align="center" valign="top" width="50%">
+        <a href="https://github.com/ToddyTheNoobDud">
+          <img src="https://avatars.githubusercontent.com/u/86982643?v=4?s=100" width="100px;" alt="ToddyTheNoobDud"/>
+          <br />
+          <sub><b>ToddyTheNoobDud</b></sub>
+        </a>
+        <br />
+        <a href="#code-ToddyTheNoobDud" title="Code">💻</a>
+        <a href="#doc-ToddyTheNoobDud" title="Documentation">📖</a>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+<br />
+
+[Become a contributor →](CONTRIBUTING.md)
+
+</div>
+
+## 🤝 Contributing
+
+<div align="center">
+
+We welcome contributions from developers of all skill levels! Whether it's adding features, fixing bugs, or improving documentation.
+
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-0061ff.svg?style=for-the-badge)](CONTRIBUTING.md)
+
+</div>
+
+## 💬 Community & Support
+
+<div align="center">
+
+Join our thriving community of developers and bot creators!
+
+[![Discord Server](https://img.shields.io/badge/Discord_Server-7289da?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/K4CVv84VBC)
+[![GitHub Discussions](https://img.shields.io/badge/GitHub_Discussions-0061ff?style=for-the-badge&logo=github&logoColor=white)](https://github.com/ToddyTheNoobDud/AquaLink/discussions)
+
+</div>
+
+<div align="center">
+
+<br />
+
+<p align="center">
+  <img src="https://capsule-render.vercel.app/api?type=wave&color=0099FF&height=100&section=footer" />
+</p>
+
+<sub>Built with 💙 by the Aqualink Team</sub>
+
+</div>

package/build/handlers/autoplay.js

@@ -1,46 +1,84 @@
 const https = require('https');
 const crypto = require('crypto');
 
-function quickFetch(url, options = {}) {
-    return new Promise((resolve, reject) => {
-        const req = https.get(url, options, res => {
-            if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-                return resolve(quickFetch(res.headers.location, options));
-            }
-            if (res.statusCode !== 200) {
-                res.resume(); 
-                return reject(new Error(`Request failed. Status code: ${res.statusCode}`));
-            }
-            const chunks = [];
-            res.on('data', chunk => chunks.push(chunk));
-            res.on('end', () => resolve(Buffer.concat(chunks).toString()));
-        });
-        req.on('error', reject);
-        req.setTimeout(10000, () => {
-            req.destroy();
-            reject(new Error('Request timeout'));
+const agent = new https.Agent({ keepAlive: true, maxSockets: 10 });
+
+const TOTP_SECRET = Buffer.from("5507145853487499592248630329347", 'utf8');
+
+async function quickFetch(url, options = {}, redirectCount = 0) {
+    const maxRedirects = 5;
+    
+    try {
+        return await new Promise((resolve, reject) => {
+            const req = https.get(url, { ...options, agent }, async (res) => {
+                if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                    if (redirectCount >= maxRedirects) {
+                        return reject(new Error('Too many redirects'));
+                    }
+                    
+                    res.resume();
+                    try {
+                        const resolved = await quickFetch(
+                            new URL(res.headers.location, url).toString(),
+                            options,
+                            redirectCount + 1
+                        );
+                        resolve(resolved);
+                    } catch (err) {
+                        reject(err);
+                    }
+                    return;
+                }
+
+                if (res.statusCode !== 200) {
+                    res.resume();
+                    return reject(new Error(`Request failed. Status code: ${res.statusCode}`));
+                }
+
+                const chunks = [];
+                let length = 0;
+                
+                res.on('data', (chunk) => {
+                    chunks.push(chunk);
+                    length += chunk.length;
+                });
+
+                res.on('end', () => {
+                    resolve(Buffer.concat(chunks, length).toString());
+                });
+            });
+
+            req.on('error', reject);
+            req.setTimeout(10000, () => {
+                req.destroy(new Error('Request timeout'));
+            });
         });
-        req.end();
-    });
+    } catch (err) {
+        throw err;
+    }
 }
 
 async function soundAutoPlay(baseUrl) {
     try {
         const html = await quickFetch(`${baseUrl}/recommended`);
-        const regex = /<a\s+itemprop="url"\s+href="(\/[^"]+)"/g;
         const links = new Set();
+        const regex = /<a\s+itemprop="url"\s+href="(\/[^"]+)"/g;
+        
         let match;
         while ((match = regex.exec(html)) !== null) {
             links.add(`https://soundcloud.com${match[1]}`);
         }
+
         if (!links.size) {
             throw new Error("No recommended tracks found on SoundCloud.");
         }
+
         const urls = Array.from(links);
         for (let i = urls.length - 1; i > 0; i--) {
-            const j = Math.floor(Math.random() * (i + 1));
+            const j = Math.random() * (i + 1) | 0;
             [urls[i], urls[j]] = [urls[j], urls[i]];
         }
+
         return urls;
     } catch (err) {
         console.error("Error in SoundCloud autoplay:", err);
@@ -48,33 +86,29 @@ async function soundAutoPlay(baseUrl) {
     }
 }
 
-function gerenateToKen() {
-    const totpSecret = Buffer.from(new Uint8Array([
-        53, 53, 48, 55, 49, 52, 53, 56, 53, 51, 52, 56, 55, 52, 57, 57,
-        53, 57, 50, 50, 52, 56, 54, 51, 48, 51, 50, 57, 51, 52, 55
-    ]));
-
-    // Note for  me: Can also be used from Buffer.from("5507145853487499592248630329347", 'utf8');
-
+function generateToken() {
     const timeStep = Math.floor(Date.now() / 30000);
     const counter = Buffer.alloc(8);
     counter.writeBigInt64BE(BigInt(timeStep));
 
-    const hmac = crypto.createHmac('sha1', totpSecret);
+    const hmac = crypto.createHmac('sha1', TOTP_SECRET);
     hmac.update(counter);
     const hash = hmac.digest();
     const offset = hash[hash.length - 1] & 0x0f;
-    const binCode =
-        ((hash[offset] & 0x7f) << 24) |
-        ((hash[offset + 1] & 0xff) << 16) |
-        ((hash[offset + 2] & 0xff) << 8) |
-        (hash[offset + 3] & 0xff);
+    
+    const binCode = (
+        (hash[offset] << 24) |
+        (hash[offset + 1] << 16) |
+        (hash[offset + 2] << 8) |
+        hash[offset + 3]
+    ) & 0x7fffffff;
+
     const token = (binCode % 1000000).toString().padStart(6, '0');
     return [token, timeStep * 30000];
 }
 
 async function spotifyAutoPlay(seedTrackId) {
-    const [totp, ts] = gerenateToKen();
+    const [totp, ts] = generateToken();
     const params = new URLSearchParams({
         reason: "transport",
         productType: "embed",
@@ -82,34 +116,29 @@ async function spotifyAutoPlay(seedTrackId) {
         totpVer: "5",
         ts: ts.toString()
     });
-    const tokenUrl = `https://open.spotify.com/get_access_token?${params.toString()}`;
-    const tokenData = await quickFetch(tokenUrl);
 
-    let accessToken;
     try {
-        accessToken = JSON.parse(tokenData).accessToken;
-    } catch {
-        throw new Error("Failed to retrieve Spotify access token.");
-    }
+        const tokenData = await quickFetch(`https://open.spotify.com/get_access_token?${params}`);
+        const { accessToken } = JSON.parse(tokenData);
+        
+        if (!accessToken) throw new Error("Invalid access token");
 
-    const recUrl = `https://api.spotify.com/v1/recommendations?limit=10&seed_tracks=${seedTrackId}`;
-    const recData = await quickFetch(recUrl, {
-        headers: {
-            Authorization: `Bearer ${accessToken}`,
-            'Content-Type': 'application/json'
-        }
-    });
+        const recData = await quickFetch(
+            `https://api.spotify.com/v1/recommendations?limit=10&seed_tracks=${seedTrackId}`,
+            { headers: { Authorization: `Bearer ${accessToken}` } }
+        );
 
-    let tracks;
-    try {
-        tracks = JSON.parse(recData).tracks;
-    } catch {
-        throw new Error("Failed to parse Spotify recommendations.");
+        const { tracks } = JSON.parse(recData);
+        if (!tracks?.length) throw new Error("No tracks found");
+
+        return tracks[Math.random() * tracks.length | 0].id;
+    } catch (err) {
+        console.error("Spotify autoplay error:", err);
+        throw err;
     }
-    return tracks[Math.floor(Math.random() * tracks.length)].id;
 }
 
 module.exports = {
     scAutoPlay: soundAutoPlay,
     spAutoPlay: spotifyAutoPlay
-};
+};