ziplayer 0.2.5 → 0.2.7-dev.0

package/src/structures/Player.ts

@@ -1,1743 +1,1704 @@
-import { EventEmitter } from "events";
-import {
-	createAudioPlayer,
-	createAudioResource,
-	entersState,
-	AudioPlayerStatus,
-	VoiceConnection,
-	AudioPlayer as DiscordAudioPlayer,
-	VoiceConnectionStatus,
-	NoSubscriberBehavior,
-	joinVoiceChannel,
-	AudioResource,
-	StreamType,
-} from "@discordjs/voice";
-
-import { Readable } from "stream";
-import type { BaseExtension } from "../extensions";
-import type {
-	Track,
-	PlayerOptions,
-	PlayerEvents,
-	SourcePlugin,
-	SearchResult,
-	ProgressBarOptions,
-	LoopMode,
-	StreamInfo,
-	SaveOptions,
-	VoiceChannel,
-	ExtensionPlayRequest,
-	ExtensionPlayResponse,
-	ExtensionAfterPlayPayload,
-} from "../types";
-import type { PlayerManager } from "./PlayerManager";
-
-import { Queue } from "./Queue";
-import { PluginManager } from "../plugins";
-import { ExtensionManager } from "../extensions";
-import { withTimeout } from "../utils/timeout";
-import { FilterManager } from "./FilterManager";
-
-export declare interface Player {
-	on<K extends keyof PlayerEvents>(event: K, listener: (...args: PlayerEvents[K]) => void): this;
-	emit<K extends keyof PlayerEvents>(event: K, ...args: PlayerEvents[K]): boolean;
-}
-
-/**
- * Represents a music player for a specific Discord guild.
- *
- * @example
- * // Create and configure player
- * const player = await manager.create(guildId, {
- *   tts: { interrupt: true, volume: 1 },
- *   leaveOnEnd: true,
- *   leaveTimeout: 30000
- * });
- *
- * // Connect to voice channel
- * await player.connect(voiceChannel);
- *
- * // Play different types of content
- * await player.play("Never Gonna Give You Up", userId); // Search query
- * await player.play("https://youtube.com/watch?v=dQw4w9WgXcQ", userId); // Direct URL
- * await player.play("tts: Hello everyone!", userId); // Text-to-Speech
- *
- * // Player controls
- * player.pause(); // Pause current track
- * player.resume(); // Resume paused track
- * player.skip(); // Skip to next track
- * player.stop(); // Stop and clear queue
- * player.setVolume(0.5); // Set volume to 50%
- *
- * // Event handling
- * player.on("trackStart", (player, track) => {
- *   console.log(`Now playing: ${track.title}`);
- * });
- *
- * player.on("queueEnd", (player) => {
- *   console.log("Queue finished");
- * });
- *
- */
-export class Player extends EventEmitter {
-	public readonly guildId: string;
-	public connection: VoiceConnection | null = null;
-	public audioPlayer: DiscordAudioPlayer;
-	public queue: Queue;
-	public volume: number = 100;
-	public isPlaying: boolean = false;
-	public isPaused: boolean = false;
-	public options: PlayerOptions;
-	public pluginManager: PluginManager;
-	public extensionManager: ExtensionManager;
-	public userdata?: Record<string, any>;
-	private manager: PlayerManager;
-	private leaveTimeout: NodeJS.Timeout | null = null;
-	private currentResource: AudioResource | null = null;
-	private volumeInterval: NodeJS.Timeout | null = null;
-	private skipLoop = false;
-	private filter!: FilterManager;
-
-	// Cache for search results to avoid duplicate calls
-	private searchCache = new Map<string, SearchResult>();
-	private readonly SEARCH_CACHE_TTL = 2 * 60 * 1000; // 2 minutes
-	private searchCacheTimestamps = new Map<string, number>();
-	private ttsPlayer: DiscordAudioPlayer | null = null;
-
-	constructor(guildId: string, options: PlayerOptions = {}, manager: PlayerManager) {
-		super();
-		this.debug(`[Player] Constructor called for guildId: ${guildId}`);
-		this.guildId = guildId;
-		this.queue = new Queue();
-		this.manager = manager;
-		this.audioPlayer = createAudioPlayer({
-			behaviors: {
-				noSubscriber: NoSubscriberBehavior.Pause,
-				maxMissedFrames: 100,
-			},
-		});
-
-		this.options = {
-			leaveOnEnd: true,
-			leaveOnEmpty: true,
-			leaveTimeout: 100000,
-			volume: 100,
-			quality: "high",
-			extractorTimeout: 50000,
-			selfDeaf: true,
-			selfMute: false,
-			...options,
-			tts: {
-				createPlayer: false,
-				interrupt: true,
-				volume: 100,
-				Max_Time_TTS: 60_000,
-				...(options?.tts || {}),
-			},
-		};
-		this.filter = new FilterManager(this, this.manager);
-		this.extensionManager = new ExtensionManager(this, this.manager);
-		this.pluginManager = new PluginManager(this, this.manager, {
-			extractorTimeout: this.options.extractorTimeout,
-		});
-
-		this.volume = this.options.volume || 100;
-		this.userdata = this.options.userdata;
-		this.setupEventListeners();
-
-		// Initialize filters from options
-		if (this.options.filters && this.options.filters.length > 0) {
-			this.debug(`[Player] Initializing ${this.options.filters.length} filters from options`);
-			// Use async version but don't await in constructor
-			this.filter.applyFilters(this.options.filters).catch((error: any) => {
-				this.debug(`[Player] Error initializing filters:`, error);
-			});
-		}
-
-		// Optionally pre-create the TTS AudioPlayer
-		if (this.options?.tts?.createPlayer) {
-			this.ensureTTSPlayer();
-		}
-	}
-
-	/**
-	 * Destroy current stream to prevent memory leaks
-	 * @private
-	 */
-	private destroyCurrentStream(): void {
-		try {
-			// Get the metadata from current resource to find the stream
-			if (this.currentResource) {
-				const stream = (this.currentResource as any)?.metadata?.stream || (this.currentResource as any)?.stream;
-				if (stream && typeof stream.destroy === "function") {
-					stream.destroy();
-					this.debug(`[Player] Destroyed current stream`);
-				}
-			}
-		} catch (error) {
-			this.debug(`[Player] Error destroying current stream:`, error);
-		}
-	}
-
-	//#region Search
-
-	/**
-	 * Search for tracks using the player's extensions and plugins
-	 *
-	 * @param {string} query - The query to search for
-	 * @param {string} requestedBy - The user ID who requested the search
-	 * @returns {Promise<SearchResult>} The search result
-	 * @example
-	 * const result = await player.search("Never Gonna Give You Up", userId);
-	 * console.log(`Search result: ${result.tracks.length} tracks`);
-	 */
-	async search(query: string, requestedBy: string): Promise<SearchResult> {
-		this.debug(`[Player] Search called with query: ${query}, requestedBy: ${requestedBy}`);
-
-		// Clear expired search cache periodically
-		if (Math.random() < 0.1) {
-			// 10% chance to clean cache
-			this.clearExpiredSearchCache();
-		}
-
-		// Check cache first
-		const cachedResult = this.getCachedSearchResult(query);
-		if (cachedResult) {
-			return cachedResult;
-		}
-
-		// Try extensions first
-		const extensionResult = await this.extensionManager.provideSearch(query, requestedBy);
-		if (extensionResult && Array.isArray(extensionResult.tracks) && extensionResult.tracks.length > 0) {
-			this.debug(`[Player] Extension handled search for query: ${query}`);
-			this.cacheSearchResult(query, extensionResult);
-			return extensionResult;
-		}
-
-		// Get plugins and filter out TTS for regular searches
-		const allPlugins = this.pluginManager.getAll();
-		const plugins = allPlugins.filter((p) => {
-			// Skip TTS plugin for regular searches (unless query starts with "tts:")
-			if (p.name.toLowerCase() === "tts" && !query.toLowerCase().startsWith("tts:")) {
-				this.debug(`[Player] Skipping TTS plugin for regular search: ${query}`);
-				return false;
-			}
-			return true;
-		});
-
-		this.debug(`[Player] Using ${plugins.length} plugins for search (filtered from ${allPlugins.length})`);
-
-		let lastError: any = null;
-		let searchAttempts = 0;
-
-		for (const p of plugins) {
-			searchAttempts++;
-			try {
-				this.debug(`[Player] Trying plugin for search: ${p.name} (attempt ${searchAttempts}/${plugins.length})`);
-				const startTime = Date.now();
-				const res = await withTimeout(
-					p.search(query, requestedBy),
-					this.options.extractorTimeout ?? 15000,
-					`Search operation timed out for ${p.name}`,
-				);
-				const duration = Date.now() - startTime;
-
-				if (res && Array.isArray(res.tracks) && res.tracks.length > 0) {
-					this.debug(`[Player] Plugin '${p.name}' returned ${res.tracks.length} tracks in ${duration}ms`);
-					this.cacheSearchResult(query, res);
-					return res;
-				}
-				this.debug(`[Player] Plugin '${p.name}' returned no tracks in ${duration}ms`);
-			} catch (error) {
-				const errorMessage = error instanceof Error ? error.message : String(error);
-				this.debug(`[Player] Search via plugin '${p.name}' failed: ${errorMessage}`);
-				lastError = error;
-				// Continue to next plugin
-			}
-		}
-
-		this.debug(`[Player] No plugins returned results for query: ${query} (tried ${searchAttempts} plugins)`);
-		if (lastError) this.emit("playerError", lastError as Error);
-		throw new Error(`No plugin found to handle: ${query}`);
-	}
-
-	/**
-	 * Get cached search result or null if not found/expired
-	 * @param query The search query
-	 * @returns Cached search result or null
-	 */
-	private getCachedSearchResult(query: string): SearchResult | null {
-		const cacheKey = query.toLowerCase().trim();
-		const now = Date.now();
-
-		const cachedTimestamp = this.searchCacheTimestamps.get(cacheKey);
-		if (cachedTimestamp && now - cachedTimestamp < this.SEARCH_CACHE_TTL) {
-			const cachedResult = this.searchCache.get(cacheKey);
-			if (cachedResult) {
-				this.debug(`[SearchCache] Using cached search result for: ${query}`);
-				return cachedResult;
-			}
-		}
-
-		return null;
-	}
-
-	/**
-	 * Cache search result
-	 * @param query The search query
-	 * @param result The search result to cache
-	 */
-	private cacheSearchResult(query: string, result: SearchResult): void {
-		const cacheKey = query.toLowerCase().trim();
-		const now = Date.now();
-
-		this.searchCache.set(cacheKey, result);
-		this.searchCacheTimestamps.set(cacheKey, now);
-		this.debug(`[SearchCache] Cached search result for: ${query} (${result.tracks.length} tracks)`);
-	}
-
-	/**
-	 * Clear expired search cache entries
-	 */
-	private clearExpiredSearchCache(): void {
-		const now = Date.now();
-		for (const [key, timestamp] of this.searchCacheTimestamps.entries()) {
-			if (now - timestamp >= this.SEARCH_CACHE_TTL) {
-				this.searchCache.delete(key);
-				this.searchCacheTimestamps.delete(key);
-				this.debug(`[SearchCache] Cleared expired cache entry: ${key}`);
-			}
-		}
-	}
-
-	/**
-	 * Clear all search cache entries
-	 * @example
-	 * player.clearSearchCache();
-	 */
-	public clearSearchCache(): void {
-		const cacheSize = this.searchCache.size;
-		this.searchCache.clear();
-		this.searchCacheTimestamps.clear();
-		this.debug(`[SearchCache] Cleared all ${cacheSize} search cache entries`);
-	}
-
-	/**
-	 * Debug method to check for duplicate search calls
-	 * @param query The search query to check
-	 * @returns Debug information about the query
-	 */
-	public debugSearchQuery(query: string): {
-		isCached: boolean;
-		cacheAge?: number;
-		pluginCount: number;
-		ttsFiltered: boolean;
-	} {
-		const cacheKey = query.toLowerCase().trim();
-		const now = Date.now();
-		const cachedTimestamp = this.searchCacheTimestamps.get(cacheKey);
-		const isCached = cachedTimestamp && now - cachedTimestamp < this.SEARCH_CACHE_TTL;
-
-		const allPlugins = this.pluginManager.getAll();
-		const plugins = allPlugins.filter((p) => {
-			if (p.name.toLowerCase() === "tts" && !query.toLowerCase().startsWith("tts:")) {
-				return false;
-			}
-			return true;
-		});
-
-		return {
-			isCached: !!isCached,
-			cacheAge: cachedTimestamp ? now - cachedTimestamp : undefined,
-			pluginCount: plugins.length,
-			ttsFiltered: allPlugins.length > plugins.length,
-		};
-	}
-
-	/**
-	 * Get related tracks for a given track
-	 * @param {Track} track Track to find related tracks for
-	 * @returns {Track[]} Related tracks or empty array
-	 * @example
-	 * const related = await player.getRelatedTracks(track);
-	 * console.log(`Found ${related.length} related tracks`);
-	 */
-	async getRelatedTracks(track: Track): Promise<Track[]> {
-		if (!track) return [];
-
-		const preferred = this.pluginManager.findPlugin(track.url) || this.pluginManager.get(track.source);
-
-		const all = this.pluginManager.getAll();
-
-		const candidates = [...(preferred ? [preferred] : []), ...all.filter((p) => p !== preferred)].filter(
-			(p) => typeof (p as any).getRelatedTracks === "function",
-		);
-
-		for (const p of candidates) {
-			try {
-				this.debug(`[Player] Trying related from plugin: ${p.name}`);
-				const related = await withTimeout(
-					(p as any).getRelatedTracks(track.url, {
-						limit: 10,
-						history: this.queue.previousTracks,
-					}),
-					this.options.extractorTimeout ?? 15000,
-					`getRelatedTracks timed out for ${p.name}`,
-				);
-
-				if (Array.isArray(related) && related.length > 0) {
-					return related; // success
-				}
-				this.debug(`[Player] ${p.name} returned no related tracks`);
-			} catch (err) {
-				this.debug(`[Player] getRelatedTracks error from ${p.name}:`, err);
-				return [];
-				// try next candidate
-			}
-		}
-		return [];
-	}
-
-	private async generateWillNext(): Promise<void> {
-		const lastTrack = this.queue.previousTracks[this.queue.previousTracks.length - 1] ?? this.queue.currentTrack;
-		if (!lastTrack) return;
-		const related = await this.getRelatedTracks(lastTrack);
-		if (!related || related.length === 0) return;
-		const randomchoice = Math.floor(Math.random() * related.length);
-		const nextTrack = this.queue.nextTrack ? this.queue.nextTrack : related[randomchoice];
-		this.queue.willNextTrack(nextTrack);
-		this.queue.relatedTracks(related);
-		this.debug(`[Player] Will next track if autoplay: ${nextTrack?.title}]`);
-		this.emit("willPlay", nextTrack, related);
-	}
-	//#endregion
-	//#region Play
-
-	/**
-	 * Play a track, search query, search result, or play from queue
-	 *
-	 * @param {string | Track | SearchResult | null} query - Track URL, search query, Track object, SearchResult, or null for play
-	 * @param {string} requestedBy - User ID who requested the track
-	 * @returns {Promise<boolean>} True if playback started successfully
-	 * @example
-	 * await player.play("Never Gonna Give You Up", userId); // Search query
-	 * await player.play("https://youtube.com/watch?v=dQw4w9WgXcQ", userId); // Direct URL
-	 * await player.play("tts: Hello everyone!", userId); // Text-to-Speech
-	 * await player.play(trackObject, userId); // Track object
-	 * await player.play(searchResult, userId); // SearchResult object
-	 * await player.play(null); // play from queue
-	 */
-	async play(query: string | Track | SearchResult | null, requestedBy?: string): Promise<boolean> {
-		const debugInfo =
-			query === null ? "null"
-			: typeof query === "string" ? query
-			: "tracks" in query ? `${query.tracks.length} tracks`
-			: query.title || "unknown";
-		this.debug(`[Player] Play called with query: ${debugInfo}`);
-		this.clearLeaveTimeout();
-		let tracksToAdd: Track[] = [];
-		let isPlaylist = false;
-		let effectiveRequest: ExtensionPlayRequest = { query: query as string | Track, requestedBy };
-		let hookResponse: ExtensionPlayResponse = {};
-
-		try {
-			// Handle null query - play from queue
-			if (query === null) {
-				this.debug(`[Player] Play from queue requested`);
-				if (this.queue.isEmpty) {
-					this.debug(`[Player] Queue is empty, nothing to play`);
-					return false;
-				}
-
-				if (!this.isPlaying) {
-					return await this.playNext();
-				}
-				return true;
-			}
-
-			// Handle SearchResult
-			if (query && typeof query === "object" && "tracks" in query && Array.isArray(query.tracks)) {
-				this.debug(`[Player] Playing SearchResult with ${query.tracks.length} tracks`);
-				tracksToAdd = query.tracks;
-				isPlaylist = !!query.playlist || query.tracks.length > 1;
-
-				if (query.playlist) {
-					this.debug(`[Player] Added playlist: ${query.playlist.name} (${tracksToAdd.length} tracks)`);
-				}
-			} else {
-				// Handle other types (string, Track)
-				const hookOutcome = await this.extensionManager.BeforePlayHooks(effectiveRequest);
-				effectiveRequest = hookOutcome.request;
-				hookResponse = hookOutcome.response;
-				if (effectiveRequest.requestedBy === undefined) {
-					effectiveRequest.requestedBy = requestedBy;
-				}
-
-				const hookTracks = Array.isArray(hookResponse.tracks) ? hookResponse.tracks : undefined;
-
-				if (hookResponse.handled && (!hookTracks || hookTracks.length === 0)) {
-					const handledPayload: ExtensionAfterPlayPayload = {
-						success: hookResponse.success ?? true,
-						query: effectiveRequest.query,
-						requestedBy: effectiveRequest.requestedBy,
-						tracks: [],
-						isPlaylist: hookResponse.isPlaylist ?? false,
-						error: hookResponse.error,
-					};
-					await this.extensionManager.AfterPlayHooks(handledPayload);
-					if (hookResponse.error) {
-						this.emit("playerError", hookResponse.error);
-					}
-					return hookResponse.success ?? true;
-				}
-
-				if (hookTracks && hookTracks.length > 0) {
-					tracksToAdd = hookTracks;
-					isPlaylist = hookResponse.isPlaylist ?? hookTracks.length > 1;
-				} else if (typeof effectiveRequest.query === "string") {
-					const searchResult = await this.search(effectiveRequest.query, effectiveRequest.requestedBy || "Unknown");
-					tracksToAdd = searchResult.tracks;
-					if (searchResult.playlist) {
-						isPlaylist = true;
-						this.debug(`[Player] Added playlist: ${searchResult.playlist.name} (${tracksToAdd.length} tracks)`);
-					}
-				} else if (effectiveRequest.query) {
-					tracksToAdd = [effectiveRequest.query as Track];
-				}
-			}
-
-			if (tracksToAdd.length === 0) {
-				this.debug(`[Player] No tracks found for play`);
-				throw new Error("No tracks found");
-			}
-
-			const isTTS = (t: Track | undefined) => {
-				if (!t) return false;
-				try {
-					return typeof t.source === "string" && t.source.toLowerCase().includes("tts");
-				} catch {
-					return false;
-				}
-			};
-
-			const queryLooksTTS =
-				typeof effectiveRequest.query === "string" && effectiveRequest.query.trim().toLowerCase().startsWith("tts");
-
-			if (
-				!isPlaylist &&
-				tracksToAdd.length > 0 &&
-				this.options?.tts?.interrupt !== false &&
-				(isTTS(tracksToAdd[0]) || queryLooksTTS)
-			) {
-				this.debug(`[Player] Interrupting with TTS: ${tracksToAdd[0].title}`);
-				await this.interruptWithTTSTrack(tracksToAdd[0]);
-				await this.extensionManager.AfterPlayHooks({
-					success: true,
-					query: effectiveRequest.query,
-					requestedBy: effectiveRequest.requestedBy,
-					tracks: tracksToAdd,
-					isPlaylist,
-				});
-				return true;
-			}
-
-			if (isPlaylist) {
-				this.queue.addMultiple(tracksToAdd);
-				this.emit("queueAddList", tracksToAdd);
-			} else {
-				this.queue.add(tracksToAdd[0]);
-				this.emit("queueAdd", tracksToAdd[0]);
-			}
-
-			const started = !this.isPlaying ? await this.playNext() : true;
-
-			await this.extensionManager.AfterPlayHooks({
-				success: started,
-				query: effectiveRequest.query,
-				requestedBy: effectiveRequest.requestedBy,
-				tracks: tracksToAdd,
-				isPlaylist,
-			});
-
-			return started;
-		} catch (error) {
-			await this.extensionManager.AfterPlayHooks({
-				success: false,
-				query: effectiveRequest.query,
-				requestedBy: effectiveRequest.requestedBy,
-				tracks: tracksToAdd,
-				isPlaylist,
-				error: error as Error,
-			});
-			this.debug(`[Player] Play error:`, error);
-			this.emit("playerError", error as Error);
-			return false;
-		}
-	}
-
-	/**
-	 * Create AudioResource with filters and seek applied
-	 *
-	 * @param {StreamInfo} streamInfo - The stream information
-	 * @param {Track} track - The track being processed
-	 * @param {number} position - Position in milliseconds to seek to (0 = no seek)
-	 * @returns {Promise<AudioResource>} The AudioResource with filters and seek applied
-	 */
-	private async createResource(streamInfo: StreamInfo, track: Track, position: number = 0): Promise<AudioResource> {
-		const filterString = this.filter.getFilterString();
-
-		this.debug(`[Player] Creating AudioResource with filters: ${filterString || "none"}, seek: ${position}ms`);
-
-		try {
-			let stream: Readable = streamInfo.stream;
-			// Apply filters and seek if needed
-			if (filterString || position > 0) {
-				stream = await this.filter.applyFiltersAndSeek(streamInfo.stream, position);
-				streamInfo.type = StreamType.Arbitrary;
-			}
-
-			// Create AudioResource with better error handling
-			const resource = createAudioResource(stream, {
-				metadata: track,
-				inputType:
-					streamInfo.type === "webm/opus" ? StreamType.WebmOpus
-					: streamInfo.type === "ogg/opus" ? StreamType.OggOpus
-					: StreamType.Arbitrary,
-				inlineVolume: true,
-			});
-
-			return resource;
-		} catch (error) {
-			this.debug(`[Player] Error creating AudioResource with filters+seek:`, error);
-			// Fallback to basic AudioResource
-			try {
-				const resource = createAudioResource(streamInfo.stream, {
-					metadata: track,
-					inputType:
-						streamInfo.type === "webm/opus" ? StreamType.WebmOpus
-						: streamInfo.type === "ogg/opus" ? StreamType.OggOpus
-						: StreamType.Arbitrary,
-					inlineVolume: true,
-				});
-				return resource;
-			} catch (fallbackError) {
-				this.debug(`[Player] Fallback AudioResource creation failed:`, fallbackError);
-				throw fallbackError;
-			}
-		}
-	}
-	private async getStream(track: Track): Promise<StreamInfo | null> {
-		let stream = await this.extensionManager.provideStream(track);
-		if (stream?.stream) return stream;
-		stream = await this.pluginManager.getStream(track);
-		if (stream?.stream) return stream;
-		throw new Error(`No stream available for track: ${track.title}`);
-	}
-
-	/**
-	 * Start playing a specific track immediately, replacing the current resource.
-	 */
-	private async startTrack(track: Track): Promise<boolean> {
-		try {
-			let streamInfo: StreamInfo | null = await this.getStream(track);
-			this.debug(`[Player] Using stream for track: ${track.title}`);
-			// Kiểm tra nếu có stream thực sự để tạo AudioResource
-			if (streamInfo && (streamInfo as any).stream) {
-				try {
-					// Destroy the old stream and resource before creating a new one
-					this.destroyCurrentStream();
-					if (this.currentResource) {
-						try {
-							const oldStream = (this.currentResource as any)._readableState?.stream || (this.currentResource as any).stream;
-							if (oldStream && typeof oldStream.destroy === "function") {
-								oldStream.destroy();
-							}
-						} catch {}
-						this.currentResource = null;
-					}
-
-					this.currentResource = await this.createResource(streamInfo, track, 0);
-					if (this.volumeInterval) {
-						clearInterval(this.volumeInterval);
-						this.volumeInterval = null;
-					}
-					this.currentResource.volume?.setVolume(this.volume / 100);
-
-					this.debug(`[Player] Playing resource for track: ${track.title}`);
-					this.audioPlayer.play(this.currentResource);
-
-					await entersState(this.audioPlayer, AudioPlayerStatus.Playing, 5_000);
-					return true;
-				} catch (resourceError) {
-					this.debug(`[Player] Error creating/playing resource:`, resourceError);
-					// Try fallback without filters
-					try {
-						this.debug(`[Player] Attempting fallback without filters`);
-						const fallbackResource = createAudioResource(streamInfo.stream, {
-							metadata: track,
-							inputType:
-								streamInfo.type === "webm/opus" ? StreamType.WebmOpus
-								: streamInfo.type === "ogg/opus" ? StreamType.OggOpus
-								: StreamType.Arbitrary,
-							inlineVolume: true,
-						});
-
-						this.currentResource = fallbackResource;
-						this.currentResource.volume?.setVolume(this.volume / 100);
-						this.audioPlayer.play(this.currentResource);
-						await entersState(this.audioPlayer, AudioPlayerStatus.Playing, 5_000);
-						return true;
-					} catch (fallbackError) {
-						this.debug(`[Player] Fallback also failed:`, fallbackError);
-						throw fallbackError;
-					}
-				}
-			} else if (streamInfo && !(streamInfo as any).stream) {
-				// Extension đang xử lý phát nhạc (như Lavalink) - chỉ đánh dấu đang phát
-				this.debug(`[Player] Extension is handling playback for track: ${track.title}`);
-				this.isPlaying = true;
-				this.isPaused = false;
-				this.emit("trackStart", track);
-				return true;
-			} else {
-				throw new Error(`No stream available for track: ${track.title}`);
-			}
-		} catch (error) {
-			this.debug(`[Player] startTrack error:`, error);
-			this.emit("playerError", error as Error, track);
-			return false;
-		}
-	}
-
-	private async playNext(): Promise<boolean> {
-		this.debug(`[Player] playNext called`);
-		const track = this.queue.next(this.skipLoop);
-		this.skipLoop = false;
-		if (!track) {
-			if (this.queue.autoPlay()) {
-				const willnext = this.queue.willNextTrack();
-				if (willnext) {
-					this.debug(`[Player] Auto-playing next track: ${willnext.title}`);
-					this.queue.addMultiple([willnext]);
-					return this.playNext();
-				}
-			}
-
-			this.debug(`[Player] No next track in queue`);
-			this.isPlaying = false;
-			this.emit("queueEnd");
-
-			if (this.options.leaveOnEnd) {
-				this.scheduleLeave();
-			}
-			return false;
-		}
-
-		this.generateWillNext();
-		// A new track is about to play; ensure we don't leave mid-playback
-		this.clearLeaveTimeout();
-
-		try {
-			return await this.startTrack(track);
-		} catch (error) {
-			this.debug(`[Player] playNext error:`, error);
-			this.emit("playerError", error as Error, track);
-			return this.playNext();
-		}
-	}
-
-	//#endregion
-	//#region TTS
-
-	private ensureTTSPlayer(): DiscordAudioPlayer {
-		if (this.ttsPlayer) return this.ttsPlayer;
-		this.ttsPlayer = createAudioPlayer({
-			behaviors: {
-				noSubscriber: NoSubscriberBehavior.Pause,
-				maxMissedFrames: 100,
-			},
-		});
-		this.ttsPlayer.on("error", (e) => this.debug("[TTS] error:", e));
-		return this.ttsPlayer;
-	}
-	/**
-	 * Interrupt current music with a TTS track. Pauses music, swaps the
-	 * subscription to a dedicated TTS player, plays TTS, then resumes.
-	 *
-	 * @param {Track} track - The track to interrupt with
-	 * @returns {Promise<void>}
-	 * @example
-	 * await player.interruptWithTTSTrack(track);
-	 */
-	public async interruptWithTTSTrack(track: Track): Promise<void> {
-		const wasPlaying =
-			this.audioPlayer.state.status === AudioPlayerStatus.Playing ||
-			this.audioPlayer.state.status === AudioPlayerStatus.Buffering;
-
-		let ttsResource: AudioResource | null = null;
-		let ttsStream: any = null;
-
-		try {
-			if (!this.connection) throw new Error("No voice connection for TTS");
-			const ttsPlayer = this.ensureTTSPlayer();
-
-			// Build resource from plugin stream
-			const streamInfo = await this.pluginManager.getStream(track);
-			if (!streamInfo) {
-				throw new Error("No stream available for track: ${track.title}");
-			}
-			ttsStream = streamInfo.stream;
-			const resource = await this.createResource(streamInfo as StreamInfo, track);
-			if (!resource) {
-				throw new Error("No resource available for track: ${track.title}");
-			}
-			ttsResource = resource;
-			if (resource.volume) {
-				resource.volume.setVolume((this.options?.tts?.volume ?? this?.volume ?? 100) / 100);
-			}
-
-			// Pause current music if any
-			try {
-				this.pause();
-			} catch {}
-
-			// Swap subscription and play TTS
-			this.connection.subscribe(ttsPlayer);
-			this.emit("ttsStart", { track });
-			ttsPlayer.play(resource);
-
-			// Wait until TTS starts then finishes
-			await entersState(ttsPlayer, AudioPlayerStatus.Playing, 5_000).catch(() => null);
-			// Derive timeoutMs from resource/track duration when available, with a sensible cap
-			const md: any = (resource as any)?.metadata ?? {};
-			const declared =
-				typeof md.duration === "number" ? md.duration
-				: typeof track?.duration === "number" ? track.duration
-				: undefined;
-			const declaredMs =
-				declared ?
-					declared > 1000 ?
-						declared
-					:	declared * 1000
-				:	undefined;
-			const cap = this.options?.tts?.Max_Time_TTS ?? 60_000;
-			const idleTimeout = declaredMs ? Math.min(cap, Math.max(1_000, declaredMs + 1_500)) : cap;
-			await entersState(ttsPlayer, AudioPlayerStatus.Idle, idleTimeout).catch(() => null);
-
-			// Swap back and resume if needed
-			this.connection.subscribe(this.audioPlayer);
-		} catch (err) {
-			this.debug("[TTS] error while playing:", err);
-			this.emit("playerError", err as Error);
-		} finally {
-			// Clean up TTS stream and resource
-			try {
-				if (ttsStream && typeof ttsStream.destroy === "function") {
-					ttsStream.destroy();
-				}
-			} catch (error) {
-				this.debug("[TTS] Error destroying stream:", error);
-			}
-
-			if (wasPlaying) {
-				try {
-					this.resume();
-				} catch {}
-			}
-			this.emit("ttsEnd");
-		}
-	}
-
-	//#endregion
-	//#region Player Function
-
-	/**
-	 * Connect to a voice channel
-	 *
-	 * @param {VoiceChannel} channel - Discord voice channel
-	 * @returns {Promise<VoiceConnection>} The voice connection
-	 * @example
-	 * await player.connect(voiceChannel);
-	 */
-	async connect(channel: VoiceChannel): Promise<VoiceConnection> {
-		try {
-			this.debug(`[Player] Connecting to voice channel: ${channel.id}`);
-			const connection = joinVoiceChannel({
-				channelId: channel.id,
-				guildId: channel.guildId,
-				adapterCreator: channel.guild.voiceAdapterCreator as any,
-				selfDeaf: this.options.selfDeaf ?? true,
-				selfMute: this.options.selfMute ?? false,
-			});
-
-			await entersState(connection, VoiceConnectionStatus.Ready, 50_000);
-			this.connection = connection;
-
-			connection.on(VoiceConnectionStatus.Disconnected, () => {
-				this.debug(`[Player] VoiceConnectionStatus.Disconnected`);
-				this.destroy();
-			});
-
-			connection.on("error", (error) => {
-				this.debug(`[Player] Voice connection error:`, error);
-				this.emit("connectionError", error);
-			});
-			connection.subscribe(this.audioPlayer);
-
-			this.clearLeaveTimeout();
-			return this.connection;
-		} catch (error) {
-			this.debug(`[Player] Connection error:`, error);
-			this.emit("connectionError", error as Error);
-			this.connection?.destroy();
-			throw error;
-		}
-	}
-
-	/**
-	 * Pause the current track
-	 *
-	 * @returns {boolean} True if paused successfully
-	 * @example
-	 * const paused = player.pause();
-	 * console.log(`Paused: ${paused}`);
-	 */
-	pause(): boolean {
-		this.debug(`[Player] pause called`);
-		if (this.isPlaying && !this.isPaused) {
-			return this.audioPlayer.pause();
-		}
-		return false;
-	}
-
-	/**
-	 * Resume the current track
-	 *
-	 * @returns {boolean} True if resumed successfully
-	 * @example
-	 * const resumed = player.resume();
-	 * console.log(`Resumed: ${resumed}`);
-	 */
-	resume(): boolean {
-		this.debug(`[Player] resume called`);
-		if (this.isPaused) {
-			const result = this.audioPlayer.unpause();
-			if (result) {
-				const track = this.queue.currentTrack;
-				if (track) {
-					this.debug(`[Player] Player resumed on track: ${track.title}`);
-					this.emit("playerResume", track);
-				}
-			}
-			return result;
-		}
-		return false;
-	}
-
-	/**
-	 * Stop the current track
-	 *
-	 * @returns {boolean} True if stopped successfully
-	 * @example
-	 * const stopped = player.stop();
-	 * console.log(`Stopped: ${stopped}`);
-	 */
-	stop(): boolean {
-		this.debug(`[Player] stop called`);
-		this.queue.clear();
-		const result = this.audioPlayer.stop();
-		this.isPlaying = false;
-		this.isPaused = false;
-		this.emit("playerStop");
-		return result;
-	}
-
-	/**
-	 * Seek to a specific position in the current track
-	 *
-	 * @param {number} position - Position in milliseconds to seek to
-	 * @returns {Promise<boolean>} True if seek was successful
-	 * @example
-	 * // Seek to 30 seconds (30000ms)
-	 * const success = await player.seek(30000);
-	 * console.log(`Seek successful: ${success}`);
-	 *
-	 * // Seek to 1 minute 30 seconds (90000ms)
-	 * await player.seek(90000);
-	 */
-	async seek(position: number): Promise<boolean> {
-		this.debug(`[Player] seek called with position: ${position}ms`);
-
-		const track = this.queue.currentTrack;
-		if (!track) {
-			this.debug(`[Player] No current track to seek`);
-			return false;
-		}
-
-		const totalDuration = track.duration > 1000 ? track.duration : track.duration * 1000;
-		if (position < 0 || position > totalDuration) {
-			this.debug(`[Player] Invalid seek position: ${position}ms (track duration: ${totalDuration}ms)`);
-			return false;
-		}
-
-		const streaminfo = await this.getStream(track);
-		if (!streaminfo?.stream) {
-			this.debug(`[Player] No stream to seek`);
-			return false;
-		}
-
-		await this.refeshPlayerResource(true, position);
-
-		return true;
-	}
-
-	/**
-	 * Skip to the next track or skip to a specific index
-	 *
-	 * @param {number} index - Optional index to skip to (0 = next track)
-	 * @returns {boolean} True if skipped successfully
-	 * @example
-	 * const skipped = player.skip(); // Skip to next track
-	 * const skippedToIndex = player.skip(2); // Skip to track at index 2
-	 * console.log(`Skipped: ${skipped}`);
-	 */
-	skip(index?: number): boolean {
-		this.debug(`[Player] skip called with index: ${index}`);
-		try {
-			if (typeof index === "number" && index >= 0) {
-				// Skip to specific index
-				const targetTrack = this.queue.getTrack(index);
-				if (!targetTrack) {
-					this.debug(`[Player] No track found at index ${index}`);
-					return false;
-				}
-
-				// Remove tracks from 0 to index-1
-				for (let i = 0; i < index; i++) {
-					this.queue.remove(0);
-				}
-
-				this.debug(`[Player] Skipped to track at index ${index}: ${targetTrack.title}`);
-				if (this.isPlaying || this.isPaused) {
-					this.skipLoop = true;
-					return this.audioPlayer.stop();
-				}
-				return true;
-			}
-
-			if (this.isPlaying || this.isPaused) {
-				this.skipLoop = true;
-				return this.audioPlayer.stop();
-			}
-
-			return true;
-		} catch (error) {
-			this.debug(`[Player] skip error:`, error);
-			return false;
-		}
-	}
-
-	/**
-	 * Go back to the previous track in history and play it.
-	 *
-	 * @returns {Promise<boolean>} True if previous track was played successfully
-	 * @example
-	 * const previous = await player.previous();
-	 * console.log(`Previous: ${previous}`);
-	 */
-	async previous(): Promise<boolean> {
-		this.debug(`[Player] previous called`);
-		const track = this.queue.previous();
-		if (!track) return false;
-		if (this.queue.currentTrack) this.insert(this.queue.currentTrack, 0);
-		this.clearLeaveTimeout();
-		return this.startTrack(track);
-	}
-
-	/**
-	 * Save a track's stream to a file and return a Readable stream
-	 *
-	 * @param {Track} track - The track to save
-	 * @param {SaveOptions | string} options - Save options or filename string (for backward compatibility)
-	 * @returns {Promise<Readable>} A Readable stream containing the audio data
-	 * @example
-	 * // Save current track to file
-	 * const track = player.currentTrack;
-	 * if (track) {
-	 *   const stream = await player.save(track);
-	 *
-	 *   // Use fs to write the stream to file
-	 *   const fs = require('fs');
-	 *   const writeStream = fs.createWriteStream('saved-song.mp3');
-	 *   stream.pipe(writeStream);
-	 *
-	 *   writeStream.on('finish', () => {
-	 *     console.log('File saved successfully!');
-	 *   });
-	 * }
-	 *
-	 * // Save any track by URL
-	 * const searchResult = await player.search("Never Gonna Give You Up", userId);
-	 * if (searchResult.tracks.length > 0) {
-	 *   const stream = await player.save(searchResult.tracks[0]);
-	 *   // Handle the stream...
-	 * }
-	 *
-	 * // Backward compatibility - filename as string
-	 * const stream = await player.save(track, "my-song.mp3");
-	 */
-	async save(track: Track, options?: SaveOptions | string): Promise<Readable> {
-		this.debug(`[Player] save called for track: ${track.title}`);
-
-		// Parse options - support both SaveOptions object and filename string (backward compatibility)
-		let saveOptions: SaveOptions = {};
-		if (typeof options === "string") {
-			saveOptions = { filename: options };
-		} else if (options) {
-			saveOptions = options;
-		}
-
-		try {
-			// Try extensions first
-			let streamInfo: StreamInfo | null = await this.pluginManager.getStream(track);
-
-			if (!streamInfo || !streamInfo.stream) {
-				throw new Error(`No save stream available for track: ${track.title}`);
-			}
-
-			this.debug(`[Player] Save stream obtained for track: ${track.title}`);
-			if (saveOptions.filename) {
-				this.debug(`[Player] Save options - filename: ${saveOptions.filename}, quality: ${saveOptions.quality || "default"}`);
-			}
-
-			// Apply filters if any are active
-			let finalStream = streamInfo.stream;
-
-			if (saveOptions.filter || saveOptions.seek) {
-				try {
-					this.filter.clearAll();
-					this.filter.applyFilters(saveOptions.filter || []);
-				} catch (err) {
-					this.debug(`[Player] Error applying save filters:`, err);
-				}
-
-				this.debug(`[Player] Applying filters to save stream: ${this.filter.getFilterString() || "none"}`);
-				finalStream = await this.filter.applyFiltersAndSeek(streamInfo.stream, saveOptions.seek || 0).catch((err) => {
-					this.debug(`[Player] Error applying filters to save stream:`, err);
-					return streamInfo!.stream; // Fallback to original stream
-				});
-			}
-
-			// Return the stream directly - caller can pipe it to fs.createWriteStream()
-			return finalStream;
-		} catch (error) {
-			this.debug(`[Player] save error:`, error);
-			this.emit("playerError", error as Error, track);
-			throw error;
-		}
-	}
-
-	/**
-	 * Loop the current track or queue
-	 *
-	 * @param {LoopMode | number} mode - The loop mode to set ("off", "track", "queue") or number (0=off, 1=track, 2=queue)
-	 * @returns {LoopMode} The loop mode
-	 * @example
-	 * const loopMode = player.loop("track"); // Loop current track
-	 * const loopQueue = player.loop("queue"); // Loop entire queue
-	 * const loopTrack = player.loop(1); // Loop current track (same as "track")
-	 * const loopQueueNum = player.loop(2); // Loop entire queue (same as "queue")
-	 * const noLoop = player.loop("off"); // No loop
-	 * const noLoopNum = player.loop(0); // No loop (same as "off")
-	 * console.log(`Loop mode: ${loopMode}`);
-	 */
-	loop(mode?: LoopMode | number): LoopMode {
-		this.debug(`[Player] loop called with mode: ${mode}`);
-
-		if (typeof mode === "number") {
-			// Number mode: convert to text mode
-			switch (mode) {
-				case 0:
-					return this.queue.loop("off");
-				case 1:
-					return this.queue.loop("track");
-				case 2:
-					return this.queue.loop("queue");
-				default:
-					this.debug(`[Player] Invalid loop number: ${mode}, using "off"`);
-					return this.queue.loop("off");
-			}
-		}
-
-		return this.queue.loop(mode as LoopMode);
-	}
-
-	/**
-	 * Set the auto-play mode
-	 *
-	 * @param {boolean} mode - The auto-play mode to set
-	 * @returns {boolean} The auto-play mode
-	 * @example
-	 * const autoPlayMode = player.autoPlay(true);
-	 * console.log(`Auto-play mode: ${autoPlayMode}`);
-	 */
-	autoPlay(mode?: boolean): boolean {
-		return this.queue.autoPlay(mode);
-	}
-
-	/**
-	 * Set the volume of the current track
-	 *
-	 * @param {number} volume - The volume to set
-	 * @returns {boolean} True if volume was set successfully
-	 * @example
-	 * const volumeSet = player.setVolume(50);
-	 * console.log(`Volume set: ${volumeSet}`);
-	 */
-	setVolume(volume: number): boolean {
-		this.debug(`[Player] setVolume called: ${volume}`);
-		if (volume < 0 || volume > 200) return false;
-
-		const oldVolume = this.volume;
-		this.volume = volume;
-		const resourceVolume = this.currentResource?.volume;
-
-		if (resourceVolume) {
-			if (this.volumeInterval) clearInterval(this.volumeInterval);
-
-			const start = resourceVolume.volume;
-			const target = this.volume / 100;
-			const steps = 10;
-			let currentStep = 0;
-
-			this.volumeInterval = setInterval(() => {
-				currentStep++;
-				const value = start + ((target - start) * currentStep) / steps;
-				resourceVolume.setVolume(value);
-				if (currentStep >= steps) {
-					clearInterval(this.volumeInterval!);
-					this.volumeInterval = null;
-				}
-			}, 300);
-		}
-
-		this.emit("volumeChange", oldVolume, volume);
-		return true;
-	}
-
-	/**
-	 * Shuffle the queue
-	 *
-	 * @returns {void}
-	 * @example
-	 * player.shuffle();
-	 */
-	shuffle(): void {
-		this.debug(`[Player] shuffle called`);
-		this.queue.shuffle();
-	}
-
-	/**
-	 * Clear the queue
-	 *
-	 * @returns {void}
-	 * @example
-	 * player.clearQueue();
-	 */
-	clearQueue(): void {
-		this.debug(`[Player] clearQueue called`);
-		this.queue.clear();
-	}
-
-	/**
-	 * Insert a track or list of tracks into the upcoming queue at a specific position (0 = play after current).
-	 * - If `query` is a string, performs a search and inserts resulting tracks (playlist supported).
-	 * - If a Track or Track[] is provided, inserts directly.
-	 * Does not auto-start playback; it only modifies the queue.
-	 *
-	 * @param {string | Track | Track[]} query - The track or tracks to insert
-	 * @param {number} index - The index to insert the tracks at
-	 * @param {string} requestedBy - The user ID who requested the insert
-	 * @returns {Promise<boolean>} True if the tracks were inserted successfully
-	 * @example
-	 * const inserted = await player.insert("Song Name", 0, userId);
-	 * console.log(`Inserted: ${inserted}`);
-	 */
-	async insert(query: string | Track | Track[], index: number, requestedBy?: string): Promise<boolean> {
-		try {
-			this.debug(`[Player] insert called at index ${index} with type: ${typeof query}`);
-			let tracksToAdd: Track[] = [];
-			let isPlaylist = false;
-
-			if (typeof query === "string") {
-				const searchResult = await this.search(query, requestedBy || "Unknown");
-				tracksToAdd = searchResult.tracks || [];
-				isPlaylist = !!searchResult.playlist;
-			} else if (Array.isArray(query)) {
-				tracksToAdd = query;
-				isPlaylist = query.length > 1;
-			} else if (query) {
-				tracksToAdd = [query];
-			}
-
-			if (!tracksToAdd || tracksToAdd.length === 0) {
-				this.debug(`[Player] insert: no tracks resolved`);
-				throw new Error("No tracks to insert");
-			}
-
-			if (tracksToAdd.length === 1) {
-				this.queue.insert(tracksToAdd[0], index);
-				this.emit("queueAdd", tracksToAdd[0]);
-				this.debug(`[Player] Inserted track at index ${index}: ${tracksToAdd[0].title}`);
-			} else {
-				this.queue.insertMultiple(tracksToAdd, index);
-				this.emit("queueAddList", tracksToAdd);
-				this.debug(`[Player] Inserted ${tracksToAdd.length} ${isPlaylist ? "playlist " : ""}tracks at index ${index}`);
-			}
-
-			return true;
-		} catch (error) {
-			this.debug(`[Player] insert error:`, error);
-			this.emit("playerError", error as Error);
-			return false;
-		}
-	}
-
-	/**
-	 * Remove a track from the queue
-	 *
-	 * @param {number} index - The index of the track to remove
-	 * @returns {Track | null} The removed track or null
-	 * @example
-	 * const removed = player.remove(0);
-	 * console.log(`Removed: ${removed?.title}`);
-	 */
-	remove(index: number): Track | null {
-		this.debug(`[Player] remove called for index: ${index}`);
-		const track = this.queue.remove(index);
-		if (track) {
-			this.emit("queueRemove", track, index);
-		}
-		return track;
-	}
-
-	/**
-	 * Get the progress bar of the current track
-	 *
-	 * @param {ProgressBarOptions} options - The options for the progress bar
-	 * @returns {string} The progress bar
-	 * @example
-	 * const progressBar = player.getProgressBar();
-	 * console.log(`Progress bar: ${progressBar}`);
-	 */
-	getProgressBar(options: ProgressBarOptions = {}): string {
-		const { size = 20, barChar = "▬", progressChar = "🔘" } = options;
-		const track = this.queue.currentTrack;
-		const resource = this.currentResource;
-		if (!track || !resource) return "";
-
-		const total = track.duration > 1000 ? track.duration : track.duration * 1000;
-		if (!total) return this.formatTime(resource.playbackDuration);
-
-		const current = resource.playbackDuration;
-		const ratio = Math.min(current / total, 1);
-		const progress = Math.round(ratio * size);
-		const bar = barChar.repeat(progress) + progressChar + barChar.repeat(size - progress);
-
-		return `${this.formatTime(current)} | ${bar} | ${this.formatTime(total)}`;
-	}
-
-	/**
-	 * Get the time of the current track
-	 *
-	 * @returns {Object} The time of the current track
-	 * @example
-	 * const time = player.getTime();
-	 * console.log(`Time: ${time.current}`);
-	 */
-	getTime() {
-		const resource = this.currentResource;
-		const track = this.queue.currentTrack;
-		if (!track || !resource)
-			return {
-				current: 0,
-				total: 0,
-				format: "00:00",
-			};
-
-		const total = track.duration > 1000 ? track.duration : track.duration * 1000;
-
-		return {
-			current: resource?.playbackDuration,
-			total: total,
-			format: this.formatTime(resource.playbackDuration),
-		};
-	}
-
-	/**
-	 * Format the time in the format of HH:MM:SS
-	 *
-	 * @param {number} ms - The time in milliseconds
-	 * @returns {string} The formatted time
-	 * @example
-	 * const formattedTime = player.formatTime(1000);
-	 * console.log(`Formatted time: ${formattedTime}`);
-	 */
-	formatTime(ms: number): string {
-		const totalSeconds = Math.floor(ms / 1000);
-		const hours = Math.floor(totalSeconds / 3600);
-		const minutes = Math.floor((totalSeconds % 3600) / 60);
-		const seconds = totalSeconds % 60;
-		const parts: string[] = [];
-		if (hours > 0) parts.push(String(hours).padStart(2, "0"));
-		parts.push(String(minutes).padStart(2, "0"));
-		parts.push(String(seconds).padStart(2, "0"));
-		return parts.join(":");
-	}
-
-	/**
-	 * Destroy the player
-	 *
-	 * @returns {void}
-	 * @example
-	 * player.destroy();
-	 */
-	destroy(): void {
-		this.debug(`[Player] destroy called`);
-		if (this.leaveTimeout) {
-			clearTimeout(this.leaveTimeout);
-			this.leaveTimeout = null;
-		}
-
-		// Destroy current stream before stopping audio
-		this.destroyCurrentStream();
-
-		this.audioPlayer.stop(true);
-
-		if (this.ttsPlayer) {
-			try {
-				this.ttsPlayer.stop(true);
-			} catch {}
-			this.ttsPlayer = null;
-		}
-
-		if (this.connection) {
-			this.connection.destroy();
-			this.connection = null;
-		}
-
-		this.queue.clear();
-		this.pluginManager.clear();
-		this.filter.destroy();
-		this.extensionManager.destroy();
-		this.isPlaying = false;
-		this.isPaused = false;
-
-		// Clear any remaining intervals
-		if (this.volumeInterval) {
-			clearInterval(this.volumeInterval);
-			this.volumeInterval = null;
-		}
-
-		this.emit("playerDestroy");
-		this.removeAllListeners();
-	}
-
-	//#endregion
-	//#region utils
-	private scheduleLeave(): void {
-		this.debug(`[Player] scheduleLeave called`);
-		if (this.leaveTimeout) {
-			clearTimeout(this.leaveTimeout);
-		}
-
-		if (this.options.leaveOnEmpty && this.options.leaveTimeout) {
-			this.leaveTimeout = setTimeout(() => {
-				this.debug(`[Player] Leaving voice channel after timeoutMs`);
-				this.destroy();
-			}, this.options.leaveTimeout);
-		}
-	}
-
-	/**
-	 * Refesh player resource (apply filter)
-	 *
-	 * @param {boolean} applyToCurrent - Apply filter for curent track
-	 * @param {number} position - Position to seek to in milliseconds
-	 * @returns {Promise<boolean>}
-	 * @example
-	 * const refreshed = await player.refeshPlayerResource(true, 1000);
-	 * console.log(`Refreshed: ${refreshed}`);
-	 */
-	public async refeshPlayerResource(applyToCurrent: boolean = true, position: number = -1): Promise<boolean> {
-		if (!applyToCurrent || !this.queue.currentTrack || !(this.isPlaying || this.isPaused)) {
-			return false;
-		}
-
-		try {
-			const track = this.queue.currentTrack;
-			this.debug(`[Player] Refreshing player resource for track: ${track.title}`);
-
-			// Get current position for seeking
-			const currentPosition = position > 0 ? position : this.currentResource?.playbackDuration || 0;
-
-			const streaminfo = await this.getStream(track);
-			if (!streaminfo?.stream) {
-				this.debug(`[Player] No stream to refresh`);
-				return false;
-			}
-
-			// Create AudioResource with filters and seek to current position
-			const resource = await this.createResource(streaminfo, track, currentPosition);
-
-			// Stop current playback and destroy old resource/stream
-			const wasPlaying = this.isPlaying;
-			const wasPaused = this.isPaused;
-
-			this.audioPlayer.stop();
-
-			// Properly destroy the old resource and stream
-			try {
-				if (this.currentResource) {
-					const oldStream = (this.currentResource as any)._readableState?.stream || (this.currentResource as any).stream;
-					if (oldStream && typeof oldStream.destroy === "function") {
-						oldStream.destroy();
-					}
-				}
-			} catch (error) {
-				this.debug(`[Player] Error destroying old stream in refeshPlayerResource:`, error);
-			}
-
-			this.currentResource = resource;
-
-			// Subscribe to new resource
-			if (this.connection) {
-				this.connection.subscribe(this.audioPlayer);
-				this.audioPlayer.play(resource);
-			}
-
-			// Restore playing state
-			if (wasPlaying && !wasPaused) {
-				this.isPlaying = true;
-				this.isPaused = false;
-			} else if (wasPaused) {
-				this.isPlaying = false;
-				this.isPaused = true;
-				this.audioPlayer.pause();
-			}
-
-			this.debug(`[Player] Successfully applied filter to current track at position ${currentPosition}ms`);
-			return true;
-		} catch (error) {
-			this.debug(`[Player] Error applying filter to current track:`, error);
-			// Filter was still added to active filters, so return true
-			return true;
-		}
-	}
-
-	/**
-	 * Attach an extension to the player
-	 *
-	 * @param {BaseExtension} extension - The extension to attach
-	 * @example
-	 * player.attachExtension(new MyExtension());
-	 */
-	public attachExtension(extension: BaseExtension): void {
-		this.extensionManager.register(extension);
-	}
-
-	/**
-	 * Detach an extension from the player
-	 *
-	 * @param {BaseExtension} extension - The extension to detach
-	 * @example
-	 * player.detachExtension(new MyExtension());
-	 */
-	public detachExtension(extension: BaseExtension): void {
-		this.extensionManager.unregister(extension);
-	}
-
-	/**
-	 * Get all extensions attached to the player
-	 *
-	 * @returns {readonly BaseExtension[]} All attached extensions
-	 * @example
-	 * const extensions = player.getExtensions();
-	 * console.log(`Extensions: ${extensions.length}`);
-	 */
-	public getExtensions(): readonly BaseExtension[] {
-		return this.extensionManager.getAll();
-	}
-
-	private clearLeaveTimeout(): void {
-		if (this.leaveTimeout) {
-			clearTimeout(this.leaveTimeout);
-			this.leaveTimeout = null;
-			this.debug(`[Player] Cleared leave timeoutMs`);
-		}
-	}
-
-	private debug(message?: any, ...optionalParams: any[]): void {
-		if (this.listenerCount("debug") > 0) {
-			this.emit("debug", message, ...optionalParams);
-		}
-	}
-
-	private setupEventListeners(): void {
-		this.audioPlayer.on("stateChange", (oldState, newState) => {
-			this.debug(`[Player] AudioPlayer stateChange from ${oldState.status} to ${newState.status}`);
-			if (newState.status === AudioPlayerStatus.Idle && oldState.status !== AudioPlayerStatus.Idle) {
-				// Track ended
-				const track = this.queue.currentTrack;
-				if (track) {
-					this.debug(`[Player] Track ended: ${track.title}`);
-					this.emit("trackEnd", track);
-				}
-				this.playNext();
-			} else if (
-				newState.status === AudioPlayerStatus.Playing &&
-				(oldState.status === AudioPlayerStatus.Idle || oldState.status === AudioPlayerStatus.Buffering)
-			) {
-				// Track started
-				this.clearLeaveTimeout();
-				this.isPlaying = true;
-				this.isPaused = false;
-				const track = this.queue.currentTrack;
-				if (track) {
-					this.debug(`[Player] Track started: ${track.title}`);
-					this.emit("trackStart", track);
-				}
-			} else if (newState.status === AudioPlayerStatus.Paused && oldState.status !== AudioPlayerStatus.Paused) {
-				// Track paused
-				this.isPaused = true;
-				const track = this.queue.currentTrack;
-				if (track) {
-					this.debug(`[Player] Player paused on track: ${track.title}`);
-					this.emit("playerPause", track);
-				}
-			} else if (newState.status !== AudioPlayerStatus.Paused && oldState.status === AudioPlayerStatus.Paused) {
-				// Track resumed
-				this.isPaused = false;
-				const track = this.queue.currentTrack;
-				if (track) {
-					this.debug(`[Player] Player resumed on track: ${track.title}`);
-					this.emit("playerResume", track);
-				}
-			} else if (newState.status === AudioPlayerStatus.AutoPaused) {
-				this.debug(`[Player] AudioPlayerStatus.AutoPaused`);
-			} else if (newState.status === AudioPlayerStatus.Buffering) {
-				this.debug(`[Player] AudioPlayerStatus.Buffering`);
-			}
-		});
-		this.audioPlayer.on("error", (error) => {
-			this.debug(`[Player] AudioPlayer error:`, error);
-			this.emit("playerError", error, this.queue.currentTrack || undefined);
-			this.playNext();
-		});
-
-		this.audioPlayer.on("debug", (...args) => {
-			if (this.manager.debugEnabled) {
-				this.emit("debug", ...args);
-			}
-		});
-	}
-
-	addPlugin(plugin: SourcePlugin): void {
-		this.debug(`[Player] Adding plugin: ${plugin.name}`);
-		this.pluginManager.register(plugin);
-	}
-
-	removePlugin(name: string): boolean {
-		this.debug(`[Player] Removing plugin: ${name}`);
-		return this.pluginManager.unregister(name);
-	}
-
-	//#endregion
-	//#region Getters
-
-	/**
-	 * Get the size of the queue
-	 *
-	 * @returns {number} The size of the queue
-	 * @example
-	 * const queueSize = player.queueSize;
-	 * console.log(`Queue size: ${queueSize}`);
-	 */
-	get queueSize(): number {
-		return this.queue.size;
-	}
-
-	/**
-	 * Get the current track
-	 *
-	 * @returns {Track | null} The current track or null
-	 * @example
-	 * const currentTrack = player.currentTrack;
-	 * console.log(`Current track: ${currentTrack?.title}`);
-	 */
-	get currentTrack(): Track | null {
-		return this.queue.currentTrack;
-	}
-
-	/**
-	 * Get the previous track
-	 *
-	 * @returns {Track | null} The previous track or null
-	 * @example
-	 * const previousTrack = player.previousTrack;
-	 * console.log(`Previous track: ${previousTrack?.title}`);
-	 */
-	get previousTrack(): Track | null {
-		return this.queue.previousTracks?.at(-1) ?? null;
-	}
-
-	/**
-	 * Get the upcoming tracks
-	 *
-	 * @returns {Track[]} The upcoming tracks
-	 * @example
-	 * const upcomingTracks = player.upcomingTracks;
-	 * console.log(`Upcoming tracks: ${upcomingTracks.length}`);
-	 */
-	get upcomingTracks(): Track[] {
-		return this.queue.getTracks();
-	}
-
-	/**
-	 * Get the previous tracks
-	 *
-	 * @returns {Track[]} The previous tracks
-	 * @example
-	 * const previousTracks = player.previousTracks;
-	 * console.log(`Previous tracks: ${previousTracks.length}`);
-	 */
-	get previousTracks(): Track[] {
-		return this.queue.previousTracks;
-	}
-
-	/**
-	 * Get the available plugins
-	 *
-	 * @returns {string[]} The available plugins
-	 * @example
-	 * const availablePlugins = player.availablePlugins;
-	 * console.log(`Available plugins: ${availablePlugins.length}`);
-	 */
-	get availablePlugins(): string[] {
-		return this.pluginManager.getAll().map((p) => p.name);
-	}
-
-	/**
-	 * Get the related tracks
-	 *
-	 * @returns {Track[] | null} The related tracks or null
-	 * @example
-	 * const relatedTracks = player.relatedTracks;
-	 * console.log(`Related tracks: ${relatedTracks?.length}`);
-	 */
-	get relatedTracks(): Track[] | null {
-		return this.queue.relatedTracks();
-	}
-
-	//#endregion
-}
+import { EventEmitter } from "events";
+import {
+	createAudioPlayer,
+	createAudioResource,
+	entersState,
+	AudioPlayerStatus,
+	VoiceConnection,
+	AudioPlayer as DiscordAudioPlayer,
+	VoiceConnectionStatus,
+	NoSubscriberBehavior,
+	joinVoiceChannel,
+	AudioResource,
+	StreamType,
+} from "@discordjs/voice";
+
+import { Readable } from "stream";
+import type { BaseExtension } from "../extensions";
+import type {
+	Track,
+	PlayerOptions,
+	PlayerEvents,
+	SourcePlugin,
+	SearchResult,
+	ProgressBarOptions,
+	LoopMode,
+	StreamInfo,
+	SaveOptions,
+	VoiceChannel,
+	ExtensionPlayRequest,
+	ExtensionPlayResponse,
+	ExtensionAfterPlayPayload,
+} from "../types";
+import type { PlayerManager } from "./PlayerManager";
+
+import { Queue } from "./Queue";
+import { PluginManager } from "../plugins";
+import { ExtensionManager } from "../extensions";
+import { withTimeout } from "../utils/timeout";
+import { FilterManager } from "./FilterManager";
+
+export declare interface Player {
+	on<K extends keyof PlayerEvents>(event: K, listener: (...args: PlayerEvents[K]) => void): this;
+	emit<K extends keyof PlayerEvents>(event: K, ...args: PlayerEvents[K]): boolean;
+}
+
+/**
+ * Represents a music player for a specific Discord guild.
+ *
+ * @example
+ * // Create and configure player
+ * const player = await manager.create(guildId, {
+ *   tts: { interrupt: true, volume: 1 },
+ *   leaveOnEnd: true,
+ *   leaveTimeout: 30000
+ * });
+ *
+ * // Connect to voice channel
+ * await player.connect(voiceChannel);
+ *
+ * // Play different types of content
+ * await player.play("Never Gonna Give You Up", userId); // Search query
+ * await player.play("https://youtube.com/watch?v=dQw4w9WgXcQ", userId); // Direct URL
+ * await player.play("tts: Hello everyone!", userId); // Text-to-Speech
+ *
+ * // Player controls
+ * player.pause(); // Pause current track
+ * player.resume(); // Resume paused track
+ * player.skip(); // Skip to next track
+ * player.stop(); // Stop and clear queue
+ * player.setVolume(0.5); // Set volume to 50%
+ *
+ * // Event handling
+ * player.on("trackStart", (player, track) => {
+ *   console.log(`Now playing: ${track.title}`);
+ * });
+ *
+ * player.on("queueEnd", (player) => {
+ *   console.log("Queue finished");
+ * });
+ *
+ */
+export class Player extends EventEmitter {
+	public readonly guildId: string;
+	public connection: VoiceConnection | null = null;
+	public audioPlayer: DiscordAudioPlayer;
+	public queue: Queue;
+	public volume: number = 100;
+	public isPlaying: boolean = false;
+	public isPaused: boolean = false;
+	public options: PlayerOptions;
+	public pluginManager: PluginManager;
+	public extensionManager: ExtensionManager;
+	public userdata?: Record<string, any>;
+	private manager: PlayerManager;
+	private leaveTimeout: NodeJS.Timeout | null = null;
+	private currentResource: AudioResource | null = null;
+	private volumeInterval: NodeJS.Timeout | null = null;
+	private skipLoop = false;
+	private filter!: FilterManager;
+
+	// Cache for search results to avoid duplicate calls
+	private searchCache = new Map<string, SearchResult>();
+	private readonly SEARCH_CACHE_TTL = 2 * 60 * 1000; // 2 minutes
+	private searchCacheTimestamps = new Map<string, number>();
+	private ttsPlayer: DiscordAudioPlayer | null = null;
+
+	constructor(guildId: string, options: PlayerOptions = {}, manager: PlayerManager) {
+		super();
+		this.debug(`[Player] Constructor called for guildId: ${guildId}`);
+		this.guildId = guildId;
+		this.queue = new Queue();
+		this.manager = manager;
+		this.audioPlayer = createAudioPlayer({
+			behaviors: {
+				noSubscriber: NoSubscriberBehavior.Pause,
+				maxMissedFrames: 100,
+			},
+		});
+
+		this.options = {
+			leaveOnEnd: true,
+			leaveOnEmpty: true,
+			leaveTimeout: 100000,
+			volume: 100,
+			quality: "high",
+			extractorTimeout: 50000,
+			selfDeaf: true,
+			selfMute: false,
+			...options,
+			tts: {
+				createPlayer: false,
+				interrupt: true,
+				volume: 100,
+				Max_Time_TTS: 60_000,
+				...(options?.tts || {}),
+			},
+		};
+		this.filter = new FilterManager(this, this.manager);
+		this.extensionManager = new ExtensionManager(this, this.manager);
+		this.pluginManager = new PluginManager(this, this.manager, {
+			extractorTimeout: this.options.extractorTimeout,
+		});
+
+		this.volume = this.options.volume || 100;
+		this.userdata = this.options.userdata;
+		this.setupEventListeners();
+
+		// Initialize filters from options
+		if (this.options.filters && this.options.filters.length > 0) {
+			this.debug(`[Player] Initializing ${this.options.filters.length} filters from options`);
+			// Use async version but don't await in constructor
+			this.filter.applyFilters(this.options.filters).catch((error: any) => {
+				this.debug(`[Player] Error initializing filters:`, error);
+			});
+		}
+
+		// Optionally pre-create the TTS AudioPlayer
+		if (this.options?.tts?.createPlayer) {
+			this.ensureTTSPlayer();
+		}
+	}
+
+	/**
+	 * Destroy current stream to prevent memory leaks
+	 * @private
+	 */
+	private destroyCurrentStream(): void {
+		if (!this.currentResource) return;
+
+		const stream = (this.currentResource as any)?.metadata?.stream ?? (this.currentResource as any)?.stream;
+
+		if (stream?.destroy) {
+			stream.destroy();
+		}
+
+		this.currentResource = null;
+	}
+
+	//#region Search
+
+	/**
+	 * Search for tracks using the player's extensions and plugins
+	 *
+	 * @param {string} query - The query to search for
+	 * @param {string} requestedBy - The user ID who requested the search
+	 * @returns {Promise<SearchResult>} The search result
+	 * @example
+	 * const result = await player.search("Never Gonna Give You Up", userId);
+	 * console.log(`Search result: ${result.tracks.length} tracks`);
+	 */
+	async search(query: string, requestedBy: string): Promise<SearchResult> {
+		this.debug(`[Player] Search called with query: ${query}, requestedBy: ${requestedBy}`);
+
+		// Clear expired search cache periodically
+		if (Math.random() < 0.1) {
+			// 10% chance to clean cache
+			this.clearExpiredSearchCache();
+		}
+
+		// Check cache first
+		const cachedResult = this.getCachedSearchResult(query);
+		if (cachedResult) {
+			return cachedResult;
+		}
+
+		// Try extensions first
+		const extensionResult = await this.extensionManager.provideSearch(query, requestedBy);
+		if (extensionResult && Array.isArray(extensionResult.tracks) && extensionResult.tracks.length > 0) {
+			this.debug(`[Player] Extension handled search for query: ${query}`);
+			this.cacheSearchResult(query, extensionResult);
+			return extensionResult;
+		}
+
+		// Get plugins and filter out TTS for regular searches
+		const allPlugins = this.pluginManager.getAll();
+		const plugins = allPlugins.filter((p) => {
+			// Skip TTS plugin for regular searches (unless query starts with "tts:")
+			if (p.name.toLowerCase() === "tts" && !query.toLowerCase().startsWith("tts:")) {
+				this.debug(`[Player] Skipping TTS plugin for regular search: ${query}`);
+				return false;
+			}
+			return true;
+		});
+
+		this.debug(`[Player] Using ${plugins.length} plugins for search (filtered from ${allPlugins.length})`);
+
+		let lastError: any = null;
+		let searchAttempts = 0;
+
+		for (const p of plugins) {
+			searchAttempts++;
+			try {
+				this.debug(`[Player] Trying plugin for search: ${p.name} (attempt ${searchAttempts}/${plugins.length})`);
+				const startTime = Date.now();
+				const res = await withTimeout(
+					p.search(query, requestedBy),
+					this.options.extractorTimeout ?? 15000,
+					`Search operation timed out for ${p.name}`,
+				);
+				const duration = Date.now() - startTime;
+
+				if (res && Array.isArray(res.tracks) && res.tracks.length > 0) {
+					this.debug(`[Player] Plugin '${p.name}' returned ${res.tracks.length} tracks in ${duration}ms`);
+					this.cacheSearchResult(query, res);
+					return res;
+				}
+				this.debug(`[Player] Plugin '${p.name}' returned no tracks in ${duration}ms`);
+			} catch (error) {
+				const errorMessage = error instanceof Error ? error.message : String(error);
+				this.debug(`[Player] Search via plugin '${p.name}' failed: ${errorMessage}`);
+				lastError = error;
+				// Continue to next plugin
+			}
+		}
+
+		this.debug(`[Player] No plugins returned results for query: ${query} (tried ${searchAttempts} plugins)`);
+		if (lastError) this.emit("playerError", lastError as Error);
+		throw new Error(`No plugin found to handle: ${query}`);
+	}
+
+	/**
+	 * Get cached search result or null if not found/expired
+	 * @param query The search query
+	 * @returns Cached search result or null
+	 */
+	private getCachedSearchResult(query: string): SearchResult | null {
+		const cacheKey = query.toLowerCase().trim();
+		const now = Date.now();
+
+		const cachedTimestamp = this.searchCacheTimestamps.get(cacheKey);
+		if (cachedTimestamp && now - cachedTimestamp < this.SEARCH_CACHE_TTL) {
+			const cachedResult = this.searchCache.get(cacheKey);
+			if (cachedResult) {
+				this.debug(`[SearchCache] Using cached search result for: ${query}`);
+				return cachedResult;
+			}
+		}
+
+		return null;
+	}
+
+	/**
+	 * Cache search result
+	 * @param query The search query
+	 * @param result The search result to cache
+	 */
+	private cacheSearchResult(query: string, result: SearchResult): void {
+		const cacheKey = query.toLowerCase().trim();
+		const now = Date.now();
+
+		this.searchCache.set(cacheKey, result);
+		this.searchCacheTimestamps.set(cacheKey, now);
+		this.debug(`[SearchCache] Cached search result for: ${query} (${result.tracks.length} tracks)`);
+	}
+
+	/**
+	 * Clear expired search cache entries
+	 */
+	private clearExpiredSearchCache(): void {
+		const now = Date.now();
+		for (const [key, timestamp] of this.searchCacheTimestamps.entries()) {
+			if (now - timestamp >= this.SEARCH_CACHE_TTL) {
+				this.searchCache.delete(key);
+				this.searchCacheTimestamps.delete(key);
+				this.debug(`[SearchCache] Cleared expired cache entry: ${key}`);
+			}
+		}
+	}
+
+	/**
+	 * Clear all search cache entries
+	 * @example
+	 * player.clearSearchCache();
+	 */
+	public clearSearchCache(): void {
+		const cacheSize = this.searchCache.size;
+		this.searchCache.clear();
+		this.searchCacheTimestamps.clear();
+		this.debug(`[SearchCache] Cleared all ${cacheSize} search cache entries`);
+	}
+
+	/**
+	 * Debug method to check for duplicate search calls
+	 * @param query The search query to check
+	 * @returns Debug information about the query
+	 */
+	public debugSearchQuery(query: string): {
+		isCached: boolean;
+		cacheAge?: number;
+		pluginCount: number;
+		ttsFiltered: boolean;
+	} {
+		const cacheKey = query.toLowerCase().trim();
+		const now = Date.now();
+		const cachedTimestamp = this.searchCacheTimestamps.get(cacheKey);
+		const isCached = cachedTimestamp && now - cachedTimestamp < this.SEARCH_CACHE_TTL;
+
+		const allPlugins = this.pluginManager.getAll();
+		const plugins = allPlugins.filter((p) => {
+			if (p.name.toLowerCase() === "tts" && !query.toLowerCase().startsWith("tts:")) {
+				return false;
+			}
+			return true;
+		});
+
+		return {
+			isCached: !!isCached,
+			cacheAge: cachedTimestamp ? now - cachedTimestamp : undefined,
+			pluginCount: plugins.length,
+			ttsFiltered: allPlugins.length > plugins.length,
+		};
+	}
+
+	private async generateWillNext(): Promise<void> {
+		const lastTrack = this.queue.previousTracks[this.queue.previousTracks.length - 1] ?? this.queue.currentTrack;
+		if (!lastTrack) return;
+		const related = await this.pluginManager.getRelatedTracks(lastTrack);
+		if (!related || related.length === 0) return;
+		const randomchoice = Math.floor(Math.random() * related.length);
+		const nextTrack = this.queue.nextTrack ? this.queue.nextTrack : related[randomchoice];
+		this.queue.willNextTrack(nextTrack);
+		this.queue.relatedTracks(related);
+		this.debug(`[Player] Will next track if autoplay: ${nextTrack?.title}]`);
+		this.emit("willPlay", nextTrack, related);
+	}
+	//#endregion
+	//#region Play
+
+	/**
+	 * Play a track, search query, search result, or play from queue
+	 *
+	 * @param {string | Track | SearchResult | null} query - Track URL, search query, Track object, SearchResult, or null for play
+	 * @param {string} requestedBy - User ID who requested the track
+	 * @returns {Promise<boolean>} True if playback started successfully
+	 * @example
+	 * await player.play("Never Gonna Give You Up", userId); // Search query
+	 * await player.play("https://youtube.com/watch?v=dQw4w9WgXcQ", userId); // Direct URL
+	 * await player.play("tts: Hello everyone!", userId); // Text-to-Speech
+	 * await player.play(trackObject, userId); // Track object
+	 * await player.play(searchResult, userId); // SearchResult object
+	 * await player.play(null); // play from queue
+	 */
+	async play(query: string | Track | SearchResult | null, requestedBy?: string): Promise<boolean> {
+		const debugInfo =
+			query === null ? "null"
+			: typeof query === "string" ? query
+			: "tracks" in query ? `${query.tracks.length} tracks`
+			: query.title || "unknown";
+		this.debug(`[Player] Play called with query: ${debugInfo}`);
+		this.clearLeaveTimeout();
+		let tracksToAdd: Track[] = [];
+		let isPlaylist = false;
+		let effectiveRequest: ExtensionPlayRequest = { query: query as string | Track, requestedBy };
+		let hookResponse: ExtensionPlayResponse = {};
+
+		try {
+			// Handle null query - play from queue
+			if (query === null) {
+				this.debug(`[Player] Play from queue requested`);
+				if (this.queue.isEmpty) {
+					this.debug(`[Player] Queue is empty, nothing to play`);
+					return false;
+				}
+
+				if (!this.isPlaying) {
+					return await this.playNext();
+				}
+				return true;
+			}
+
+			// Handle SearchResult
+			if (query && typeof query === "object" && "tracks" in query && Array.isArray(query.tracks)) {
+				this.debug(`[Player] Playing SearchResult with ${query.tracks.length} tracks`);
+				tracksToAdd = query.tracks;
+				isPlaylist = !!query.playlist || query.tracks.length > 1;
+
+				if (query.playlist) {
+					this.debug(`[Player] Added playlist: ${query.playlist.name} (${tracksToAdd.length} tracks)`);
+				}
+			} else {
+				// Handle other types (string, Track)
+				const hookOutcome = await this.extensionManager.BeforePlayHooks(effectiveRequest);
+				effectiveRequest = hookOutcome.request;
+				hookResponse = hookOutcome.response;
+				if (effectiveRequest.requestedBy === undefined) {
+					effectiveRequest.requestedBy = requestedBy;
+				}
+
+				const hookTracks = Array.isArray(hookResponse.tracks) ? hookResponse.tracks : undefined;
+
+				if (hookResponse.handled && (!hookTracks || hookTracks.length === 0)) {
+					const handledPayload: ExtensionAfterPlayPayload = {
+						success: hookResponse.success ?? true,
+						query: effectiveRequest.query,
+						requestedBy: effectiveRequest.requestedBy,
+						tracks: [],
+						isPlaylist: hookResponse.isPlaylist ?? false,
+						error: hookResponse.error,
+					};
+					await this.extensionManager.AfterPlayHooks(handledPayload);
+					if (hookResponse.error) {
+						this.emit("playerError", hookResponse.error);
+					}
+					return hookResponse.success ?? true;
+				}
+
+				if (hookTracks && hookTracks.length > 0) {
+					tracksToAdd = hookTracks;
+					isPlaylist = hookResponse.isPlaylist ?? hookTracks.length > 1;
+				} else if (typeof effectiveRequest.query === "string") {
+					const searchResult = await this.search(effectiveRequest.query, effectiveRequest.requestedBy || "Unknown");
+					tracksToAdd = searchResult.tracks;
+					if (searchResult.playlist) {
+						isPlaylist = true;
+						this.debug(`[Player] Added playlist: ${searchResult.playlist.name} (${tracksToAdd.length} tracks)`);
+					}
+				} else if (effectiveRequest.query) {
+					tracksToAdd = [effectiveRequest.query as Track];
+				}
+			}
+
+			if (tracksToAdd.length === 0) {
+				this.debug(`[Player] No tracks found for play`);
+				throw new Error("No tracks found");
+			}
+
+			const isTTS = (t: Track | undefined) => {
+				if (!t) return false;
+				try {
+					return typeof t.source === "string" && t.source.toLowerCase().includes("tts");
+				} catch {
+					return false;
+				}
+			};
+
+			const queryLooksTTS =
+				typeof effectiveRequest.query === "string" && effectiveRequest.query.trim().toLowerCase().startsWith("tts");
+
+			if (
+				!isPlaylist &&
+				tracksToAdd.length > 0 &&
+				this.options?.tts?.interrupt !== false &&
+				(isTTS(tracksToAdd[0]) || queryLooksTTS)
+			) {
+				this.debug(`[Player] Interrupting with TTS: ${tracksToAdd[0].title}`);
+				await this.interruptWithTTSTrack(tracksToAdd[0]);
+				await this.extensionManager.AfterPlayHooks({
+					success: true,
+					query: effectiveRequest.query,
+					requestedBy: effectiveRequest.requestedBy,
+					tracks: tracksToAdd,
+					isPlaylist,
+				});
+				return true;
+			}
+
+			if (isPlaylist) {
+				this.queue.addMultiple(tracksToAdd);
+				this.emit("queueAddList", tracksToAdd);
+			} else {
+				this.queue.add(tracksToAdd[0]);
+				this.emit("queueAdd", tracksToAdd[0]);
+			}
+
+			const started = !this.isPlaying ? await this.playNext() : true;
+
+			await this.extensionManager.AfterPlayHooks({
+				success: started,
+				query: effectiveRequest.query,
+				requestedBy: effectiveRequest.requestedBy,
+				tracks: tracksToAdd,
+				isPlaylist,
+			});
+
+			return started;
+		} catch (error) {
+			await this.extensionManager.AfterPlayHooks({
+				success: false,
+				query: effectiveRequest.query,
+				requestedBy: effectiveRequest.requestedBy,
+				tracks: tracksToAdd,
+				isPlaylist,
+				error: error as Error,
+			});
+			this.debug(`[Player] Play error:`, error);
+			this.emit("playerError", error as Error);
+			return false;
+		}
+	}
+
+	/**
+	 * Create AudioResource with filters and seek applied
+	 *
+	 * @param {StreamInfo} streamInfo - The stream information
+	 * @param {Track} track - The track being processed
+	 * @param {number} position - Position in milliseconds to seek to (0 = no seek)
+	 * @returns {Promise<AudioResource>} The AudioResource with filters and seek applied
+	 */
+	private async createResource(streamInfo: StreamInfo, track: Track, position: number = 0): Promise<AudioResource> {
+		const filterString = this.filter.getFilterString();
+
+		this.debug(`[Player] Creating AudioResource with filters: ${filterString || "none"}, seek: ${position}ms`);
+
+		try {
+			let stream: Readable = streamInfo.stream;
+			// Apply filters and seek if needed
+			if (filterString || position > 0) {
+				stream = await this.filter.applyFiltersAndSeek(streamInfo.stream, position);
+				streamInfo.type = StreamType.Arbitrary;
+			}
+
+			// Create AudioResource with better error handling
+			const resource = createAudioResource(stream, {
+				metadata: track,
+				inputType:
+					streamInfo.type === "webm/opus" ? StreamType.WebmOpus
+					: streamInfo.type === "ogg/opus" ? StreamType.OggOpus
+					: StreamType.Arbitrary,
+				inlineVolume: true,
+			});
+
+			return resource;
+		} catch (error) {
+			this.debug(`[Player] Error creating AudioResource with filters+seek:`, error);
+			// Fallback to basic AudioResource
+			try {
+				const resource = createAudioResource(streamInfo.stream, {
+					metadata: track,
+					inputType:
+						streamInfo.type === "webm/opus" ? StreamType.WebmOpus
+						: streamInfo.type === "ogg/opus" ? StreamType.OggOpus
+						: StreamType.Arbitrary,
+					inlineVolume: true,
+				});
+				return resource;
+			} catch (fallbackError) {
+				this.debug(`[Player] Fallback AudioResource creation failed:`, fallbackError);
+				throw fallbackError;
+			}
+		}
+	}
+	private async getStream(track: Track): Promise<StreamInfo | null> {
+		let stream = await this.extensionManager.provideStream(track);
+		if (stream?.stream) return stream;
+		stream = await this.pluginManager.getStream(track);
+		if (stream?.stream) return stream;
+		throw new Error(`No stream available for track: ${track.title}`);
+	}
+
+	/**
+	 * Start playing a specific track immediately, replacing the current resource.
+	 */
+	private async startTrack(track: Track): Promise<boolean> {
+		try {
+			let streamInfo: StreamInfo | null = await this.getStream(track);
+			this.debug(`[Player] Using stream for track: ${track.title}`);
+			// Kiểm tra nếu có stream thực sự để tạo AudioResource
+			if (streamInfo && (streamInfo as any).stream) {
+				try {
+					// Destroy the old stream and resource before creating a new one
+					this.destroyCurrentStream();
+
+					this.currentResource = await this.createResource(streamInfo, track, 0);
+					if (this.volumeInterval) {
+						clearInterval(this.volumeInterval);
+						this.volumeInterval = null;
+					}
+					this.currentResource.volume?.setVolume(this.volume / 100);
+
+					this.debug(`[Player] Playing resource for track: ${track.title}`);
+					this.audioPlayer.play(this.currentResource);
+
+					await entersState(this.audioPlayer, AudioPlayerStatus.Playing, 5_000);
+					return true;
+				} catch (resourceError) {
+					this.debug(`[Player] Error creating/playing resource:`, resourceError);
+					// Try fallback without filters
+					try {
+						this.debug(`[Player] Attempting fallback without filters`);
+						const fallbackResource = createAudioResource(streamInfo.stream, {
+							metadata: track,
+							inputType:
+								streamInfo.type === "webm/opus" ? StreamType.WebmOpus
+								: streamInfo.type === "ogg/opus" ? StreamType.OggOpus
+								: StreamType.Arbitrary,
+							inlineVolume: true,
+						});
+
+						this.currentResource = fallbackResource;
+						this.currentResource.volume?.setVolume(this.volume / 100);
+						this.audioPlayer.play(this.currentResource);
+						await entersState(this.audioPlayer, AudioPlayerStatus.Playing, 5_000);
+						return true;
+					} catch (fallbackError) {
+						this.debug(`[Player] Fallback also failed:`, fallbackError);
+						throw fallbackError;
+					}
+				}
+			} else if (streamInfo && !(streamInfo as any).stream) {
+				// Extension đang xử lý phát nhạc (như Lavalink) - chỉ đánh dấu đang phát
+				this.debug(`[Player] Extension is handling playback for track: ${track.title}`);
+				this.isPlaying = true;
+				this.isPaused = false;
+				this.emit("trackStart", track);
+				return true;
+			} else {
+				throw new Error(`No stream available for track: ${track.title}`);
+			}
+		} catch (error) {
+			this.debug(`[Player] startTrack error:`, error);
+			this.emit("playerError", error as Error, track);
+			return false;
+		}
+	}
+
+	private async playNext(): Promise<boolean> {
+		this.debug(`[Player] playNext called by ${new Error().stack?.split("\n")[2]?.trim()}`);
+		while (true) {
+			const track = this.queue.next(this.skipLoop);
+			this.skipLoop = false;
+
+			if (!track) {
+				if (this.queue.autoPlay()) {
+					const willnext = this.queue.willNextTrack();
+					if (willnext) {
+						this.queue.addMultiple([willnext]);
+						continue;
+					}
+				}
+				this.debug(`[Player] No next track in queue`);
+				this.isPlaying = false;
+				this.emit("queueEnd");
+
+				if (this.options.leaveOnEnd) {
+					this.scheduleLeave();
+				}
+
+				return false;
+			}
+
+			this.generateWillNext();
+			this.clearLeaveTimeout();
+			this.debug(`[Player] playNext called for track: ${track.title}`);
+
+			try {
+				return await this.startTrack(track);
+			} catch (err) {
+				this.debug(`[Player] playNext error:`, err);
+				this.emit("playerError", err as Error, track);
+				continue;
+			}
+		}
+	}
+
+	//#endregion
+	//#region TTS
+
+	private ensureTTSPlayer(): DiscordAudioPlayer {
+		if (this.ttsPlayer) return this.ttsPlayer;
+		this.ttsPlayer = createAudioPlayer({
+			behaviors: {
+				noSubscriber: NoSubscriberBehavior.Pause,
+				maxMissedFrames: 100,
+			},
+		});
+		this.ttsPlayer.on("error", (e) => this.debug("[TTS] error:", e));
+		return this.ttsPlayer;
+	}
+	/**
+	 * Interrupt current music with a TTS track. Pauses music, swaps the
+	 * subscription to a dedicated TTS player, plays TTS, then resumes.
+	 *
+	 * @param {Track} track - The track to interrupt with
+	 * @returns {Promise<void>}
+	 * @example
+	 * await player.interruptWithTTSTrack(track);
+	 */
+	public async interruptWithTTSTrack(track: Track): Promise<void> {
+		const wasPlaying =
+			this.audioPlayer.state.status === AudioPlayerStatus.Playing ||
+			this.audioPlayer.state.status === AudioPlayerStatus.Buffering;
+
+		let ttsResource: AudioResource | null = null;
+		let ttsStream: any = null;
+
+		try {
+			if (!this.connection) throw new Error("No voice connection for TTS");
+			const ttsPlayer = this.ensureTTSPlayer();
+
+			// Build resource from plugin stream
+			const streamInfo = await this.pluginManager.getStream(track);
+			if (!streamInfo) {
+				throw new Error("No stream available for track: ${track.title}");
+			}
+			ttsStream = streamInfo.stream;
+			const resource = await this.createResource(streamInfo as StreamInfo, track);
+			if (!resource) {
+				throw new Error("No resource available for track: ${track.title}");
+			}
+			ttsResource = resource;
+			if (resource.volume) {
+				resource.volume.setVolume((this.options?.tts?.volume ?? this?.volume ?? 100) / 100);
+			}
+
+			// Pause current music if any
+			try {
+				this.pause();
+			} catch {}
+
+			// Swap subscription and play TTS
+			this.connection.subscribe(ttsPlayer);
+			this.emit("ttsStart", { track });
+			ttsPlayer.play(resource);
+
+			// Wait until TTS starts then finishes
+			await entersState(ttsPlayer, AudioPlayerStatus.Playing, 5_000).catch(() => null);
+			// Derive timeoutMs from resource/track duration when available, with a sensible cap
+			const md: any = (resource as any)?.metadata ?? {};
+			const declared =
+				typeof md.duration === "number" ? md.duration
+				: typeof track?.duration === "number" ? track.duration
+				: undefined;
+			const declaredMs =
+				declared ?
+					declared > 1000 ?
+						declared
+					:	declared * 1000
+				:	undefined;
+			const cap = this.options?.tts?.Max_Time_TTS ?? 60_000;
+			const idleTimeout = declaredMs ? Math.min(cap, Math.max(1_000, declaredMs + 1_500)) : cap;
+			await entersState(ttsPlayer, AudioPlayerStatus.Idle, idleTimeout).catch(() => null);
+
+			// Swap back and resume if needed
+			this.connection.subscribe(this.audioPlayer);
+		} catch (err) {
+			this.debug("[TTS] error while playing:", err);
+			this.emit("playerError", err as Error);
+		} finally {
+			// Clean up TTS stream and resource
+			try {
+				if (ttsStream && typeof ttsStream.destroy === "function") {
+					ttsStream.destroy();
+				}
+			} catch (error) {
+				this.debug("[TTS] Error destroying stream:", error);
+			}
+
+			if (wasPlaying) {
+				try {
+					this.resume();
+				} catch {}
+			}
+			this.emit("ttsEnd");
+		}
+	}
+
+	//#endregion
+	//#region Player Function
+
+	/**
+	 * Connect to a voice channel
+	 *
+	 * @param {VoiceChannel} channel - Discord voice channel
+	 * @returns {Promise<VoiceConnection>} The voice connection
+	 * @example
+	 * await player.connect(voiceChannel);
+	 */
+	async connect(channel: VoiceChannel): Promise<VoiceConnection> {
+		try {
+			this.debug(`[Player] Connecting to voice channel: ${channel.id}`);
+			const connection = joinVoiceChannel({
+				channelId: channel.id,
+				guildId: channel.guildId,
+				adapterCreator: channel.guild.voiceAdapterCreator as any,
+				selfDeaf: this.options.selfDeaf ?? true,
+				selfMute: this.options.selfMute ?? false,
+			});
+
+			await entersState(connection, VoiceConnectionStatus.Ready, 50_000);
+			this.connection = connection;
+
+			connection.on(VoiceConnectionStatus.Disconnected, async () => {
+				try {
+					//  move channel
+					await Promise.race([
+						entersState(connection, VoiceConnectionStatus.Signalling, 5_000),
+						entersState(connection, VoiceConnectionStatus.Connecting, 5_000),
+					]);
+					//  Signalling/Connecting → reconnect
+					this.debug(`[Player] Reconnecting after channel move...`);
+				} catch {
+					// no reconnect in 5 giây → disconnect
+					this.debug(`[Player] Truly disconnected, destroying player`);
+					this.destroy();
+				}
+			});
+
+			connection.on("error", (error) => {
+				this.debug(`[Player] Voice connection error:`, error);
+				this.emit("connectionError", error);
+			});
+			connection.subscribe(this.audioPlayer);
+
+			this.clearLeaveTimeout();
+			return this.connection;
+		} catch (error) {
+			this.debug(`[Player] Connection error:`, error);
+			this.emit("connectionError", error as Error);
+			this.connection?.destroy();
+			throw error;
+		}
+	}
+
+	/**
+	 * Pause the current track
+	 *
+	 * @returns {boolean} True if paused successfully
+	 * @example
+	 * const paused = player.pause();
+	 * console.log(`Paused: ${paused}`);
+	 */
+	pause(): boolean {
+		this.debug(`[Player] pause called`);
+		if (this.isPlaying && !this.isPaused) {
+			return this.audioPlayer.pause();
+		}
+		return false;
+	}
+
+	/**
+	 * Resume the current track
+	 *
+	 * @returns {boolean} True if resumed successfully
+	 * @example
+	 * const resumed = player.resume();
+	 * console.log(`Resumed: ${resumed}`);
+	 */
+	resume(): boolean {
+		this.debug(`[Player] resume called`);
+		if (this.isPaused) {
+			const result = this.audioPlayer.unpause();
+			if (result) {
+				const track = this.queue.currentTrack;
+				if (track) {
+					this.debug(`[Player] Player resumed on track: ${track.title}`);
+					this.emit("playerResume", track);
+				}
+			}
+			return result;
+		}
+		return false;
+	}
+
+	/**
+	 * Stop the current track
+	 *
+	 * @returns {boolean} True if stopped successfully
+	 * @example
+	 * const stopped = player.stop();
+	 * console.log(`Stopped: ${stopped}`);
+	 */
+	stop(): boolean {
+		this.debug(`[Player] stop called`);
+		this.queue.clear();
+		const result = this.audioPlayer.stop();
+		this.destroyCurrentStream();
+		this.currentResource = null;
+
+		this.isPlaying = false;
+		this.isPaused = false;
+		this.emit("playerStop");
+		return result;
+	}
+
+	/**
+	 * Seek to a specific position in the current track
+	 *
+	 * @param {number} position - Position in milliseconds to seek to
+	 * @returns {Promise<boolean>} True if seek was successful
+	 * @example
+	 * // Seek to 30 seconds (30000ms)
+	 * const success = await player.seek(30000);
+	 * console.log(`Seek successful: ${success}`);
+	 *
+	 * // Seek to 1 minute 30 seconds (90000ms)
+	 * await player.seek(90000);
+	 */
+	async seek(position: number): Promise<boolean> {
+		this.debug(`[Player] seek called with position: ${position}ms`);
+
+		const track = this.queue.currentTrack;
+		if (!track) {
+			this.debug(`[Player] No current track to seek`);
+			return false;
+		}
+
+		const totalDuration = track.duration > 1000 ? track.duration : track.duration * 1000;
+		if (position < 0 || position > totalDuration) {
+			this.debug(`[Player] Invalid seek position: ${position}ms (track duration: ${totalDuration}ms)`);
+			return false;
+		}
+
+		const streaminfo = await this.getStream(track);
+		if (!streaminfo?.stream) {
+			this.debug(`[Player] No stream to seek`);
+			return false;
+		}
+
+		await this.refeshPlayerResource(true, position);
+
+		return true;
+	}
+
+	/**
+	 * Skip to the next track or skip to a specific index
+	 *
+	 * @param {number} index - Optional index to skip to (0 = next track)
+	 * @returns {boolean} True if skipped successfully
+	 * @example
+	 * const skipped = player.skip(); // Skip to next track
+	 * const skippedToIndex = player.skip(2); // Skip to track at index 2
+	 * console.log(`Skipped: ${skipped}`);
+	 */
+	skip(index?: number): boolean {
+		this.debug(`[Player] skip called with index: ${index}`);
+		try {
+			if (typeof index === "number" && index >= 0) {
+				// Skip to specific index
+				const targetTrack = this.queue.getTrack(index);
+				if (!targetTrack) {
+					this.debug(`[Player] No track found at index ${index}`);
+					return false;
+				}
+
+				// Remove tracks from 0 to index-1
+				for (let i = 0; i < index; i++) {
+					this.queue.remove(0);
+				}
+
+				this.debug(`[Player] Skipped to track at index ${index}: ${targetTrack.title}`);
+				if (this.isPlaying || this.isPaused) {
+					this.skipLoop = true;
+					return this.audioPlayer.stop();
+				}
+				return true;
+			}
+
+			if (this.isPlaying || this.isPaused) {
+				this.skipLoop = true;
+				return this.audioPlayer.stop();
+			}
+
+			return true;
+		} catch (error) {
+			this.debug(`[Player] skip error:`, error);
+			return false;
+		}
+	}
+
+	/**
+	 * Go back to the previous track in history and play it.
+	 *
+	 * @returns {Promise<boolean>} True if previous track was played successfully
+	 * @example
+	 * const previous = await player.previous();
+	 * console.log(`Previous: ${previous}`);
+	 */
+	async previous(): Promise<boolean> {
+		this.debug(`[Player] previous called`);
+		const track = this.queue.previous();
+		if (!track) return false;
+		if (this.queue.currentTrack) this.insert(this.queue.currentTrack, 0);
+		this.clearLeaveTimeout();
+		return this.startTrack(track);
+	}
+
+	/**
+	 * Save a track's stream to a file and return a Readable stream
+	 *
+	 * @param {Track} track - The track to save
+	 * @param {SaveOptions | string} options - Save options or filename string (for backward compatibility)
+	 * @returns {Promise<Readable>} A Readable stream containing the audio data
+	 * @example
+	 * // Save current track to file
+	 * const track = player.currentTrack;
+	 * if (track) {
+	 *   const stream = await player.save(track);
+	 *
+	 *   // Use fs to write the stream to file
+	 *   const fs = require('fs');
+	 *   const writeStream = fs.createWriteStream('saved-song.mp3');
+	 *   stream.pipe(writeStream);
+	 *
+	 *   writeStream.on('finish', () => {
+	 *     console.log('File saved successfully!');
+	 *   });
+	 * }
+	 *
+	 * // Save any track by URL
+	 * const searchResult = await player.search("Never Gonna Give You Up", userId);
+	 * if (searchResult.tracks.length > 0) {
+	 *   const stream = await player.save(searchResult.tracks[0]);
+	 *   // Handle the stream...
+	 * }
+	 *
+	 * // Backward compatibility - filename as string
+	 * const stream = await player.save(track, "my-song.mp3");
+	 */
+	async save(track: Track, options?: SaveOptions | string): Promise<Readable> {
+		this.debug(`[Player] save called for track: ${track.title}`);
+
+		// Parse options - support both SaveOptions object and filename string (backward compatibility)
+		let saveOptions: SaveOptions = {};
+		if (typeof options === "string") {
+			saveOptions = { filename: options };
+		} else if (options) {
+			saveOptions = options;
+		}
+
+		try {
+			// Try extensions first
+			let streamInfo: StreamInfo | null = await this.pluginManager.getStream(track);
+
+			if (!streamInfo || !streamInfo.stream) {
+				throw new Error(`No save stream available for track: ${track.title}`);
+			}
+
+			this.debug(`[Player] Save stream obtained for track: ${track.title}`);
+			if (saveOptions.filename) {
+				this.debug(`[Player] Save options - filename: ${saveOptions.filename}, quality: ${saveOptions.quality || "default"}`);
+			}
+
+			// Apply filters if any are active
+			let finalStream = streamInfo.stream;
+
+			if (saveOptions.filter || saveOptions.seek) {
+				try {
+					this.filter.clearAll();
+					this.filter.applyFilters(saveOptions.filter || []);
+				} catch (err) {
+					this.debug(`[Player] Error applying save filters:`, err);
+				}
+
+				this.debug(`[Player] Applying filters to save stream: ${this.filter.getFilterString() || "none"}`);
+				finalStream = await this.filter.applyFiltersAndSeek(streamInfo.stream, saveOptions.seek || 0).catch((err) => {
+					this.debug(`[Player] Error applying filters to save stream:`, err);
+					return streamInfo!.stream; // Fallback to original stream
+				});
+			}
+
+			// Return the stream directly - caller can pipe it to fs.createWriteStream()
+			return finalStream;
+		} catch (error) {
+			this.debug(`[Player] save error:`, error);
+			this.emit("playerError", error as Error, track);
+			throw error;
+		}
+	}
+
+	/**
+	 * Loop the current track or queue
+	 *
+	 * @param {LoopMode | number} mode - The loop mode to set ("off", "track", "queue") or number (0=off, 1=track, 2=queue)
+	 * @returns {LoopMode} The loop mode
+	 * @example
+	 * const loopMode = player.loop("track"); // Loop current track
+	 * const loopQueue = player.loop("queue"); // Loop entire queue
+	 * const loopTrack = player.loop(1); // Loop current track (same as "track")
+	 * const loopQueueNum = player.loop(2); // Loop entire queue (same as "queue")
+	 * const noLoop = player.loop("off"); // No loop
+	 * const noLoopNum = player.loop(0); // No loop (same as "off")
+	 * console.log(`Loop mode: ${loopMode}`);
+	 */
+	loop(mode?: LoopMode | number): LoopMode {
+		this.debug(`[Player] loop called with mode: ${mode}`);
+
+		if (typeof mode === "number") {
+			// Number mode: convert to text mode
+			switch (mode) {
+				case 0:
+					return this.queue.loop("off");
+				case 1:
+					return this.queue.loop("track");
+				case 2:
+					return this.queue.loop("queue");
+				default:
+					this.debug(`[Player] Invalid loop number: ${mode}, using "off"`);
+					return this.queue.loop("off");
+			}
+		}
+
+		return this.queue.loop(mode as LoopMode);
+	}
+
+	/**
+	 * Set the auto-play mode
+	 *
+	 * @param {boolean} mode - The auto-play mode to set
+	 * @returns {boolean} The auto-play mode
+	 * @example
+	 * const autoPlayMode = player.autoPlay(true);
+	 * console.log(`Auto-play mode: ${autoPlayMode}`);
+	 */
+	autoPlay(mode?: boolean): boolean {
+		return this.queue.autoPlay(mode);
+	}
+
+	/**
+	 * Set the volume of the current track
+	 *
+	 * @param {number} volume - The volume to set
+	 * @returns {boolean} True if volume was set successfully
+	 * @example
+	 * const volumeSet = player.setVolume(50);
+	 * console.log(`Volume set: ${volumeSet}`);
+	 */
+	setVolume(volume: number): boolean {
+		this.debug(`[Player] setVolume called: ${volume}`);
+		if (volume < 0 || volume > 200) return false;
+
+		const oldVolume = this.volume;
+		this.volume = volume;
+		const resourceVolume = this.currentResource?.volume;
+
+		if (resourceVolume) {
+			if (this.volumeInterval) clearInterval(this.volumeInterval);
+
+			const start = resourceVolume.volume;
+			const target = this.volume / 100;
+			const steps = 10;
+			let currentStep = 0;
+
+			this.volumeInterval = setInterval(() => {
+				currentStep++;
+				const value = start + ((target - start) * currentStep) / steps;
+				resourceVolume.setVolume(value);
+				if (currentStep >= steps) {
+					clearInterval(this.volumeInterval!);
+					this.volumeInterval = null;
+				}
+			}, 300);
+		}
+
+		this.emit("volumeChange", oldVolume, volume);
+		return true;
+	}
+
+	/**
+	 * Shuffle the queue
+	 *
+	 * @returns {void}
+	 * @example
+	 * player.shuffle();
+	 */
+	shuffle(): void {
+		this.debug(`[Player] shuffle called`);
+		this.queue.shuffle();
+	}
+
+	/**
+	 * Clear the queue
+	 *
+	 * @returns {void}
+	 * @example
+	 * player.clearQueue();
+	 */
+	clearQueue(): void {
+		this.debug(`[Player] clearQueue called`);
+		this.queue.clear();
+	}
+
+	/**
+	 * Insert a track or list of tracks into the upcoming queue at a specific position (0 = play after current).
+	 * - If `query` is a string, performs a search and inserts resulting tracks (playlist supported).
+	 * - If a Track or Track[] is provided, inserts directly.
+	 * Does not auto-start playback; it only modifies the queue.
+	 *
+	 * @param {string | Track | Track[]} query - The track or tracks to insert
+	 * @param {number} index - The index to insert the tracks at
+	 * @param {string} requestedBy - The user ID who requested the insert
+	 * @returns {Promise<boolean>} True if the tracks were inserted successfully
+	 * @example
+	 * const inserted = await player.insert("Song Name", 0, userId);
+	 * console.log(`Inserted: ${inserted}`);
+	 */
+	async insert(query: string | Track | Track[], index: number, requestedBy?: string): Promise<boolean> {
+		try {
+			this.debug(`[Player] insert called at index ${index} with type: ${typeof query}`);
+			let tracksToAdd: Track[] = [];
+			let isPlaylist = false;
+
+			if (typeof query === "string") {
+				const searchResult = await this.search(query, requestedBy || "Unknown");
+				tracksToAdd = searchResult.tracks || [];
+				isPlaylist = !!searchResult.playlist;
+			} else if (Array.isArray(query)) {
+				tracksToAdd = query;
+				isPlaylist = query.length > 1;
+			} else if (query) {
+				tracksToAdd = [query];
+			}
+
+			if (!tracksToAdd || tracksToAdd.length === 0) {
+				this.debug(`[Player] insert: no tracks resolved`);
+				throw new Error("No tracks to insert");
+			}
+
+			if (tracksToAdd.length === 1) {
+				this.queue.insert(tracksToAdd[0], index);
+				this.emit("queueAdd", tracksToAdd[0]);
+				this.debug(`[Player] Inserted track at index ${index}: ${tracksToAdd[0].title}`);
+			} else {
+				this.queue.insertMultiple(tracksToAdd, index);
+				this.emit("queueAddList", tracksToAdd);
+				this.debug(`[Player] Inserted ${tracksToAdd.length} ${isPlaylist ? "playlist " : ""}tracks at index ${index}`);
+			}
+
+			return true;
+		} catch (error) {
+			this.debug(`[Player] insert error:`, error);
+			this.emit("playerError", error as Error);
+			return false;
+		}
+	}
+
+	/**
+	 * Remove a track from the queue
+	 *
+	 * @param {number} index - The index of the track to remove
+	 * @returns {Track | null} The removed track or null
+	 * @example
+	 * const removed = player.remove(0);
+	 * console.log(`Removed: ${removed?.title}`);
+	 */
+	remove(index: number): Track | null {
+		this.debug(`[Player] remove called for index: ${index}`);
+		const track = this.queue.remove(index);
+		if (track) {
+			this.emit("queueRemove", track, index);
+		}
+		return track;
+	}
+
+	/**
+	 * Get the progress bar of the current track
+	 *
+	 * @param {ProgressBarOptions} options - The options for the progress bar
+	 * @returns {string} The progress bar
+	 * @example
+	 * const progressBar = player.getProgressBar();
+	 * console.log(`Progress bar: ${progressBar}`);
+	 */
+	getProgressBar(options: ProgressBarOptions = {}): string {
+		const { size = 20, barChar = "▬", progressChar = "🔘" } = options;
+		const track = this.queue.currentTrack;
+		const resource = this.currentResource;
+		if (!track || !resource) return "";
+
+		const total = track.duration > 1000 ? track.duration : track.duration * 1000;
+		if (!total) return this.formatTime(resource.playbackDuration);
+
+		const current = resource.playbackDuration;
+		const ratio = Math.min(current / total, 1);
+		const progress = Math.round(ratio * size);
+		const bar = barChar.repeat(progress) + progressChar + barChar.repeat(size - progress);
+
+		return `${this.formatTime(current)} | ${bar} | ${this.formatTime(total)}`;
+	}
+
+	/**
+	 * Get the time of the current track
+	 *
+	 * @returns {Object} The time of the current track
+	 * @example
+	 * const time = player.getTime();
+	 * console.log(`Time: ${time.current}`);
+	 */
+	getTime() {
+		const resource = this.currentResource;
+		const track = this.queue.currentTrack;
+		if (!track || !resource)
+			return {
+				current: 0,
+				total: 0,
+				format: "00:00",
+			};
+
+		const total = track.duration > 1000 ? track.duration : track.duration * 1000;
+
+		return {
+			current: resource?.playbackDuration,
+			total: total,
+			format: this.formatTime(resource.playbackDuration),
+		};
+	}
+
+	/**
+	 * Format the time in the format of HH:MM:SS
+	 *
+	 * @param {number} ms - The time in milliseconds
+	 * @returns {string} The formatted time
+	 * @example
+	 * const formattedTime = player.formatTime(1000);
+	 * console.log(`Formatted time: ${formattedTime}`);
+	 */
+	formatTime(ms: number): string {
+		const totalSeconds = Math.floor(ms / 1000);
+		const hours = Math.floor(totalSeconds / 3600);
+		const minutes = Math.floor((totalSeconds % 3600) / 60);
+		const seconds = totalSeconds % 60;
+		const parts: string[] = [];
+		if (hours > 0) parts.push(String(hours).padStart(2, "0"));
+		parts.push(String(minutes).padStart(2, "0"));
+		parts.push(String(seconds).padStart(2, "0"));
+		return parts.join(":");
+	}
+
+	/**
+	 * Destroy the player
+	 *
+	 * @returns {void}
+	 * @example
+	 * player.destroy();
+	 */
+	destroy(): void {
+		this.debug(`[Player] destroy called`);
+		if (this.leaveTimeout) {
+			clearTimeout(this.leaveTimeout);
+			this.leaveTimeout = null;
+		}
+
+		// Destroy current stream before stopping audio
+		this.destroyCurrentStream();
+
+		this.audioPlayer.removeAllListeners();
+		this.audioPlayer.stop(true);
+
+		if (this.ttsPlayer) {
+			try {
+				this.ttsPlayer.stop(true);
+			} catch {}
+			this.ttsPlayer = null;
+		}
+
+		if (this.connection) {
+			this.connection.destroy();
+			this.connection = null;
+		}
+
+		this.queue.clear();
+		this.pluginManager.clear();
+		this.filter.destroy();
+		this.extensionManager.destroy();
+		this.isPlaying = false;
+		this.isPaused = false;
+
+		// Clear any remaining intervals
+		if (this.volumeInterval) {
+			clearInterval(this.volumeInterval);
+			this.volumeInterval = null;
+		}
+
+		this.emit("playerDestroy");
+		this.removeAllListeners();
+	}
+
+	//#endregion
+	//#region utils
+	private scheduleLeave(): void {
+		this.debug(`[Player] scheduleLeave called`);
+		if (this.leaveTimeout) {
+			clearTimeout(this.leaveTimeout);
+		}
+
+		if (this.options.leaveOnEmpty && this.options.leaveTimeout) {
+			this.leaveTimeout = setTimeout(() => {
+				this.debug(`[Player] Leaving voice channel after timeoutMs`);
+				this.destroy();
+			}, this.options.leaveTimeout);
+		}
+	}
+
+	/**
+	 * Refesh player resource (apply filter)
+	 *
+	 * @param {boolean} applyToCurrent - Apply filter for curent track
+	 * @param {number} position - Position to seek to in milliseconds
+	 * @returns {Promise<boolean>}
+	 * @example
+	 * const refreshed = await player.refeshPlayerResource(true, 1000);
+	 * console.log(`Refreshed: ${refreshed}`);
+	 */
+	public async refeshPlayerResource(applyToCurrent: boolean = true, position: number = -1): Promise<boolean> {
+		if (!applyToCurrent || !this.queue.currentTrack || !(this.isPlaying || this.isPaused)) {
+			return false;
+		}
+
+		try {
+			const track = this.queue.currentTrack;
+			this.debug(`[Player] Refreshing player resource for track: ${track.title}`);
+
+			// Get current position for seeking
+			const currentPosition = position > 0 ? position : this.currentResource?.playbackDuration || 0;
+
+			const streaminfo = await this.getStream(track);
+			if (!streaminfo?.stream) {
+				this.debug(`[Player] No stream to refresh`);
+				return false;
+			}
+
+			// Create AudioResource with filters and seek to current position
+			const resource = await this.createResource(streaminfo, track, currentPosition);
+
+			// Stop current playback and destroy old resource/stream
+			const wasPlaying = this.isPlaying;
+			const wasPaused = this.isPaused;
+
+			this.audioPlayer.stop();
+
+			// Properly destroy the old resource and stream
+			try {
+				if (this.currentResource) {
+					const oldStream = (this.currentResource as any)._readableState?.stream || (this.currentResource as any).stream;
+					if (oldStream && typeof oldStream.destroy === "function") {
+						oldStream.destroy();
+					}
+				}
+			} catch (error) {
+				this.debug(`[Player] Error destroying old stream in refeshPlayerResource:`, error);
+			}
+
+			this.currentResource = resource;
+
+			// Subscribe to new resource
+			if (this.connection) {
+				this.connection.subscribe(this.audioPlayer);
+				this.audioPlayer.play(resource);
+			}
+
+			// Restore playing state
+			if (wasPlaying && !wasPaused) {
+				this.isPlaying = true;
+				this.isPaused = false;
+			} else if (wasPaused) {
+				this.isPlaying = false;
+				this.isPaused = true;
+				this.audioPlayer.pause();
+			}
+
+			this.debug(`[Player] Successfully applied filter to current track at position ${currentPosition}ms`);
+			return true;
+		} catch (error) {
+			this.debug(`[Player] Error applying filter to current track:`, error);
+			// Filter was still added to active filters, so return true
+			return true;
+		}
+	}
+
+	/**
+	 * Attach an extension to the player
+	 *
+	 * @param {BaseExtension} extension - The extension to attach
+	 * @example
+	 * player.attachExtension(new MyExtension());
+	 */
+	public attachExtension(extension: BaseExtension): void {
+		this.extensionManager.register(extension);
+	}
+
+	/**
+	 * Detach an extension from the player
+	 *
+	 * @param {BaseExtension} extension - The extension to detach
+	 * @example
+	 * player.detachExtension(new MyExtension());
+	 */
+	public detachExtension(extension: BaseExtension): void {
+		this.extensionManager.unregister(extension);
+	}
+
+	/**
+	 * Get all extensions attached to the player
+	 *
+	 * @returns {readonly BaseExtension[]} All attached extensions
+	 * @example
+	 * const extensions = player.getExtensions();
+	 * console.log(`Extensions: ${extensions.length}`);
+	 */
+	public getExtensions(): readonly BaseExtension[] {
+		return this.extensionManager.getAll();
+	}
+
+	private clearLeaveTimeout(): void {
+		if (this.leaveTimeout) {
+			clearTimeout(this.leaveTimeout);
+			this.leaveTimeout = null;
+			this.debug(`[Player] Cleared leave timeoutMs`);
+		}
+	}
+
+	private debug(message?: any, ...optionalParams: any[]): void {
+		if (this.listenerCount("debug") > 0) {
+			this.emit("debug", message, ...optionalParams);
+		}
+	}
+
+	private setupEventListeners(): void {
+		this.audioPlayer.on("stateChange", (oldState, newState) => {
+			this.debug(`[Player] AudioPlayer stateChange from ${oldState.status} to ${newState.status}`);
+			if (newState.status === AudioPlayerStatus.Idle && oldState.status !== AudioPlayerStatus.Idle) {
+				// Track ended
+				const track = this.queue.currentTrack;
+				if (track) {
+					this.debug(`[Player] Track ended: ${track.title}`);
+					this.emit("trackEnd", track);
+				}
+				this.playNext();
+			} else if (
+				newState.status === AudioPlayerStatus.Playing &&
+				(oldState.status === AudioPlayerStatus.Idle || oldState.status === AudioPlayerStatus.Buffering)
+			) {
+				// Track started
+				this.clearLeaveTimeout();
+				this.isPlaying = true;
+				this.isPaused = false;
+				const track = this.queue.currentTrack;
+				if (track) {
+					this.debug(`[Player] Track started: ${track.title}`);
+					this.emit("trackStart", track);
+				}
+			} else if (newState.status === AudioPlayerStatus.Paused && oldState.status !== AudioPlayerStatus.Paused) {
+				// Track paused
+				this.isPaused = true;
+				const track = this.queue.currentTrack;
+				if (track) {
+					this.debug(`[Player] Player paused on track: ${track.title}`);
+					this.emit("playerPause", track);
+				}
+			} else if (newState.status !== AudioPlayerStatus.Paused && oldState.status === AudioPlayerStatus.Paused) {
+				// Track resumed
+				this.isPaused = false;
+				const track = this.queue.currentTrack;
+				if (track) {
+					this.debug(`[Player] Player resumed on track: ${track.title}`);
+					this.emit("playerResume", track);
+				}
+			} else if (newState.status === AudioPlayerStatus.AutoPaused) {
+				this.debug(`[Player] AudioPlayerStatus.AutoPaused`);
+			} else if (newState.status === AudioPlayerStatus.Buffering) {
+				this.debug(`[Player] AudioPlayerStatus.Buffering`);
+			}
+		});
+		this.audioPlayer.on("error", (error) => {
+			this.debug(`[Player] AudioPlayer error:`, error);
+			this.emit("playerError", error, this.queue.currentTrack || undefined);
+			this.playNext();
+		});
+
+		this.audioPlayer.on("debug", (...args) => {
+			if (this.manager.debugEnabled) {
+				this.emit("debug", ...args);
+			}
+		});
+	}
+
+	addPlugin(plugin: SourcePlugin): void {
+		this.debug(`[Player] Adding plugin: ${plugin.name}`);
+		this.pluginManager.register(plugin);
+	}
+
+	removePlugin(name: string): boolean {
+		this.debug(`[Player] Removing plugin: ${name}`);
+		return this.pluginManager.unregister(name);
+	}
+
+	//#endregion
+	//#region Getters
+
+	/**
+	 * Get the size of the queue
+	 *
+	 * @returns {number} The size of the queue
+	 * @example
+	 * const queueSize = player.queueSize;
+	 * console.log(`Queue size: ${queueSize}`);
+	 */
+	get queueSize(): number {
+		return this.queue.size;
+	}
+
+	/**
+	 * Get the current track
+	 *
+	 * @returns {Track | null} The current track or null
+	 * @example
+	 * const currentTrack = player.currentTrack;
+	 * console.log(`Current track: ${currentTrack?.title}`);
+	 */
+	get currentTrack(): Track | null {
+		return this.queue.currentTrack;
+	}
+
+	/**
+	 * Get the previous track
+	 *
+	 * @returns {Track | null} The previous track or null
+	 * @example
+	 * const previousTrack = player.previousTrack;
+	 * console.log(`Previous track: ${previousTrack?.title}`);
+	 */
+	get previousTrack(): Track | null {
+		return this.queue.previousTracks?.at(-1) ?? null;
+	}
+
+	/**
+	 * Get the upcoming tracks
+	 *
+	 * @returns {Track[]} The upcoming tracks
+	 * @example
+	 * const upcomingTracks = player.upcomingTracks;
+	 * console.log(`Upcoming tracks: ${upcomingTracks.length}`);
+	 */
+	get upcomingTracks(): Track[] {
+		return this.queue.getTracks();
+	}
+
+	/**
+	 * Get the previous tracks
+	 *
+	 * @returns {Track[]} The previous tracks
+	 * @example
+	 * const previousTracks = player.previousTracks;
+	 * console.log(`Previous tracks: ${previousTracks.length}`);
+	 */
+	get previousTracks(): Track[] {
+		return this.queue.previousTracks;
+	}
+
+	/**
+	 * Get the available plugins
+	 *
+	 * @returns {string[]} The available plugins
+	 * @example
+	 * const availablePlugins = player.availablePlugins;
+	 * console.log(`Available plugins: ${availablePlugins.length}`);
+	 */
+	get availablePlugins(): string[] {
+		return this.pluginManager.getAll().map((p) => p.name);
+	}
+
+	/**
+	 * Get the related tracks
+	 *
+	 * @returns {Track[] | null} The related tracks or null
+	 * @example
+	 * const relatedTracks = player.relatedTracks;
+	 * console.log(`Related tracks: ${relatedTracks?.length}`);
+	 */
+	get relatedTracks(): Track[] | null {
+		return this.queue.relatedTracks();
+	}
+
+	//#endregion
+}