ziplayer 0.2.6 → 0.2.7-dev.0

package/README.md

@@ -1,196 +1,259 @@
-<img width="1175" height="305" alt="logo" src="https://raw.githubusercontent.com/ZiProject/ZiPlayer/refs/heads/main/publish/logo.png" />
-
-# ziplayer
-
-A modular Discord voice player with plugin system for @discordjs/voice.
-
-## Features
-
-- 🎵 **Plugin-based architecture** - Easy to extend with new sources
-- 🎶 **Multiple source support** - YouTube, SoundCloud, Spotify (with fallback)
-- 🔊 **Queue management** - Add, remove, shuffle, clear
-- 🎚️ **Volume control** - 0-200% volume range
-- ⏯️ **Playback control** - Play, pause, resume, stop, skip
-- 🔁 **Auto play** - Automatically replay the queue when it ends
-- 🔂 **Loop control** - Repeat a single track or the entire queue
-- 📊 **Progress bar** - Display playback progress with customizable icons
-- 🔔 **Event-driven** - Rich event system for all player actions
-- 🎭 **Multi-guild support** - Manage players across multiple Discord servers
-- 🗃️ **User data** - Attach custom data to each player for later use
-- 🔌 **Lavalink** - Support manage an external Lavalink JVM node
-- 🎛️ **Audio Filters** - Apply real-time audio effects using FFmpeg (bassboost, nightcore, etc.)
-
-## Installation
-
-```bash
-npm install ziplayer @ziplayer/plugin @ziplayer/extension @discordjs/voice discord.js
-```
-
-## Quick Start
-
-```typescript
-import { PlayerManager } from "ziplayer";
-import { SoundCloudPlugin, YouTubePlugin, SpotifyPlugin } from "@ziplayer/plugin";
-import { voiceExt } from "@ziplayer/extension";
-
-const manager = new PlayerManager({
-	plugins: [new SoundCloudPlugin(), new YouTubePlugin(), new SpotifyPlugin()],
-	extensions: [new voiceExt()],
-});
-
-// Create player
-const player = await manager.create(guildId, {
-	leaveOnEnd: true,
-	leaveTimeout: 30000,
-	userdata: { channel: textChannel }, // store channel for events
-	// Choose extensions for this player (by name or instances)
-	// extensions: ["voiceExt"],
-	// Apply audio filters
-	// filters: ["bassboost", "normalize"],
-});
-
-// Connect and play
-await player.connect(voiceChannel);
-await player.play("Never Gonna Give You Up", userId);
-
-// Play a full YouTube playlist
-await player.play("https://www.youtube.com/playlist?list=PL123", userId);
-
-// Enable autoplay
-player.queue.autoPlay(true);
-
-// Play a full SoundCloud playlist
-await player.play("https://soundcloud.com/artist/sets/playlist", userId);
-
-// Events
-player.on("willPlay", (player, track) => {
-	console.log(`Up next: ${track.title}`);
-});
-player.on("trackStart", (player, track) => {
-	console.log(`Now playing: ${track.title}`);
-	player.userdata?.channel?.send(`Now playing: ${track.title}`);
-});
-
-// Audio Filters
-player.filter.applyFilter("bassboost"); // Apply bass boost
-player.filter.applyFilter("nightcore"); // Apply nightcore effect
-player.filter.removeFilter("bassboost"); // Remove specific filter
-player.filter.clearFilters(); // Clear all filters
-
-// Apply custom filter
-player.filter.applyFilter({
-	name: "custom",
-	ffmpegFilter: "volume=1.5,treble=g=5",
-	description: "Volume boost + treble boost",
-});
-
-// Receive transcripts
-manager.on("voiceCreate", (player, evt) => {
-	console.log(`User ${evt.userId} said: ${evt.content}`);
-});
-```
-
-### TTS (Interrupt Mode)
-
-Play short text-to-speech messages without losing music progress. The player pauses music, plays TTS on a dedicated AudioPlayer,
-then resumes.
-
-- Requirements: `@ziplayer/plugin` with `TTSPlugin` installed and registered in `PlayerManager`.
-
-```ts
-import { PlayerManager } from "ziplayer";
-import { TTSPlugin, YouTubePlugin, SoundCloudPlugin, SpotifyPlugin } from "@ziplayer/plugin";
-
-const manager = new PlayerManager({
-	plugins: [new TTSPlugin({ defaultLang: "vi" }), new YouTubePlugin(), new SoundCloudPlugin(), new SpotifyPlugin()],
-});
-
-// Create a player with TTS interrupt enabled
-const player = await manager.create(guildId, {
-	tts: {
-		createPlayer: true, // pre-create the internal TTS AudioPlayer
-		interrupt: true, // pause music, swap to TTS, then resume
-		volume: 1, // 1 => 100%
-	},
-});
-
-await player.connect(voiceChannel);
-
-// Trigger TTS by playing a TTS query (depends on your TTS plugin)
-await player.play("tts: xin chào mọi người", userId);
-
-// Listen to TTS lifecycle events
-manager.on("ttsStart", (plr, { track }) => console.log("TTS start", track?.title));
-manager.on("ttsEnd", (plr) => console.log("TTS end"));
-```
-
-Notes
-
-- The detection uses track.source that includes "tts" or query starting with `tts:`.
-- If you need more control, call `player.interruptWithTTSTrack(track)` after building a TTS track via your plugin.
-
-### extensions and Lavalink Process
-
-Use `lavalinkExt` when you need ZiPlayer to manage an external Lavalink JVM node. The extension starts, stops, and optionally
-restarts the Lavalink jar and forwards lifecycle events through the manager/player.
-
-```ts
-import { PlayerManager } from "ziplayer";
-import { lavalinkExt, lyricsExt, voiceExt } from "@ziplayer/extension";
-
-const manager = new PlayerManager({
-	extensions: [
-		new lavalinkExt(null, {
-			nodes: [
-				{
-					identifier: "locallavalink",
-					password: "youshallnotpass",
-					host: "localhost",
-					port: 2333,
-					secure: false,
-				},
-			],
-			client: client,
-			searchPrefix: "scsearch",
-		}),
-		new voiceExt(null, { lang: "en-US" }),
-		new lyricsExt(null, { provider: "lrclib" }),
-	],
-	//etc...
-});
-
-//crete player:
-const player = await manager.create("id-player", {
-	extensions: ["lavalinkExt", "voiceExt", "lyricsExt"],
-	//etc... userdata,
-});
-
-//connec voice
-if (!player.connection) await player.connect(interaction?.member?.voice?.channel);
-
-//play music
-await player.play(query, interaction?.user);
-```
-
-## Events
-
-All player events are forwarded through the PlayerManager:
-
-- `trackStart` - When a track starts playing
-- `willPlay` - Before a track begins playing
-- `trackEnd` - When a track finishes
-- `queueEnd` - When the queue is empty
-- `playerError` - When an error occurs
-- `queueAdd` - When a track is added
-- `volumeChange` - When volume changes
-- And more...
-
-## Useful Links
-
-[Example](https://github.com/ZiProject/ZiPlayer/tree/main/examples) | [Repo](https://github.com/ZiProject/ZiPlayer) |
-[Package](https://www.npmjs.com/package/ziplayer) | [Plugin](https://www.npmjs.com/package/@ziplayer/plugin) |
-[Extension](https://www.npmjs.com/package/@ziplayer/extension)
-
-## License
-
-MIT License
+<img width="1175" height="305" alt="logo" src="https://raw.githubusercontent.com/ZiProject/ZiPlayer/refs/heads/main/publish/logo.png" />
+
+# ZiPlayer
+
+A powerful, extensible Discord music engine built on top of `@discordjs/voice`, designed for scalability, flexibility, and
+developer experience.
+
+ZiPlayer is not just a player — it's a **full ecosystem** with plugins, extensions, and a modular architecture that lets you build
+advanced music bots quickly.
+
+---
+
+## ✨ Highlights
+
+- 🔌 **Plugin-driven architecture** — Easily support new audio sources
+- 🌐 **Multi-source playback** — YouTube, SoundCloud, Spotify (with fallback), TTS, and more
+- 🧠 **Smart fallback system** — Automatically resolves streams across plugins
+- 🎛️ **Advanced audio filters** — Real-time FFmpeg effects (bassboost, nightcore, etc.)
+- 🔁 **Autoplay & looping** — Seamless listening experience
+- 🧩 **Extension system** — Add STT, lyrics, Lavalink, and custom logic
+- 🗂️ **Per-guild player system** — Scales across multiple Discord servers
+- 📡 **Event-driven core** — Full lifecycle hooks for customization
+- 💾 **Custom userdata** — Attach context to each player
+
+---
+
+## 📦 Installation
+
+```bash
+npm install ziplayer @ziplayer/plugin @ziplayer/extension @ziplayer/infinity @discordjs/voice discord.js opusscript
+```
+
+---
+
+## 🚀 Quick Start
+
+```ts
+import { Client, GatewayIntentBits } from "discord.js";
+import { PlayerManager } from "ziplayer";
+import { YouTubePlugin, SoundCloudPlugin, SpotifyPlugin } from "@ziplayer/plugin";
+import { InfinityPlugin } from "@ziplayer/infinity";
+
+const client = new Client({
+	intents: [
+		GatewayIntentBits.Guilds,
+		GatewayIntentBits.GuildVoiceStates,
+		GatewayIntentBits.GuildMessages,
+		GatewayIntentBits.MessageContent,
+	],
+});
+
+const manager = new PlayerManager({
+	plugins: [new YouTubePlugin(), new SoundCloudPlugin(), new SpotifyPlugin(), new InfinityPlugin()],
+});
+
+client.on("messageCreate", async (msg) => {
+	if (!msg.content.startsWith("!play ") || !msg.guildId) return;
+
+	const voiceChannel = msg.member?.voice?.channel;
+	if (!voiceChannel) return msg.reply("Join a voice channel first!");
+
+	const player = await manager.create(msg.guildId, {
+		leaveOnEnd: true,
+		userdata: { channel: msg.channel },
+	});
+
+	if (!player.connection) await player.connect(voiceChannel);
+	await player.play(msg.content.slice(6), msg.author.id);
+});
+
+client.login(process.env.DISCORD_TOKEN);
+```
+
+---
+
+## 🧱 Architecture Overview
+
+```
+PlayerManager (global)
+  └── Player (per guild)
+        ├── Queue
+        ├── PluginManager
+        ├── ExtensionManager
+        └── FilterManager
+```
+
+### Flow
+
+```
+create → connect → play → stream → events → destroy
+```
+
+---
+
+## 🎵 Core Usage
+
+### Play music
+
+```ts
+await player.play("Never Gonna Give You Up", userId);
+await player.play("https://youtube.com/watch?v=...", userId);
+await player.play("tts: Hello world", userId);
+```
+
+### Controls
+
+```ts
+player.pause();
+player.resume();
+player.skip();
+player.stop();
+player.setVolume(100);
+player.loop("track");
+player.shuffle();
+```
+
+### Queue
+
+```ts
+player.queue.add(track);
+player.queue.remove(0);
+player.queue.shuffle();
+player.queue.clear();
+```
+
+---
+
+## 🔌 Plugins
+
+Install via `@ziplayer/plugin`:
+
+- **YouTubePlugin** — YouTube + search
+- **SoundCloudPlugin** — SoundCloud streaming
+- **SpotifyPlugin** — Metadata (uses fallback)
+- **TTSPlugin** — Text-to-speech
+- **AttachmentsPlugin** — Local/URL audio files
+
+### Example
+
+```ts
+import { TTSPlugin } from "@ziplayer/plugin";
+
+new PlayerManager({
+	plugins: [new TTSPlugin({ defaultLang: "en" })],
+});
+```
+
+---
+
+## 🧩 Extensions
+
+Enhance player behavior:
+
+- 🎤 `voiceExt` — Speech-to-text commands
+- 🎤 `lyricsExt` — Auto lyrics (synced support)
+- ⚡ `lavalinkExt` — External Lavalink node
+
+### Example
+
+```ts
+import { voiceExt, lyricsExt } from "@ziplayer/extension";
+
+const manager = new PlayerManager({
+	extensions: [new voiceExt(null, { lang: "en-US" }), new lyricsExt(null, { provider: "lrclib" })],
+});
+```
+
+---
+
+## 🎛️ Audio Filters
+
+Apply FFmpeg filters in real-time:
+
+```ts
+await player.filter.applyFilter("bassboost");
+await player.filter.applyFilter("nightcore");
+await player.filter.clearAll();
+```
+
+### Available filters
+
+- bassboost, trebleboost
+- nightcore, lofi, vaporwave
+- echo, reverb, chorus
+- karaoke
+- normalize, compressor, limiter
+
+---
+
+## 🔊 TTS (Interrupt Mode)
+
+```ts
+const player = await manager.create(guildId, {
+	tts: {
+		createPlayer: true,
+		interrupt: true,
+	},
+});
+
+await player.play("tts: Hello everyone", userId);
+```
+
+---
+
+## 📡 Events
+
+Listen globally via manager:
+
+```ts
+manager.on("trackStart", (player, track) => {});
+manager.on("queueEnd", (player) => {});
+manager.on("playerError", (player, error) => {});
+```
+
+---
+
+## 🧠 Advanced Features
+
+### Autoplay
+
+```ts
+player.queue.autoPlay(true);
+```
+
+### Insert next track
+
+```ts
+await player.insert("song", 0);
+```
+
+### Save stream
+
+```ts
+const stream = await player.save(track);
+stream.pipe(fs.createWriteStream("song.mp3"));
+```
+
+---
+
+## ⚠️ Best Practices
+
+- Use **one PlayerManager** per bot
+- Always `await player.connect()` before playing
+- Handle `playerError` events
+- Do not reuse a destroyed player
+
+---
+
+## 📚 Resources
+
+- Examples: [https://github.com/ZiProject/ZiPlayer/tree/main/examples](https://github.com/ZiProject/ZiPlayer/tree/main/examples)
+- GitHub: [https://github.com/ZiProject/ZiPlayer](https://github.com/ZiProject/ZiPlayer)
+- npm: [https://www.npmjs.com/package/ziplayer](https://www.npmjs.com/package/ziplayer)
+
+---
+
+## 📄 License
+
+MIT License

package/dist/plugins/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,KAAK,oBAAoB,GAAG;IAC3B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,qBAAa,aAAa;IACzB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAsC;gBAEzC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,oBAAoB;IAMjF,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAMpD,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIlC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC,MAAM,IAAI,UAAU,EAAE;IAItB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIjD,KAAK,IAAI,IAAI;IAIP,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAqFzD;;;;;;;OAOG;IACG,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAuFtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,KAAK,oBAAoB,GAAG;IAC3B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAwF1C,qBAAa,aAAa;IACzB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAsC;gBAEzC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,oBAAoB;IAMjF,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAMpD,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIlC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC,MAAM,IAAI,UAAU,EAAE;IAItB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIjD,KAAK,IAAI,IAAI;IAIP,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAqFzD;;;;;;;OAOG;IACG,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAsDtD"}

package/dist/plugins/index.js

@@ -4,6 +4,73 @@ exports.PluginManager = exports.BasePlugin = void 0;
 const timeout_1 = require("../utils/timeout");
 var BasePlugin_1 = require("./BasePlugin");
 Object.defineProperty(exports, "BasePlugin", { enumerable: true, get: function () { return BasePlugin_1.BasePlugin; } });
+function levenshtein(a, b) {
+    const matrix = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+    for (let i = 0; i <= a.length; i++)
+        matrix[i][0] = i;
+    for (let j = 0; j <= b.length; j++)
+        matrix[0][j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j - 1] + cost);
+        }
+    }
+    return matrix[a.length][b.length];
+}
+function similarity(a, b) {
+    if (!a || !b)
+        return 0;
+    const dist = levenshtein(a, b);
+    const maxLen = Math.max(a.length, b.length);
+    return 1 - dist / maxLen; // 0 → 1
+}
+function normalize(str) {
+    return str
+        .toLowerCase()
+        .replace(/\(.*?\)|\[.*?\]/g, "") // remove (remix), [lyrics]
+        .replace(/[^a-z0-9\s]/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+const MUSIC_KEYWORDS = ["official", "mv", "audio", "lyrics", "remix", "cover", "ft", "feat", "prod", "music video"];
+const NON_MUSIC_KEYWORDS = ["reaction", "review", "podcast", "interview", "vlog", "live stream", "news", "tiktok"];
+function detectContentType(title) {
+    const t = title.toLowerCase();
+    let score = 0;
+    for (const k of MUSIC_KEYWORDS) {
+        if (t.includes(k))
+            score += 2;
+    }
+    for (const k of NON_MUSIC_KEYWORDS) {
+        if (t.includes(k))
+            score -= 3;
+    }
+    return score;
+}
+function tokenOverlap(a, b) {
+    const setA = new Set(a.split(" "));
+    const setB = new Set(b.split(" "));
+    let match = 0;
+    for (const word of setA) {
+        if (setB.has(word))
+            match++;
+    }
+    return match / Math.max(setA.size, setB.size);
+}
+function scoreTrack(base, candidate) {
+    const titleA = normalize(base.title);
+    const titleB = normalize(candidate.title);
+    let score = 0;
+    // ===== FUZZY =====
+    const sim = similarity(titleA, titleB); // 0 → 1
+    score += sim * 50;
+    // ===== TOKEN MATCH =====
+    score += tokenOverlap(titleA, titleB) * 30;
+    // ===== CONTENT TYPE =====
+    score += detectContentType(candidate.title);
+    return score;
+}
 // Plugin factory
 class PluginManager {
     constructor(player, manager, options) {
@@ -131,75 +198,44 @@ class PluginManager {
         if (!track)
             return [];
         const timeoutMs = this.options.extractorTimeout ?? 15000;
-        const preferred = this.findPlugin(track.url) || this.get(track.source);
-        // ===== THỬ PREFERRED TRƯỚC =====
-        if (preferred && typeof preferred.getRelatedTracks === "function") {
+        const limit = 20;
+        const allPlugins = this.getAll()
+            .filter((p) => typeof p.getRelatedTracks === "function")
+            .sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+        const history = this.player.queue.previousTracks;
+        const results = [];
+        // ===== TRY ALL PLUGINS (NOT JUST FIRST SUCCESS) =====
+        await Promise.allSettled(allPlugins.map(async (p) => {
             try {
-                this.debug(`[RelatedTracks] Trying preferred: ${preferred.name}`);
-                const related = await (0, timeout_1.withTimeout)(preferred.getRelatedTracks(track, {
-                    limit: 10,
-                    history: this.player.queue.previousTracks,
-                }), timeoutMs, `getRelatedTracks timed out for ${preferred.name}`);
-                if (Array.isArray(related) && related.length > 0) {
-                    return related;
+                this.debug(`[RelatedTracks] Querying ${p.name}`);
+                const related = await (0, timeout_1.withTimeout)(p.getRelatedTracks(track, { limit, history }), timeoutMs, `Timeout ${p.name}`);
+                if (Array.isArray(related)) {
+                    results.push(...related);
                 }
-                this.debug(`[RelatedTracks] ${preferred.name} returned no results → fallback race`);
             }
             catch (err) {
-                this.debug(`[RelatedTracks] ${preferred.name} failed → fallback race`, err);
+                this.debug(`[RelatedTracks] ${p.name} failed`, err);
             }
+        }));
+        if (results.length === 0) {
+            this.debug(`[RelatedTracks] No results`);
+            return [];
         }
-        // ===== FALLBACK: RACE THEO PRIORITY GROUP =====
-        const plugins = this.getAll()
-            .filter((p) => p !== preferred && typeof p.getRelatedTracks === "function")
-            .map((p) => {
-            p.priority ??= 0;
-            return p;
-        })
-            .sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
-        // group by priority
-        const groups = new Map();
-        for (const p of plugins) {
-            const key = p.priority ?? 0;
-            if (!groups.has(key))
-                groups.set(key, []);
-            groups.get(key).push(p);
-        }
-        for (const [priority, group] of groups) {
-            this.debug(`[RelatedTracks] Racing priority=${priority} (${group.map((p) => p.name).join(", ")})`);
-            const controller = new AbortController();
-            try {
-                const promises = group.map((p) => (async () => {
-                    try {
-                        const related = await (0, timeout_1.withTimeout)(p.getRelatedTracks(track, {
-                            limit: 10,
-                            history: this.player.queue.previousTracks,
-                        }), timeoutMs, `getRelatedTracks timed out for ${p.name}`);
-                        if (Array.isArray(related) && related.length > 0) {
-                            this.debug(`[RelatedTracks] Success via ${p.name}`);
-                            controller.abort();
-                            return related;
-                        }
-                        throw new Error(`${p.name} returned no results`);
-                    }
-                    catch (err) {
-                        if (controller.signal.aborted)
-                            throw new Error("Aborted");
-                        this.debug(`[RelatedTracks] ${p.name} failed`, err);
-                        throw err;
-                    }
-                })());
-                const result = await Promise.any(promises);
-                if (result)
-                    return result;
-            }
-            catch {
-                this.debug(`[RelatedTracks] Priority group ${priority} all failed`);
-                controller.abort();
+        // ===== DEDUPE =====
+        const unique = new Map();
+        for (const t of results) {
+            if (!unique.has(t.url)) {
+                unique.set(t.url, t);
             }
         }
-        this.debug(`[RelatedTracks] All plugins failed for: ${track.title}`);
-        return [];
+        // ===== SCORE + SORT =====
+        const ranked = Array.from(unique.values())
+            .map((t) => ({ track: t, score: scoreTrack(track, t) }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map((x) => x.track);
+        this.debug(`[RelatedTracks] Final ${ranked.length} tracks`);
+        return ranked;
     }
 }
 exports.PluginManager = PluginManager;