hoshimi 0.3.3 → 0.3.6

package/dist/index.js

@@ -21,45 +21,56 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AudioOutput: () => AudioOutput,
+  AudioOutputData: () => AudioOutputData,
   DSPXPluginFilter: () => DSPXPluginFilter,
   DebugLevels: () => DebugLevels,
+  DefaultFilterPreset: () => DefaultFilterPreset,
+  DefaultPlayerFilters: () => DefaultPlayerFilters,
   DestroyReasons: () => DestroyReasons,
-  Events: () => Events,
+  EventNames: () => EventNames,
   FilterManager: () => FilterManager,
   FilterType: () => FilterType,
   Hoshimi: () => Hoshimi,
+  HoshimiAgent: () => HoshimiAgent,
   HttpMethods: () => HttpMethods,
   HttpStatusCodes: () => HttpStatusCodes,
   LavalinkPluginFilter: () => LavalinkPluginFilter,
   LoadType: () => LoadType,
   LoopMode: () => LoopMode,
   ManagerError: () => ManagerError,
-  MemoryAdapter: () => MemoryAdapter,
   Node: () => Node,
   NodeDestroyReasons: () => NodeDestroyReasons,
   NodeError: () => NodeError,
+  NodeManagerError: () => NodeManagerError,
   NodeSortTypes: () => NodeSortTypes,
   OpCodes: () => OpCodes,
   OptionError: () => OptionError,
   Player: () => Player,
   PlayerError: () => PlayerError,
   PlayerEventType: () => PlayerEventType,
+  PlayerMemoryStorage: () => PlayerMemoryStorage,
+  PlayerStorageAdapter: () => PlayerStorageAdapter,
   PluginInfoType: () => PluginInfoType,
   PluginNames: () => PluginNames,
   Queue: () => Queue,
+  QueueMemoryStorage: () => QueueMemoryStorage,
+  QueueStorageAdapter: () => QueueStorageAdapter,
   ResolveError: () => ResolveError,
   Rest: () => Rest,
   RestPathType: () => RestPathType,
+  RestRoutes: () => RestRoutes,
   SearchEngines: () => SearchEngines,
   Severity: () => Severity,
   SourceNames: () => SourceNames,
   State: () => State,
-  StorageAdapter: () => StorageAdapter,
   StorageError: () => StorageError,
   Structures: () => Structures,
   Track: () => Track,
   TrackEndReason: () => TrackEndReason,
   UnresolvedTrack: () => UnresolvedTrack,
+  UrlRegex: () => UrlRegex,
+  ValidEngines: () => ValidEngines,
+  ValidSources: () => ValidSources,
   WebsocketCloseCodes: () => WebsocketCloseCodes,
   createHoshimi: () => createHoshimi
 });
@@ -96,6 +107,12 @@ var StorageError = class extends Error {
     this.name = "Hoshimi [StorageError]";
   }
 };
+var NodeManagerError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "Hoshimi [NodeManagerError]";
+  }
+};
 var ResolveError = class extends Error {
   constructor(message) {
     super(message);
@@ -140,6 +157,7 @@ var SearchEngines = /* @__PURE__ */ ((SearchEngines2) => {
   SearchEngines2["Local"] = "local";
   SearchEngines2["PornHub"] = "phsearch";
   SearchEngines2["TextToSpeech"] = "speak";
+  SearchEngines2["HTTP"] = "http";
   return SearchEngines2;
 })(SearchEngines || {});
 var DebugLevels = /* @__PURE__ */ ((DebugLevels2) => {
@@ -151,32 +169,33 @@ var DebugLevels = /* @__PURE__ */ ((DebugLevels2) => {
   DebugLevels2[DebugLevels2["Test"] = 6] = "Test";
   return DebugLevels2;
 })(DebugLevels || {});
-var Events = /* @__PURE__ */ ((Events2) => {
-  Events2["Debug"] = "debug";
-  Events2["Error"] = "error";
-  Events2["NodeRaw"] = "nodeRaw";
-  Events2["NodeError"] = "nodeError";
-  Events2["NodeReady"] = "nodeReady";
-  Events2["NodeDisconnect"] = "nodeDisconnect";
-  Events2["NodeReconnecting"] = "nodeReconnecting";
-  Events2["NodeDestroy"] = "nodeDestroy";
-  Events2["NodeResumed"] = "nodeResumed";
-  Events2["NodeCreate"] = "nodeCreate";
-  Events2["PlayerCreate"] = "playerCreate";
-  Events2["PlayerUpdate"] = "playerUpdate";
-  Events2["PlayerDestroy"] = "playerDestroy";
-  Events2["TrackStart"] = "trackStart";
-  Events2["TrackEnd"] = "trackEnd";
-  Events2["TrackStuck"] = "trackStuck";
-  Events2["TrackError"] = "trackError";
-  Events2["LyricsFound"] = "lyricsFound";
-  Events2["LyricsNotFound"] = "lyricsNotFound";
-  Events2["LyricsLine"] = "lyricsLine";
-  Events2["QueueEnd"] = "queueEnd";
-  Events2["QueueUpdate"] = "queueUpdate";
-  Events2["WebSocketClosed"] = "socketClosed";
-  return Events2;
-})(Events || {});
+var EventNames = /* @__PURE__ */ ((EventNames2) => {
+  EventNames2["Debug"] = "debug";
+  EventNames2["Error"] = "error";
+  EventNames2["NodeRaw"] = "nodeRaw";
+  EventNames2["NodeError"] = "nodeError";
+  EventNames2["NodeReady"] = "nodeReady";
+  EventNames2["NodeDisconnect"] = "nodeDisconnect";
+  EventNames2["NodeReconnecting"] = "nodeReconnecting";
+  EventNames2["NodeDestroy"] = "nodeDestroy";
+  EventNames2["NodeResumed"] = "nodeResumed";
+  EventNames2["NodeCreate"] = "nodeCreate";
+  EventNames2["PlayerCreate"] = "playerCreate";
+  EventNames2["PlayerUpdate"] = "playerUpdate";
+  EventNames2["PlayerDestroy"] = "playerDestroy";
+  EventNames2["PlayerError"] = "playerError";
+  EventNames2["TrackStart"] = "trackStart";
+  EventNames2["TrackEnd"] = "trackEnd";
+  EventNames2["TrackStuck"] = "trackStuck";
+  EventNames2["TrackError"] = "trackError";
+  EventNames2["LyricsFound"] = "lyricsFound";
+  EventNames2["LyricsNotFound"] = "lyricsNotFound";
+  EventNames2["LyricsLine"] = "lyricsLine";
+  EventNames2["QueueEnd"] = "queueEnd";
+  EventNames2["QueueUpdate"] = "queueUpdate";
+  EventNames2["WebSocketClosed"] = "socketClosed";
+  return EventNames2;
+})(EventNames || {});
 var DestroyReasons = /* @__PURE__ */ ((DestroyReasons2) => {
   DestroyReasons2["Stop"] = "Player-Stop";
   DestroyReasons2["Requested"] = "Player-Requested";
@@ -184,6 +203,8 @@ var DestroyReasons = /* @__PURE__ */ ((DestroyReasons2) => {
   DestroyReasons2["NodeDisconnected"] = "Player-NodeDisconnected";
   DestroyReasons2["NodeDestroy"] = "Player-NodeDestroy";
   DestroyReasons2["VoiceChannelDeleted"] = "Player-VoiceChannelDeleted";
+  DestroyReasons2["VoiceChannelLeft"] = "Player-VoiceChannelLeft";
+  DestroyReasons2["ReconnectFailed"] = "Player-ReconnectFailed";
   return DestroyReasons2;
 })(DestroyReasons || {});
 
@@ -346,9 +367,120 @@ var HttpStatusCodes = /* @__PURE__ */ ((HttpStatusCodes2) => {
   HttpStatusCodes2[HttpStatusCodes2["GatewayTimeout"] = 504] = "GatewayTimeout";
   return HttpStatusCodes2;
 })(HttpStatusCodes || {});
+var RestRoutes = {
+  /**
+   *
+   * Get the updated player endpoint.
+   * @param {string} sessionId The session id of the node.
+   * @param {string} guildId The guild id of the player.
+   * @returns {RestEndpoint} The endpoint for updating the player.
+   */
+  UpdatePlayer(sessionId, guildId) {
+    return `/sessions/${sessionId}/players/${guildId}`;
+  },
+  /**
+   *
+   * Get the update session endpoint.
+   * @param {string} sessionId The session id of the node.
+   * @returns {RestEndpoint} The endpoint for updating the session.
+   */
+  UpdateSession(sessionId) {
+    return `/sessions/${sessionId}`;
+  },
+  /**
+   *
+   * Get the get players endpoint.
+   * @param {string} sessionId The session id of the node.
+   * @returns {RestEndpoint} The endpoint for getting the players.
+   */
+  GetPlayers(sessionId) {
+    return `/sessions/${sessionId}/players`;
+  },
+  /**
+   *
+   * Get the current lyrics endpoint.
+   * @param {string} sessionId The session id of the node.
+   * @param {string} guildId The guild id of the player.
+   * @returns {RestEndpoint} The endpoint for getting the current lyrics.
+   */
+  CurrentLyrics(sessionId, guildId) {
+    return `/sessions/${sessionId}/players/${guildId}/track/lyrics`;
+  },
+  /**
+   *
+   * Subscribe to lyrics endpoint.
+   * @param {string} sessionId The session id of the node.
+   * @param {string} guildId The guild id of the player.
+   * @returns {RestEndpoint} The endpoint for subscribing to lyrics.
+   */
+  SubscribeLyrics(sessionId, guildId) {
+    return `/sessions/${sessionId}/players/${guildId}/lyrics/subscribe`;
+  },
+  /**
+   * Get the lyrics endpoint.
+   * @type {RestEndpoint}
+   */
+  GetLyrics: "/lyrics",
+  /**
+   * Get the decode track endpoint.
+   * @type {RestEndpoint}
+   */
+  DecodeTrack: "/decodetrack",
+  /**
+   * Get the decode tracks endpoint.
+   * @type {RestEndpoint}
+   */
+  DecodeTracks: "/decodetracks",
+  /**
+   * Get the load tracks endpoint.
+   * @type {RestEndpoint}
+   */
+  LoadTracks: "/loadtracks",
+  /**
+   * Get the node info endpoint.
+   * @type {RestEndpoint}
+   */
+  NodeInfo: "/info",
+  /**
+   * Get the load lyrics endpoint.
+   * @type {RestEndpoint}
+   * @description Used in NodelinkLyricsManager, only for nodelink nodes.
+   */
+  LoadLyrics: "/loadlyrics",
+  /**
+   * Get the connection endpoint.
+   * @type {RestEndpoint}
+   * @description Used for checking the connection status of the node, only for nodelink nodes.
+   */
+  Connection: "/connection"
+};
+
+// src/classes/storage/adapters/PlayerAdapter.ts
+var PlayerStorageAdapter = class {
+  /**
+   * The namespace of the storage.
+   * @type {string}
+   * @default "hoshimiplayer"
+   * @example
+   * ```ts
+   * console.log(storage.namespace); // "hoshimiplayer"
+   * ```
+   */
+  namespace = "hoshimiplayer";
+};
 
-// src/classes/queue/adapters/adapter.ts
-var StorageAdapter = class {
+// src/classes/storage/adapters/QueueAdapter.ts
+var QueueStorageAdapter = class {
+  /**
+   * The namespace of the storage.
+   * @type {string}
+   * @default "hoshimiqueue"
+   * @example
+   * ```ts
+   * console.log(storage.namespace); // "hoshimiqueue"
+   * ```
+   */
+  namespace = "hoshimiqueue";
 };
 
 // src/classes/Track.ts
@@ -371,7 +503,7 @@ var Track = class {
   pluginInfo;
   /**
    * The track user data.
-   * @type {Record<string, unknown>}
+   * @type {TrackUserData}
    */
   userData;
   /**
@@ -441,7 +573,7 @@ var UnresolvedTrack = class {
   pluginInfo;
   /**
    * The track user data.
-   * @type {Record<string, unknown> | undefined}
+   * @type {TrackUserData | undefined}
    */
   userData;
   /**
@@ -469,7 +601,7 @@ var UnresolvedTrack = class {
   constructor(track, requester) {
     this.info = track.info;
     this.encoded = track.encoded;
-    this.requester = requester;
+    this.requester = requester ?? {};
     this.pluginInfo = track.pluginInfo;
     this.userData = track.userData ?? {};
   }
@@ -491,10 +623,14 @@ var UnresolvedTrack = class {
     if (this.info.uri) {
       const track = await player.search({ query: this.info.uri, requester: this.requester }).then((result) => result.tracks[0]);
       if (!track) throw new ResolveError("Track could not be resolved from URI.");
-      player.manager.emit("debug" /* Debug */, 3 /* Player */, `[Unresolved] -> [Track] Resolved the track from URI: ${this.info.uri}`);
+      player.manager.emit(
+        "debug" /* Debug */,
+        3 /* Player */,
+        `[Unresolved] -> [Track] Resolved the track from URI: ${this.info.uri}`
+      );
       return track;
     }
-    const query = [this.info.title, this.info.uri].filter(Boolean).join(" by ");
+    const query = [this.info.title, this.info.author].filter(Boolean).join(" by ");
     const excluded = ["twitch" /* Twitch */, "flowery-tts" /* FloweryTTS */, "mixer" /* Mixer */, "vimeo" /* Vimeo */];
     const engine = this.info.sourceName && !excluded.includes(this.info.sourceName) ? validateEngine(this.info.sourceName) : player.manager.options.defaultSearchEngine;
     player.manager.emit(
@@ -531,12 +667,20 @@ var UnresolvedTrack = class {
 // package.json
 var package_default = {
   name: "hoshimi",
-  version: "0.3.3",
+  version: "0.3.6",
   description: "A lavalink@v4 client easy to use, up-to-date and all ears.",
   main: "./dist/index.js",
   module: "./dist/index.mjs",
   types: "./dist/index.d.ts",
-  packageManager: "pnpm@10.25.0+sha512.5e82639027af37cf832061bcc6d639c219634488e0f2baebe785028a793de7b525ffcd3f7ff574f5e9860654e098fe852ba8ac5dd5cefe1767d23a020a92f501",
+  packageManager: "pnpm@10.29.3+sha512.498e1fb4cca5aa06c1dcf2611e6fafc50972ffe7189998c409e90de74566444298ffe43e6cd2acdc775ba1aa7cc5e092a8b7054c811ba8c5770f84693d33d2dc",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      require: "./dist/index.js",
+      import: "./dist/index.mjs",
+      default: "./dist/index.js"
+    }
+  },
   files: [
     "dist"
   ],
@@ -572,8 +716,8 @@ var package_default = {
   author: "Ganyu Studios",
   license: "MIT",
   devDependencies: {
-    "@biomejs/biome": "^2.3.8",
-    "@types/node": "^25.0.1",
+    "@biomejs/biome": "^2.3.15",
+    "@types/node": "^25.2.3",
     "@types/ws": "^8.18.1",
     husky: "^9.1.7",
     "lint-staged": "^16.2.7",
@@ -582,7 +726,7 @@ var package_default = {
     typescript: "^5.9.3"
   },
   dependencies: {
-    ws: "^8.18.3"
+    ws: "^8.19.0"
   },
   pnpm: {
     onlyBuiltDependencies: [
@@ -761,20 +905,53 @@ function validateManagerOptions(options) {
     throw new OptionError("The manager option 'options.nodes' must be a valid array of nodes and atleast one valid node.");
   if (typeof options.sendPayload !== "function")
     throw new OptionError("The manager option 'options.sendPayload' must be a vaid function.");
-  if (typeof options.queueOptions !== "undefined" && typeof options.queueOptions.maxPreviousTracks !== "number")
-    throw new OptionError("The manager option 'options.queueOptions.maxPreviousTracks' must be a number.");
-  if (typeof options.queueOptions !== "undefined" && typeof options.queueOptions.autoplayFn !== "function")
-    throw new OptionError("The manager option 'options.queueOptions.autoplayFn' must be a function.");
-  if (typeof options.queueOptions?.storage !== "undefined" && !(options.queueOptions.storage instanceof StorageAdapter))
-    throw new OptionError("The manager option 'options.queueOptions.storage' must be a valid storage manager.");
   if (typeof options.defaultSearchEngine !== "undefined" && !ValidEngines.includes(options.defaultSearchEngine))
     throw new OptionError("The manager option 'options.defaultSearchEngine' Must be a valid search engine.");
-  if (typeof options.client !== "undefined" && typeof options.client !== "object")
-    throw new OptionError("The manager option 'options.client' Must be a valid object.");
-  if (typeof options.client !== "undefined" && typeof options.client.id !== "undefined" && typeof options.client.id !== "string")
-    throw new OptionError("The manager option 'options.client.id' Must be a valid string.");
-  if (typeof options.client !== "undefined" && typeof options.client.id !== "undefined" && typeof options.client.username !== "string")
-    throw new OptionError("The manager option 'options.client.username' must be a valid string.");
+  if (typeof options.queueOptions !== "undefined") {
+    if (typeof options.queueOptions.maxHistory !== "number")
+      throw new OptionError("The manager option 'options.queueOptions.maxPreviousTracks' must be a number.");
+    if (typeof options.queueOptions.autoplayFn !== "function")
+      throw new OptionError("The manager option 'options.queueOptions.autoplayFn' must be a function.");
+    if (typeof options.queueOptions.storage !== "undefined" && !(options.queueOptions.storage instanceof QueueStorageAdapter))
+      throw new OptionError("The manager option 'options.queueOptions.storage' must be a valid storage manager.");
+    if (typeof options.queueOptions.autoPlay !== "undefined" && typeof options.queueOptions.autoPlay !== "boolean")
+      throw new OptionError("The manager option 'options.queueOptions.autoPlay' must be a boolean.");
+  }
+  if (typeof options.playerOptions !== "undefined") {
+    if (!(options.playerOptions.storage instanceof PlayerStorageAdapter))
+      throw new OptionError("The manager option 'options.playerOptions.storage' must be a valid storage manager.");
+    if (typeof options.playerOptions.requesterFn !== "function")
+      throw new OptionError("The manager option 'options.playerOptions.requesterFn' must be a valid function.");
+    if (typeof options.playerOptions.onError !== "undefined") {
+      if (typeof options.playerOptions.onError.autoDestroy !== "boolean")
+        throw new OptionError("The manager option 'options.playerOptions.onError.autoDestroy' must be a boolean.");
+      if (typeof options.playerOptions.onError.autoSkip !== "boolean")
+        throw new OptionError("The manager option 'options.playerOptions.onError.autoSkip' must be a boolean.");
+      if (typeof options.playerOptions.onError.autoStop !== "boolean")
+        throw new OptionError("The manager option 'options.playerOptions.onError.autoStop' must be a boolean.");
+    }
+  }
+  if (typeof options.client !== "undefined") {
+    if (typeof options.client !== "object") throw new OptionError("The manager option 'options.client' Must be a valid object.");
+    if (typeof options.client.id !== "undefined" && typeof options.client.id !== "string")
+      throw new OptionError("The manager option 'options.client.id' Must be a valid string.");
+    if (typeof options.client.username !== "undefined" && typeof options.client.username !== "string")
+      throw new OptionError("The manager option 'options.client.username' must be a valid string.");
+  }
+  if (typeof options.nodeOptions !== "undefined") {
+    if (typeof options.nodeOptions.resumable !== "undefined" && typeof options.nodeOptions.resumable !== "boolean")
+      throw new OptionError("The manager option 'options.nodeOptions.resumable' must be a boolean.");
+    if (typeof options.nodeOptions.resumeTimeout !== "undefined" && typeof options.nodeOptions.resumeTimeout !== "number")
+      throw new OptionError("The manager option 'options.nodeOptions.resumeTimeout' must be a number.");
+    if (typeof options.nodeOptions.resumeByLibrary !== "undefined" && typeof options.nodeOptions.resumeByLibrary !== "boolean")
+      throw new OptionError("The manager option 'options.nodeOptions.resumeByLibrary' must be a boolean.");
+    if (typeof options.nodeOptions.userAgent !== "undefined" && typeof options.nodeOptions.userAgent !== "string")
+      throw new OptionError("The manager option 'options.nodeOptions.userAgent' must be a string.");
+  }
+  if (typeof options.restOptions !== "undefined") {
+    if (typeof options.restOptions.resumeTimeout !== "undefined" && typeof options.restOptions.resumeTimeout !== "number")
+      throw new OptionError("The manager option 'options.restOptions.resumeTimeout' must be a number.");
+  }
 }
 function validateQuery(search) {
   if (typeof search !== "object") throw new OptionError("The 'query' must be a valid object.");
@@ -822,6 +999,11 @@ function validatePlayerData(data) {
       player.lastPosition = data.playerOptions.position;
       player.lastPositionUpdate = Date.now();
     }
+    if (typeof data.playerOptions.filters === "object") {
+      const timescale = Object.freeze({ ...player.filterManager.data.timescale });
+      Object.assign(player.filterManager.data, data.playerOptions.filters);
+      player.filterManager.check(timescale);
+    }
   }
 }
 function validateNodePlugins(node, plugins) {
@@ -846,9 +1028,11 @@ function validateEngine(type) {
 }
 function validateTrack(player, track) {
   if (!track) return Promise.resolve(null);
-  if (isTrack(track)) return Promise.resolve(new Track(track, track.requester));
+  const requesterFn2 = player.manager.options.playerOptions.requesterFn;
+  if (isTrack(track)) return Promise.resolve(new Track(track, requesterFn2(track.requester)));
   if (!isUnresolvedTrack(track)) throw new ResolveError("The track is not a valid unresolved track.");
-  if (!track.resolve || typeof track.resolve !== "function") return new UnresolvedTrack(track, track.requester).resolve(player);
+  if (!track.resolve || typeof track.resolve !== "function")
+    return new UnresolvedTrack(track, requesterFn2(track.requester)).resolve(player);
   return track.resolve(player);
 }
 var isTrack = (track) => {
@@ -880,6 +1064,9 @@ function stringify(value, space) {
     space
   );
 }
+function requesterFn(requester) {
+  return requester;
+}
 function isNode(options) {
   return typeof options.host === "string" && typeof options.port === "number" && typeof options.password === "string" && (typeof options.id === "string" || typeof options.id === "undefined") && (typeof options.secure === "boolean" || typeof options.secure === "undefined") && (typeof options.sessionId === "string" || typeof options.sessionId === "undefined") && (typeof options.retryAmount === "number" || typeof options.retryAmount === "undefined") && (typeof options.retryDelay === "number" || typeof options.retryDelay === "undefined");
 }
@@ -919,7 +1106,7 @@ var LyricsManager = class {
     if (!this.node.sessionId) return null;
     validateNodePlugins(this.node, ["lavalyrics-plugin" /* LavaLyrics */, "java-lyrics-plugin" /* JavaLyrics */, "lavasrc-plugin" /* LavaSrc */]);
     return this.node.rest.request({
-      endpoint: `/sessions/${this.node.sessionId}/players/${guildId}/track/lyrics`,
+      endpoint: RestRoutes.CurrentLyrics(this.node.sessionId, guildId),
       params: {
         skipTrackSource: `${skipSource}`
       }
@@ -941,7 +1128,7 @@ var LyricsManager = class {
     if (!this.node.sessionId) return null;
     validateNodePlugins(this.node, ["lavalyrics-plugin" /* LavaLyrics */, "java-lyrics-plugin" /* JavaLyrics */, "lavasrc-plugin" /* LavaSrc */]);
     return this.node.rest.request({
-      endpoint: "/lyrics",
+      endpoint: RestRoutes.GetLyrics,
       params: {
         track: track.encoded,
         skipTrackSource: `${skipSource}`
@@ -964,7 +1151,7 @@ var LyricsManager = class {
     if (!this.node.sessionId) return;
     validateNodePlugins(this.node, ["lavalyrics-plugin" /* LavaLyrics */, "java-lyrics-plugin" /* JavaLyrics */, "lavasrc-plugin" /* LavaSrc */]);
     await this.node.rest.request({
-      endpoint: `/sessions/${this.node.sessionId}/players/${guildId}/lyrics/subscribe`,
+      endpoint: RestRoutes.SubscribeLyrics(this.node.sessionId, guildId),
       method: "POST" /* Post */,
       params: {
         skipTrackSource: `${skipSource}`
@@ -986,7 +1173,7 @@ var LyricsManager = class {
     if (!this.node.sessionId) return;
     validateNodePlugins(this.node, ["lavalyrics-plugin" /* LavaLyrics */, "java-lyrics-plugin" /* JavaLyrics */, "lavasrc-plugin" /* LavaSrc */]);
     await this.node.rest.request({
-      endpoint: `/sessions/${this.node.sessionId}/players/${guildId}/lyrics/subscribe`,
+      endpoint: RestRoutes.SubscribeLyrics(this.node.sessionId, guildId),
       method: "DELETE" /* Delete */
     });
   }
@@ -1253,7 +1440,7 @@ var NodeManager = class {
    */
   getLeastUsed(sortType = "penalties" /* Penalties */) {
     const nodes = this.nodes.filter((node) => node.state === 2 /* Connected */);
-    if (!nodes.length) throw new Error("No connected nodes available.");
+    if (!nodes.length) throw new NodeManagerError("No connected nodes available.");
     switch (sortType) {
       case "players" /* Players */:
         return nodes.reduce((a, b) => (a.stats?.players ?? 0) < (b.stats?.players ?? 0) ? a : b);
@@ -1378,8 +1565,8 @@ async function onEnd() {
     (x) => x.info.identifier === this.queue.current.info.identifier && x.info.title === this.queue.current.info.title
   )) {
     this.queue.history.unshift(this.queue.current);
-    if (this.queue.history.length > this.manager.options.queueOptions.maxPreviousTracks)
-      this.queue.history.splice(this.manager.options.queueOptions.maxPreviousTracks, this.queue.history.length);
+    if (this.queue.history.length > this.manager.options.queueOptions.maxHistory)
+      this.queue.history.splice(this.manager.options.queueOptions.maxHistory, this.queue.history.length);
     await this.queue.utils.save();
     this.manager.emit(
       "debug" /* Debug */,
@@ -1389,7 +1576,7 @@ async function onEnd() {
   }
   if (this.loop === 1 /* Track */ && this.queue.current) this.queue.unshift(this.queue.current);
   if (this.loop === 2 /* Queue */ && this.queue.current) this.queue.add(this.queue.current);
-  if (!this.queue.current) this.queue.current = await validateTrack(this, this.queue.shift());
+  if (!this.queue.current) this.queue.current = await validateTrack(this, await this.queue.shift());
   await this.queue.utils.save();
   return;
 }
@@ -1536,6 +1723,43 @@ async function socketClosed(payload) {
     `[Player] -> [Socket] The socket has closed: ${this.guildId} | Payload: ${stringify(payload)}`
   );
 }
+async function resumeByLibrary(players) {
+  this.nodeManager.manager.emit("debug" /* Debug */, 2 /* Node */, `[Socket] -> [${this.id}]: Resuming session by library...`);
+  for (const player of players) {
+    try {
+      if (!player.playing && !player.paused && !player.queue.totalSize) {
+        this.nodeManager.manager.emit(
+          "debug" /* Debug */,
+          2 /* Node */,
+          `[Player] -> [Resume] Destroyed player for guild ${player.guildId} due to empty queue.`
+        );
+        await player.destroy();
+        return;
+      }
+      const track = player.queue.current;
+      await player.node.updatePlayer({
+        guildId: player.guildId,
+        playerOptions: { voice: player.voice }
+      });
+      await player.connect();
+      await player.queue.utils.sync(false, true);
+      if (track)
+        await player.play({
+          track,
+          noReplace: false,
+          position: player.lastPosition,
+          paused: player.paused
+        });
+    } catch (error) {
+      this.nodeManager.manager.emit("nodeError" /* NodeError */, this, error);
+    }
+    this.nodeManager.manager.emit(
+      "debug" /* Debug */,
+      2 /* Node */,
+      `[Player] -> [Resume] Resumed player for guild ${player.guildId} using the library.`
+    );
+  }
+}
 
 // src/util/events/websocket.ts
 function onOpen(res) {
@@ -1608,34 +1832,36 @@ async function onMessage(message) {
           this.sessionId = payload.sessionId;
           this.session.resuming = payload.resumed;
           if (payload.resumed) {
-            const players = await this.rest.request({
-              endpoint: `/sessions/${payload.sessionId}/players`
-            }) ?? [];
+            const players2 = await this.rest.getPlayers();
             const timeout = this.nodeManager.manager.options.nodeOptions.resumeTimeout;
-            this.nodeManager.manager.emit("nodeResumed" /* NodeResumed */, this, players, payload);
+            this.nodeManager.manager.emit("nodeResumed" /* NodeResumed */, this, players2, payload);
             this.nodeManager.manager.emit(
               "debug" /* Debug */,
               2 /* Node */,
-              `[Socket] <- [${this.id}]: Resumed session. | Session id: ${payload.sessionId} | Players: ${players.length} | Resumed: ${payload.resumed} | Timeout: ${timeout}ms`
+              `[Socket] <- [${this.id}]: Resumed session. | Session id: ${payload.sessionId} | Players: ${players2.length} | Resumed: ${payload.resumed} | Timeout: ${timeout}ms`
             );
           }
-          this.info = await this.rest.request({ endpoint: "/info" });
-          this.nodeManager.manager.emit(
-            "debug" /* Debug */,
-            2 /* Node */,
-            `[Socket] <- [${this.id}]: Received ready event. | Session id: ${payload.sessionId} | Resumed: ${payload.resumed}`
-          );
-          this.nodeManager.manager.emit("nodeReady" /* NodeReady */, this, this.retryAmount, payload);
-          const isResumable = this.nodeManager.manager.options.nodeOptions.resumable;
-          if (isResumable) {
+          const players = this.nodeManager.manager.players.filter((p) => p.node.id === this.id);
+          const isLibrary = this.nodeManager.manager.options.nodeOptions.resumeByLibrary;
+          if (!payload.resumed && isLibrary && players.length) await resumeByLibrary.call(this, players);
+          this.info = await this.rest.request({ endpoint: RestRoutes.NodeInfo });
+          if (this.info) this.info.isNodelink = !!this.info.isNodelink;
+          const resuming = this.nodeManager.manager.options.nodeOptions.resumable;
+          if (resuming) {
             const timeout = this.nodeManager.manager.options.nodeOptions.resumeTimeout;
             this.nodeManager.manager.emit(
               "debug" /* Debug */,
               2 /* Node */,
-              `[Socket] -> [${this.id}]: Resuming session... | Timeout: ${timeout}ms`
+              `[Socket] -> [${this.id}]: Setting timeout to resume session. | Timeout: ${timeout}ms`
             );
-            await this.updateSession(isResumable, timeout);
+            await this.updateSession({ resuming, timeout });
           }
+          this.nodeManager.manager.emit(
+            "debug" /* Debug */,
+            2 /* Node */,
+            `[Socket] <- [${this.id}]: Received ready event. | Session id: ${payload.sessionId} | Resumed: ${payload.resumed}`
+          );
+          this.nodeManager.manager.emit("nodeReady" /* NodeReady */, this, this.retryAmount, payload);
         }
         break;
       case "event" /* Event */: {
@@ -1683,7 +1909,11 @@ async function onMessage(message) {
         break;
       }
     }
-    this.nodeManager.manager.emit("debug" /* Debug */, 2 /* Node */, `[Socket] -> [${this.id}]: Received payload: ${stringify(payload)}`);
+    this.nodeManager.manager.emit(
+      "debug" /* Debug */,
+      2 /* Node */,
+      `[Socket] -> [${this.id}]: Received payload: ${stringify(payload)}`
+    );
   } catch (error) {
     this.nodeManager.manager.emit("nodeError" /* NodeError */, this, error);
   }
@@ -1708,7 +1938,7 @@ var Node = class {
   nodeManager;
   /**
    * The lyrics manager for the node.
-   * @type {LyricsManager}
+   * @type {LyricsManagerStructure}
    */
   lyricsManager;
   /**
@@ -1809,14 +2039,14 @@ var Node = class {
   decode = {
     single: async (track, requester) => {
       const raw = await this.rest.request({
-        endpoint: "/decodetrack",
+        endpoint: RestRoutes.DecodeTrack,
         params: { encodedTrack: track }
       });
       return new Track(raw, requester);
     },
     multiple: async (tracks, requester) => {
       const raw = await this.rest.request({
-        endpoint: "/decodetracks",
+        endpoint: RestRoutes.DecodeTracks,
         method: "POST" /* Post */,
         body: stringify(tracks)
       }) ?? [];
@@ -1838,6 +2068,25 @@ var Node = class {
   get id() {
     return this.options.id;
   }
+  /**
+   *
+   * Check if the node is a Nodelink node.
+   * @returns {boolean} True if the node is a Nodelink node, false otherwise.
+   * @example
+   * ```ts
+   * const node = manager.nodeManager.get("node1");
+   * if (node) {
+   * 	 if (node.isNodelink()) {
+   * 		console.log("The node is a Nodelink node");
+   *   } else {
+   *       console.log("The node is a Lavalink node");
+   *   }
+   * }
+   * ```
+   */
+  isNodelink() {
+    return this.info?.isNodelink ?? false;
+  }
   /**
    * The socket address to connect the node.
    * @type {string}
@@ -1897,7 +2146,7 @@ var Node = class {
     search.engine ??= this.nodeManager.manager.options.defaultSearchEngine;
     const identifier = validateQuery(search);
     return this.rest.request({
-      endpoint: "/loadtracks",
+      endpoint: RestRoutes.LoadTracks,
       params: {
         identifier,
         ...search.params
@@ -2061,21 +2310,20 @@ var Node = class {
   /**
    *
    * Update the session for the node
-   * @param {boolean} resuming Enable resuming for the session.
-   * @param {number | null} timeout The timeout for the session.
+   * @param {SessionResumingOptions} options The session resuming options.
    * @returns {Promise<LavalinkSession | null>}
    * @example
    * ```ts
    * const node = manager.nodeManager.get("node1");
    * if (node) {
-   * 	const session = await node.updateSession(true, 60);
+   * 	const session = await node.updateSession({ resuming: true, timeout: 30000 });
    * 	console.log(session); // the lavalink session
    * }
    * ```
    */
-  async updateSession(resuming, timeout = null) {
+  async updateSession(options) {
     if (!this.sessionId) return null;
-    const session = await this.rest.updateSession(resuming, timeout);
+    const session = await this.rest.updateSession(options);
     if (session) this.session = session;
     return session;
   }
@@ -2331,7 +2579,7 @@ var Rest = class {
     validatePlayerData.call(this.node, data);
     return this.request({
       method: "PATCH" /* Patch */,
-      endpoint: `/sessions/${this.sessionId}/players/${data.guildId}`,
+      endpoint: RestRoutes.UpdatePlayer(this.sessionId, data.guildId),
       body: { ...data.playerOptions },
       params: { noReplace: `${data.noReplace ?? false}` }
     });
@@ -2382,23 +2630,23 @@ var Rest = class {
     );
     await this.request({
       method: "DELETE" /* Delete */,
-      endpoint: `/sessions/${this.sessionId}/players/${guildId}`
+      endpoint: RestRoutes.UpdatePlayer(this.sessionId, guildId)
     });
   }
   /**
    *
    * Update the session for the node
-   * @param {boolean} resuming Enable resuming for the session.
-   * @param {number | null} timeout The timeout for the session.
+   * @param {SessionResumingOptions} options The session resuming options.
    * @returns {Promise<LavalinkSession | null>} The updated session data.
    * @example
    * ```ts
-   * const session = await node.rest.updateSession(true, 10000);
+   * const session = await node.rest.updateSession({ resuming: true, timeout: 30000 });
    * if (session) console.log(session); // The lavalink session data
    * ```
    */
-  updateSession(resuming, timeout = null) {
+  updateSession(options) {
     if (!this.sessionId) return Promise.resolve(null);
+    const { resuming, timeout } = options;
     this.node.nodeManager.manager.emit(
       "debug" /* Debug */,
       4 /* Rest */,
@@ -2406,10 +2654,40 @@ var Rest = class {
     );
     return this.request({
       method: "PATCH" /* Patch */,
-      endpoint: `/sessions/${this.sessionId}`,
+      endpoint: RestRoutes.UpdateSession(this.sessionId),
       body: { resuming, timeout }
     });
   }
+  /**
+   *
+   * Get all players for the current session.
+   * @returns {Promise<LavalinkPlayer[]>} The players for the current session.
+   * @example
+   * ```ts
+   * const players = await node.rest.getPlayers();
+   * console.log(players); // The lavalink players for the current session
+   * ```
+   */
+  async getPlayers() {
+    if (!this.sessionId) return [];
+    this.node.nodeManager.manager.emit(
+      "debug" /* Debug */,
+      4 /* Rest */,
+      `[Rest] -> [${this.node.id}]: Fetching all players for session id: ${this.sessionId}`
+    );
+    const players = await this.request({
+      endpoint: RestRoutes.GetPlayers(this.sessionId)
+    }) ?? [];
+    if (!players.length) {
+      this.node.nodeManager.manager.emit(
+        "debug" /* Debug */,
+        4 /* Rest */,
+        `[Rest] <- [${this.node.id}]: No players found for session id: ${this.sessionId}`
+      );
+      return [];
+    }
+    return players;
+  }
 };
 
 // src/classes/player/filters/DSPXPlugin.ts
@@ -2432,6 +2710,14 @@ var DSPXPluginFilter = class {
    * Set the low-pass filter with the given settings.
    * @param {FilterPluginPassSettings} [settings=DefaultFilter.DSPXLowPass] The settings for the low-pass filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not have the required plugin or filter enabled.
+   * @example
+   * ```ts
+   * // Set the low-pass filter with custom settings
+   * await player.filterManager.dspxPlugin.setLowPass({ cutoffFrequency: 500, boostFactor: 1.5 });
+   * // Disable the low-pass filter
+   * await player.filterManager.dspxPlugin.setLowPass();
+   * ```
    */
   async setLowPass(settings = DefaultFilterPreset.DSPXLowPass) {
     validateNodePlugins(this.manager.player.node, ["lavadspx-plugin" /* LavaDspx */]);
@@ -2454,6 +2740,14 @@ var DSPXPluginFilter = class {
    * Set the high-pass filter with the given settings.
    * @param {FilterPluginPassSettings} [settings=DefaultFilter.DSPXHighPass] The settings for the high-pass filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not have the required plugin or filter enabled.
+   * @example
+   * ```ts
+   * // Set the high-pass filter with custom settings
+   * await player.filterManager.dspxPlugin.setHighPass({ cutoffFrequency: 2000, boostFactor: 0.8 });
+   * // Disable the high-pass filter
+   * await player.filterManager.dspxPlugin.setHighPass();
+   * ```
    */
   async setHighPass(settings = DefaultFilterPreset.DSPXHighPass) {
     validateNodePlugins(this.manager.player.node, ["lavadspx-plugin" /* LavaDspx */]);
@@ -2476,6 +2770,14 @@ var DSPXPluginFilter = class {
    * Set the normalization filter with the given settings.
    * @param {NormalizationSettings} [settings=DefaultFilter.DSPXNormalization] The settings for the normalization filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not have the required plugin or filter enabled.
+   * @example
+   * ```ts
+   * // Set the normalization filter with custom settings
+   * await player.filterManager.dspxPlugin.setNormalization({ maxAmplitude: 0.9, adaptive: true });
+   * // Disable the normalization filter
+   * await player.filterManager.dspxPlugin.setNormalization();
+   * ```
    */
   async setNormalization(settings = DefaultFilterPreset.DSPXNormalization) {
     validateNodePlugins(this.manager.player.node, ["lavadspx-plugin" /* LavaDspx */]);
@@ -2498,6 +2800,14 @@ var DSPXPluginFilter = class {
    * Set the echo filter with the given settings.
    * @param {EchoSettings} [settings=DefaultFilter.DSPXEcho] The settings for the echo filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not have the required plugin or filter enabled.
+   * @example
+   * ```ts
+   * // Set the echo filter with custom settings
+   * await player.filterManager.dspxPlugin.setEcho({ echoLength: 500, decay: 0.5, delay: 200 });
+   * // Disable the echo filter
+   * await player.filterManager.dspxPlugin.setEcho();
+   * ```
    */
   async setEcho(settings = DefaultFilterPreset.DSPXEcho) {
     validateNodePlugins(this.manager.player.node, ["lavadspx-plugin" /* LavaDspx */]);
@@ -2538,6 +2848,14 @@ var LavalinkPluginFilter = class {
    * Set the echo filter with the given settings.
    * @param {Omit<EchoSettings, "echoLength">} [settings=DefaultFilter.PluginEcho] The settings for the echo filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not have the required plugin or filter enabled.
+   * @example
+   * ```ts
+   * // Set the echo filter with custom settings
+   * await player.filterManager.lavalinkPlugin.setEcho({ decay: 0.5, delay: 200 });
+   * // Disable the echo filter
+   * await player.filterManager.lavalinkPlugin.setEcho();
+   * ```
    */
   async setEcho(settings = DefaultFilterPreset.PluginEcho) {
     validateNodePlugins(this.manager.player.node, ["lavalink-filter-plugin" /* FilterPlugin */]);
@@ -2560,6 +2878,14 @@ var LavalinkPluginFilter = class {
    * Set the reverb filter with the given settings.
    * @param {Partial<LavalinkFilterPluginReverbSettings>} [settings=DefaultFilter.PluginReverb] The settings for the reverb filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not have the required plugin or filter enabled.
+   * @example
+   * ```ts
+   * // Set the reverb filter with custom settings
+   * await player.filterManager.lavalinkPlugin.setReverb({ delays: [50, 100, 150], gains: [0.5, 0.3, 0.2] });
+   * // Disable the reverb filter
+   * await player.filterManager.lavalinkPlugin.setReverb();
+   * ```
    */
   async setReverb(settings = DefaultFilterPreset.PluginReverb) {
     validateNodePlugins(this.manager.player.node, ["lavalink-filter-plugin" /* FilterPlugin */]);
@@ -2653,6 +2979,11 @@ var FilterManager = class {
   /**
    * Resets all filters to their default values.
    * @returns {Promise<this>} A promise that resolves to the instance of the filter manager.
+   * @example
+   * ```ts
+   * // Reset all filters
+   * await player.filterManager.reset();
+   * ```
    */
   async reset() {
     this.filters = {
@@ -2686,6 +3017,11 @@ var FilterManager = class {
    *
    * Applies the current filters to the player.
    * @returns {Promise<this>} A promise that resolves to the instance of the filter manager.
+   * @example
+   * ```ts
+   * // Apply the current filters
+   * await player.filterManager.apply();
+   * ```
    */
   async apply() {
     if (!this.player.node.sessionId) return this;
@@ -2722,6 +3058,11 @@ var FilterManager = class {
    * Checks if the current filters are active.
    * @param {TimescaleSettings} timescale The timescale settings to check against.
    * @returns {void} Nothing!
+   * @example
+   * ```ts
+   * // Check the current filters
+   * player.filterManager.check();
+   * ```
    */
   check(timescale) {
     this.filters.rotation = this.data.rotation?.rotationHz !== 0;
@@ -2752,6 +3093,12 @@ var FilterManager = class {
    * Checks if a specific filter is active.
    * @param {FilterType} filter The filter type to check.
    * @returns {boolean} True if the filter is active, false otherwise.
+   * @example
+   * ```ts
+   * // Check if the nightcore filter is active
+   * const isNightcoreActive = player.filterManager.has(FilterType.Nightcore);
+   * console.log(isNightcoreActive); // true or false
+   * ```
    */
   has(filter) {
     const dspx = this.filters.lavalinkLavaDspxPlugin[filter];
@@ -2768,6 +3115,12 @@ var FilterManager = class {
    * Sets the volume for the player.
    * @param {number} volume The volume level to set (between 0 and 5).
    * @returns {Promise<this>} A promise that resolves to the player instance.
+   * @throws {PlayerError} If the volume is not a number between 0 and 5.
+   * @example
+   * ```ts
+   * // Set the volume to 2.5
+   * await player.filterManager.setVolume(2.5);
+   * ```
    */
   async setVolume(volume) {
     if (typeof volume !== "number" || Number.isNaN(volume) || volume < 0 || volume > 5)
@@ -2780,6 +3133,12 @@ var FilterManager = class {
    * Sets the audio output for the player.
    * @param {AudioOutput} output The audio output to set.
    * @returns {Promise<this>} A promise that resolves to the player instance.
+   * @throws {PlayerError} If the output is not a valid AudioOutput value.
+   * @example
+   * ```ts
+   * // Set the audio output to mono
+   * await player.filterManager.setAudioOutput(AudioOutput.Mono);
+   * ```
    */
   async setAudioOutput(output) {
     const outputs = Object.values(AudioOutput);
@@ -2793,6 +3152,12 @@ var FilterManager = class {
    * Sets the speed for the player.
    * @param {number} speed The speed to set (default is 1).
    * @returns {Promise<this>} A promise that resolves to the player instance.
+   * @throws {PlayerError} If the node does not support the timescale filter.
+   * @example
+   * ```ts
+   * // Set the speed to 1.5
+   * await player.filterManager.setSpeed(1.5);
+   * ```
    */
   async setSpeed(speed = 1) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2814,6 +3179,12 @@ var FilterManager = class {
    * Sets the rate for the player.
    * @param {number} rate The rate to set (default is 1).
    * @returns {Promise<this>} A promise that resolves to the player instance.
+   * @throws {PlayerError} If the node does not support the timescale filter.
+   * @example
+   * ```ts
+   * // Set the rate to 1.2
+   * await player.filterManager.setRate(1.2);
+   * ```
    */
   async setRate(rate = 1) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2835,6 +3206,12 @@ var FilterManager = class {
    * Sets the pitch for the player.
    * @param {number} pitch The pitch
    * @returns {Promise<this>} A promise that resolves to the player instance.
+   * @throws {PlayerError} If the node does not support the timescale filter.
+   * @example
+   * ```ts
+   * // Set the pitch to 0.8
+   * await player.filterManager.setPitch(0.8);
+   * ```
    */
   async setPitch(pitch = 1) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2856,6 +3233,15 @@ var FilterManager = class {
    * Sets the EQ bands for the player.
    * @param {RestOrArray<EQBandSettings>} bands The EQ band settings to set.
    * @returns {Promise<this>} A promise that resolves to the instance of the manager.
+   * @throws {PlayerError} If the bands array is empty or contains invalid band settings.
+   * @example
+   * ```ts
+   * // Set multiple EQ bands
+   * await player.filterManager.setEQBand(
+   *   { band: 0, gain: 0.5 },
+   *   { band: 1, gain: -0.3 },
+   * );
+   * ```
    */
   async setEQBand(...bands) {
     bands = bands.flat();
@@ -2868,6 +3254,11 @@ var FilterManager = class {
    *
    * Clears all EQ bands for the player.
    * @returns {Promise<this>} A promise that resolves to the instance of the manager.
+   * @example
+   * ```ts
+   * // Clear all EQ bands
+   * await player.filterManager.clearEQBands();
+   * ```
    */
   async clearEQBands() {
     return this.setEQBand(Array.from({ length: 15 }, (_, i) => ({ band: i, gain: 0 })));
@@ -2877,6 +3268,12 @@ var FilterManager = class {
    * Set the vibrato filter with the given settings.
    * @param {TremoloSettings} [settings=DefaultFilterPreset.Vibrato] The settings for the vibrato filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not support the vibrato filter.
+   * @example
+   * ```ts
+   * // Set the vibrato filter
+   * await player.filterManager.setVibrato({ frequency: 4.0, depth: 0.5 });
+   * ```
    */
   async setVibrato(settings = DefaultFilterPreset.Vibrato) {
     if (!this.player.node.info?.filters?.includes("vibrato" /* Vibrato */))
@@ -2893,6 +3290,12 @@ var FilterManager = class {
    * Set the tremolo filter with the given settings.
    * @param {TremoloSettings} [settings=DefaultFilterPreset.Tremolo] The settings for the tremolo filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not support the tremolo filter.
+   * @example
+   * ```ts
+   * // Set the tremolo filter
+   * await player.filterManager.setTremolo({ frequency: 4.0, depth: 0.5 });
+   * ```
    */
   async setTremolo(settings = DefaultFilterPreset.Tremolo) {
     if (!this.player.node.info?.filters?.includes("tremolo" /* Tremolo */))
@@ -2909,6 +3312,12 @@ var FilterManager = class {
    * Set the low-pass filter with the given settings.
    * @param {LowPassSettings} [settings=DefaultFilterPreset.Lowpass] The settings for the low-pass filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not support the low-pass filter.
+   * @example
+   * ```ts
+   * // Set the low-pass filter
+   * await player.filterManager.setLowPass({ smoothing: 20.0 });
+   * ```
    */
   async setLowPass(settings = DefaultFilterPreset.Lowpass) {
     if (!this.player.node.info?.filters?.includes("lowPass" /* LowPass */))
@@ -2921,6 +3330,12 @@ var FilterManager = class {
    * Set the nightcore filter with the given settings.
    * @param {Partial<TimescaleSettings>} [settings=DefaultFilterPreset.Nightcore] The settings for the nightcore filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not support the timescale filter.
+   * @example
+   * ```ts
+   * // Set the nightcore filter
+   * await player.filterManager.setNightcore();
+   * ```
    */
   async setNightcore(settings = DefaultFilterPreset.Nightcore) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2940,6 +3355,12 @@ var FilterManager = class {
    * Set the vaporwave filter with the given settings.
    * @param {Partial<TimescaleSettings>} [settings=DefaultFilterPreset.Vaporwave] The settings for the vaporwave filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not support the timescale filter.
+   * @example
+   * ```ts
+   * // Set the vaporwave filter
+   * await player.filterManager.setVaporwave();
+   * ```
    */
   async setVaporwave(settings = DefaultFilterPreset.Vaporwave) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -2959,6 +3380,12 @@ var FilterManager = class {
    * Set the karaoke filter with the given settings.
    * @param {KaraokeSettings} [settings=DefaultFilterPreset.Karaoke] The settings for the karaoke filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not support the karaoke filter.
+   * @example
+   * ```ts
+   * // Set the karaoke filter
+   * await player.filterManager.setKaraoke({ level: -15.0, monoLevel: -20.0, filterBand: 220.0, filterWidth: 100.0 });
+   * ```
    */
   async setKaraoke(settings = DefaultFilterPreset.Karaoke) {
     if (!this.player.node.info?.filters?.includes("karaoke" /* Karaoke */))
@@ -2977,6 +3404,12 @@ var FilterManager = class {
    * Set the distortion filter with the given settings.
    * @param {Partial<DistortionSettings>} [settings=DefaultFilterPreset.Distortion] The settings for the distortion filter.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not support the distortion filter.
+   * @example
+   * ```ts
+   * // Set the distortion filter
+   * await player.filterManager.setDistortion({ sinOffset: 0.5, sinScale: 2.0 });
+   * ```
    */
   async setDistortion(settings = DefaultFilterPreset.Distortion) {
     if (!this.player.node.info?.filters?.includes("distortion" /* Distortion */))
@@ -2997,6 +3430,12 @@ var FilterManager = class {
    * Set the timescale filter with the given settings.
    * @param {Partial<TimescaleSettings>} settings The timescale settings to set.
    * @returns {Promise<this>} The instance of the filter manager.
+   * @throws {PlayerError} If the node does not support the timescale filter.
+   * @example
+   * ```ts
+   * // Set the timescale filter
+   * await player.filterManager.setTimescale({ speed: 1.2, pitch: 0.8, rate: 1.0 });
+   * ```
    */
   async setTimescale(settings) {
     if (!this.player.node.info?.filters?.includes("timescale" /* Timescale */))
@@ -3012,107 +3451,26 @@ var FilterManager = class {
   /**
    * Convert the filter settings to a JSON object.
    * @returns {FilterSettings} The filter settings as a JSON object.
+   * @example
+   * ```ts
+   * // Convert filter settings to JSON
+   * const filterSettingsJSON = player.filterManager.toJSON();
+   * console.log(filterSettingsJSON); // { volume: 1, equalizer: [...], ... }
+   * ```
    */
   toJSON() {
     return { ...this.data };
   }
 };
 
-// src/classes/player/Storage.ts
-var PlayerStorage = class {
-  /**
-   * The internal storage.
-   * @type {Map<K, V>}
-   * @private
-   * @readonly
-   * @internal
-   */
-  internal = /* @__PURE__ */ new Map();
-  /**
-   *
-   * Get the value for a key in the storage.
-   * @param {K} key The key to get the value for.
-   * @returns {V | undefined} The value for the key, or undefined if it doesn't exist.
-   */
-  get(key) {
-    return this.internal.get(key);
-  }
-  /**
-   * Set the value for a key in the storage.
-   * @param {K} key The key to set the value for.
-   * @param {V} value The value to set for the key.
-   */
-  set(key, value) {
-    this.internal.set(key, value);
-  }
-  /**
-   * Check if the storage has a key.
-   * @param {K} key The key to check for.
-   * @returns {boolean} True if the storage has the key, false otherwise.
-   */
-  has(key) {
-    return this.internal.has(key);
-  }
-  /**
-   * Delete a key from the storage.
-   * @param {K} key The key to delete.
-   * @returns {boolean} True if the key was deleted, false otherwise.
-   */
-  delete(key) {
-    return this.internal.delete(key);
-  }
-  /**
-   * Get all keys in the storage.
-   * @returns {K[]} The keys in the storage.
-   */
-  keys() {
-    return [...this.internal.keys()];
-  }
-  /**
-   * Get all values in the storage.
-   * @returns {V[]} The values in the storage.
-   */
-  values() {
-    return [...this.internal.values()];
-  }
-  /**
-   * Get all entries in the storage.
-   * @returns {[K, V][]} The entries in the storage.
-   */
-  entries() {
-    return [...this.internal.entries()];
-  }
-  /**
-   *
-   * Get all key-value pairs in the storage.
-   * @returns {Record<K[number], V>} An object containing all key-value pairs in the storage, excluding internal keys.
-   */
-  all() {
-    return Object.fromEntries([...this.internal.entries()].filter(([key]) => !key.startsWith("internal_")));
-  }
-  /**
-   * Clear the storage.
-   */
-  clear() {
-    this.internal.clear();
-  }
-  /**
-   * Get the size of the storage.
-   * @returns {number} The number of entries in the storage.
-   */
-  get size() {
-    return this.internal.size;
-  }
-};
-
 // src/classes/player/Player.ts
 var Player = class {
   /**
    * The data for the player.
-   * @type {PlayerStorage}
+   * @type {PlayerStorageAdapter}
    * @readonly
    */
-  data = new PlayerStorage();
+  data;
   /**
    * The options for the player.
    * @type {PlayerOptions}
@@ -3264,6 +3622,7 @@ var Player = class {
     this.volume = options.volume ?? 100;
     this.textId = options.textId;
     this.node = (typeof this.options.node === "string" ? this.manager.nodeManager.get(this.options.node) : this.options.node) ?? this.manager.nodeManager.getLeastUsed();
+    this.data = this.manager.options.playerOptions.storage;
     validatePlayerOptions(this.options);
     this.queue = Structures.Queue(this);
     this.filterManager = Structures.FilterManager(this);
@@ -3279,6 +3638,14 @@ var Player = class {
     current: (skipSource) => this.node.lyricsManager.current(this.guildId, skipSource),
     get: (track, skipSource) => this.node.lyricsManager.get(track, skipSource)
   };
+  /**
+   *
+   * Check if the player is currently playing a track.
+   * @returns {boolean} Whether the player is currently playing a track.
+   */
+  isPlaying() {
+    return this.playing && !this.paused;
+  }
   /**
    *
    * Search for a track or playlist.
@@ -3362,15 +3729,8 @@ var Player = class {
    */
   async disconnect() {
     if (!this.voiceId) return this;
-    await this.manager.options.sendPayload(this.guildId, {
-      op: 4,
-      d: {
-        guild_id: this.guildId,
-        channel_id: null,
-        self_deaf: this.selfDeaf,
-        self_mute: this.selfMute
-      }
-    });
+    this.voiceId = void 0;
+    await this.setVoice({ voiceId: void 0 });
     this.manager.emit("debug" /* Debug */, 3 /* Player */, `[Player] -> [Disconnect] Player disconnected for guild: ${this.guildId}`);
     this.connected = false;
     return this;
@@ -3416,11 +3776,15 @@ var Player = class {
   async play(options = {}) {
     if (typeof options !== "object") throw new PlayerError("The play options must be an object.");
     if (options.track) this.queue.current = await validateTrack(this, options.track);
-    else if (!this.queue.current) this.queue.current = await validateTrack(this, this.queue.shift());
+    else if (!this.queue.current) this.queue.current = await validateTrack(this, await this.queue.shift());
     if (!this.queue.current) throw new PlayerError("No track to play.");
     if (!isTrack(this.queue.current) && !isUnresolvedTrack(this.queue.current))
       throw new PlayerError("The track must be a valid Track or UnresolvedTrack instance.");
-    this.manager.emit("debug" /* Debug */, 3 /* Player */, `[Player] -> [Play] A new track is playing: ${this.queue.current.info.title}`);
+    this.manager.emit(
+      "debug" /* Debug */,
+      3 /* Player */,
+      `[Player] -> [Play] A new track is playing: ${this.queue.current.info.title}`
+    );
     const position = options.position ?? 0;
     this.lastPosition = position;
     this.lastPositionUpdate = Date.now();
@@ -3449,15 +3813,7 @@ var Player = class {
    */
   async connect() {
     if (!this.voiceId) return this;
-    await this.manager.options.sendPayload(this.guildId, {
-      op: 4,
-      d: {
-        guild_id: this.guildId,
-        channel_id: this.voiceId,
-        self_deaf: this.selfDeaf,
-        self_mute: this.selfMute
-      }
-    });
+    await this.setVoice();
     this.manager.emit("debug" /* Debug */, 3 /* Player */, `[Player] -> [Connect] Player connected for guild: ${this.guildId}`);
     this.connected = true;
     return this;
@@ -3556,7 +3912,7 @@ var Player = class {
   }
   /**
    * Set the voice of the player.
-   * @param {Partial<VoiceChannelUpdate>} voice The voice state to set.
+   * @param {NullableVoiceChannelUpdate} options The voice state to set.
    * @returns {Promise<void>}
    * @example
    * ```ts
@@ -3564,27 +3920,17 @@ var Player = class {
    * player.setVoice({ voiceId: "newVoiceId" });
    * ```
    */
-  async setVoice(voice) {
-    if (voice.voiceId === this.voiceId) return;
-    if (voice.voiceId) {
-      this.voiceId = voice.voiceId;
-      this.options.voiceId = voice.voiceId;
-    }
-    if (voice.selfDeaf) {
-      this.selfDeaf = voice.selfDeaf;
-      this.options.selfDeaf = voice.selfDeaf;
-    }
-    if (voice.selfMute) {
-      this.selfMute = voice.selfMute;
-      this.options.selfMute = voice.selfMute;
-    }
+  async setVoice(options = {}) {
+    options.voiceId ??= this.voiceId;
+    options.selfDeaf ??= this.selfDeaf;
+    options.selfMute ??= this.selfMute;
     await this.manager.options.sendPayload(this.guildId, {
       op: 4,
       d: {
         guild_id: this.guildId,
-        self_deaf: this.selfDeaf,
-        self_mute: this.selfMute,
-        channel_id: this.voiceId ?? null
+        self_deaf: options.selfDeaf,
+        self_mute: options.selfMute,
+        channel_id: options.voiceId ?? null
       }
     });
     this.manager.emit(
@@ -3643,6 +3989,12 @@ var Player = class {
    * Update the player with new data.
    * @param {NonGuildUpdatePlayerInfo} data The data to update the player with.
    * @returns {Promise<LavalinkPlayer | null>} The updated player data.
+   * @example
+   * ```ts
+   * const player = manager.getPlayer("guildId");
+   * const updatedPlayer = await player.updatePlayer({ volume: 50 });
+   * console.log(updatedPlayer); // the updated player data
+   * ```
    */
   async updatePlayer(data) {
     return this.node.updatePlayer({
@@ -3690,7 +4042,7 @@ var Player = class {
 var QueueStore = class {
   /**
    * Storage manager instance.
-   * @type {StorageAdapter}
+   * @type {QueueStorageAdapter}
    * @private
    * @readonly
    * @internal
@@ -3699,7 +4051,7 @@ var QueueStore = class {
   /**
    *
    * Constructor of the queue store.
-   * @param {StorageAdapter} storage Storage manager instance.
+   * @param {QueueStorageAdapter} storage Storage manager instance.
    * @example
    * ```ts
    * const storage = new CustomStorage();
@@ -3801,16 +4153,15 @@ var QueueUtils = class {
    * ```
    */
   save() {
-    const max = this.options.maxPreviousTracks;
+    const max = this.options.maxHistory;
     const length = this.queue.tracks.length;
-    const json = this.queue.toJSON();
     if (length > max) this.queue.history.splice(0, length - max);
     this.queue.player.manager.emit(
       "debug" /* Debug */,
       5 /* Queue */,
-      `[Queue] -> [Adapter] Saving queue for ${this.queue.player.guildId} | Object: ${stringify(json)}`
+      `[Queue] -> [Adapter] Saving queue for ${this.queue.player.guildId} | Object: ${stringify(this.queue.toJSON())}`
     );
-    return this.store.set(this.queue.player.guildId, json);
+    return this.store.set(this.queue.player.guildId, this.queue.toJSON());
   }
   /**
    *
@@ -3832,6 +4183,8 @@ var QueueUtils = class {
   /**
    *
    * Sync the queue.
+   * @param {boolean} [override=true] Whether to override the current queue or not.
+   * @param {boolean} [syncCurrent=false] Whether to sync the current track or not.
    * @returns {Awaitable<void>}
    * @example
    * ```ts
@@ -3976,25 +4329,50 @@ var Queue = class {
   isEmpty() {
     return this.size === 0;
   }
+  /**
+   *
+   * Build a track from a Lavalink track or unresolved Lavalink track.
+   * @param {LavalinkTrack | UnresolvedLavalinkTrack} track The track to build.
+   * @param {TrackRequester} requester The requester of the track.
+   * @returns {Promise<Track>} The built track.
+   * @example
+   * ```ts
+   * const queue = player.queue;
+   * const lavalinkTrack = {...} // some lavalink track
+   * const track = await queue.build(lavalinkTrack, author);
+   *
+   * console.log(track.info.title); // The title of the track
+   * ```
+   */
+  async build(track, requester) {
+    const requesterFn2 = this.player.manager.options.playerOptions.requesterFn;
+    if (isUnresolvedTrack(track)) return new UnresolvedTrack(track, requesterFn2(requester)).resolve(this.player);
+    if (isTrack(track)) return new Track(track, requesterFn2(requester));
+    return track;
+  }
   /**
    *
    * Get the previous track of the queue.
    * @param {boolean} [remove=false] Whether to remove the track from the previous queue.
-   * @returns {Track | null} The previous track of the queue.
+   * @returns {Promise<Track | null>} The previous track of the queue.
    * @example
    * ```ts
    * const queue = player.queue;
    *
-   * console.log(queue.previous()); // null
+   * console.log(await queue.previous()); // null
    * queue.add(track);
    * queue.add(track2);
    *
-   * console.log(queue.previous()); // track
-   * console.log(queue.previous(true)); // track and remove it from the previous tracks
+   * console.log(await queue.previous()); // track
+   * console.log(await queue.previous(true)); // track and remove it from the previous tracks
    * ```
    */
-  previous(remove = false) {
-    if (remove) return this.history.shift() ?? null;
+  async previous(remove = false) {
+    if (remove) {
+      const track = this.history.shift() ?? null;
+      if (track) await this.utils.save();
+      return track;
+    }
     return this.history[0] ?? null;
   }
   /**
@@ -4002,94 +4380,102 @@ var Queue = class {
    * Add a track or tracks to the queue.
    * @param {Track | Track[]} track The track or tracks to add.
    * @param {number} [position] The position to add the track or tracks.
-   * @returns {this} The queue instance.
+   * @returns {Promise<this>} The queue instance.
    * @example
    * ```ts
    * const queue = player.queue;
    *
    * console.log(queue.size); // 0
    *
-   * queue.add(track);
+   * await queue.add(track);
    * console.log(queue.size); // 1
    *
-   * queue.add([track1, track2]);
+   * await queue.add([track1, track2]);
    * console.log(queue.size); // 3
    *
-   * queue.add(track3, 1);
+   * await queue.add(track3, 1);
    * console.log(queue.size); // 4
    * console.log(queue.tracks); // [track1, track3, track2, track]
    * ```
    */
-  add(track, position) {
+  async add(track, position) {
     const tracks = Array.isArray(track) ? track : [track];
     if (typeof position === "number" && position >= 0 && position < this.tracks.length) return this.splice(position, 0, ...tracks);
     this.tracks.push(...tracks);
     this.player.manager.emit("queueUpdate" /* QueueUpdate */, this.player, this);
     this.player.manager.emit("debug" /* Debug */, 5 /* Queue */, `[Queue] -> [Add] Added ${this.tracks.length} tracks to the queue.`);
+    await this.utils.save();
     return this;
   }
   /**
    *
    * Get the first track of the queue.
-   * @returns {HoshimiTrack | null} The first track of the queue.
+   * @returns {Promise<HoshimiTrack | null>} The first track of the queue.
    * @example
    * ```ts
    * const queue = player.queue;
    *
-   * console.log(queue.shift()); // null
-   * queue.add(track);
+   * console.log(await queue.shift()); // null
+   * await queue.add(track);
    *
-   * console.log(queue.shift()); // track
-   * queue.add(track2);
+   * console.log(await queue.shift()); // track
+   * await queue.add(track2);
    * ```
    */
-  shift() {
-    return this.tracks.shift() ?? null;
+  async shift() {
+    const track = this.tracks.shift() ?? null;
+    if (track) await this.utils.save();
+    return track;
   }
   /**
    *
    * Add tracks to the beginning of the queue.
    * @param {Track[]} tracks The tracks to add.
-   * @returns {this} The queue instance.
+   * @returns {Promise<this>} The queue instance.
    * @example
    * ```ts
    * const queue = player.queue;
    *
    * console.log(queue.size); // 0
-   * queue.unshift(track);
+   * await queue.unshift(track);
    *
    * console.log(queue.size); // 1
-   * queue.unshift([track1, track2]);
+   * await queue.unshift(track1, track2);
    *
    * console.log(queue.size); // 3
    * console.log(queue.tracks); // [track1, track2, track]
    * ```
    */
-  unshift(...tracks) {
+  async unshift(...tracks) {
     this.tracks.unshift(...tracks);
-    this.player.manager.emit("debug" /* Debug */, 5 /* Queue */, `[Queue] -> [Unshift] Added ${this.tracks.length} tracks to the queue.`);
+    this.player.manager.emit(
+      "debug" /* Debug */,
+      5 /* Queue */,
+      `[Queue] -> [Unshift] Added ${this.tracks.length} tracks to the queue.`
+    );
+    await this.utils.save();
     return this;
   }
   /**
    *
    * Shuffle the queue.
-   * @returns {this} The queue instance.
+   * @returns {Promise<this>} The queue instance.
    * @example
    * ```ts
    * const queue = player.queue;
    *
    * console.log(queue.size); // 0
-   * queue.add(track);
-   * queue.add([track1, track2]);
+   * await queue.add(track);
+   * await queue.add(track1, track2);
    *
    * console.log(queue.size); // 3
    * console.log(queue.tracks); // [track, track1, track2]
    *
-   * queue.shuffle();
+   * await queue.shuffle();
    * console.log(queue.tracks); // [track2, track, track1]
    * ```
    */
-  shuffle() {
+  async shuffle() {
     if (this.size <= 1) return this;
     if (this.size === 2) [this.tracks[0], this.tracks[1]] = [this.tracks[1], this.tracks[0]];
     else {
@@ -4100,31 +4486,33 @@ var Queue = class {
     }
     this.player.manager.emit("queueUpdate" /* QueueUpdate */, this.player, this);
     this.player.manager.emit("debug" /* Debug */, 5 /* Queue */, "[Queue] -> [Shuffle] Shuffled the queue.");
+    await this.utils.save();
     return this;
   }
   /**
    *
    * Clear the queue.
-   * @returns {this} The queue instance.
+   * @returns {Promise<this>} The queue instance.
    * @example
    * ```ts
    * const queue = player.queue;
    *
    * console.log(queue.size); // 0
-   * queue.add(track);
-   * queue.add([track1, track2]);
+   * await queue.add(track);
+   * await queue.add(track1, track2);
    *
    * console.log(queue.size); // 3
-   * queue.clear();
+   * await queue.clear();
    * console.log(queue.size); // 0
    * ```
    */
-  clear() {
+  async clear() {
     this.tracks = [];
     this.history = [];
     this.current = null;
     this.player.manager.emit("queueUpdate" /* QueueUpdate */, this.player, this);
     this.player.manager.emit("debug" /* Debug */, 5 /* Queue */, "[Queue] -> [Clear] Cleared the queue.");
+    await this.utils.save();
     return this;
   }
   /**
@@ -4132,15 +4520,31 @@ var Queue = class {
    * Move a track to a specific position in the queue.
    * @param {Track} track The track to move.
    * @param {number} to The position to move.
-   * @returns {this} The queue instance.
+   * @returns {Promise<this>} The queue instance.
+   * @example
+   * ```ts
+   * const queue = player.queue;
+   * await queue.add(track);
+   * await queue.add(track1);
+   * await queue.add(track2);
+   *
+   * console.log(queue.tracks); // [track, track1, track2]
+   * await queue.move(track1, 0);
+   * console.log(queue.tracks); // [track1, track, track2]
+   * ```
    */
-  move(track, to) {
+  async move(track, to) {
     const index = this.tracks.indexOf(track);
     if (index === -1) return this;
-    this.splice(index, 1);
-    this.add(track, to - 1);
+    await this.splice(index, 1);
+    await this.add(track, to - 1);
     this.player.manager.emit("queueUpdate" /* QueueUpdate */, this.player, this);
-    this.player.manager.emit("debug" /* Debug */, 5 /* Queue */, `[Queue] -> [Move] Moved track ${track.info.title} to position ${to}.`);
+    this.player.manager.emit(
+      "debug" /* Debug */,
+      5 /* Queue */,
+      `[Queue] -> [Move] Moved track ${track.info.title} to position ${to}.`
+    );
+    await this.utils.save();
     return this;
   }
   /**
@@ -4149,23 +4553,42 @@ var Queue = class {
    * @param {number} start The start index.
    * @param {number} deleteCount The number of tracks to delete.
    * @param {Track | Track[]} [tracks] The tracks to add.
-   * @returns {this} The queue instance.
+   * @returns {Promise<this>} The queue instance.
+   * @example
+   * ```ts
+   * const queue = player.queue;
+   * await queue.add(track);
+   * await queue.add(track1);
+   * await queue.add(track2);
+   *
+   * console.log(queue.tracks); // [track, track1, track2]
+   * await queue.splice(1, 1);
+   * console.log(queue.tracks); // [track, track2]
+   * ```
    */
-  splice(start, deleteCount, tracks) {
-    if (!this.size && tracks) this.add(tracks);
+  async splice(start, deleteCount, tracks) {
+    if (!this.size && tracks) await this.add(tracks);
     if (tracks) this.tracks.splice(start, deleteCount, ...Array.isArray(tracks) ? tracks : [tracks]);
     else this.tracks.splice(start, deleteCount);
     this.player.manager.emit("queueUpdate" /* QueueUpdate */, this.player, this);
     this.player.manager.emit("debug" /* Debug */, 5 /* Queue */, `[Queue] -> [Splice] Removed ${deleteCount} tracks from the queue.`);
+    await this.utils.save();
     return this;
   }
   /**
    *
    * Convert the queue to a JSON object.
    * @returns {QueueJson} The queue JSON object.
+   * @example
+   * ```ts
+   * const queue = player.queue;
+   * await queue.add(track);
+   *
+   * console.log(queue.toJSON()); // { tracks: [track], history: [], current: null }
+   * ```
    */
   toJSON() {
-    const max = this.player.manager.options.queueOptions.maxPreviousTracks;
+    const max = this.player.manager.options.queueOptions.maxHistory;
     if (this.history.length > max) this.history.splice(max, this.history.length);
     return {
       tracks: this.tracks,
@@ -4204,7 +4627,7 @@ var Structures = {
 var maxTracks = 10;
 async function autoplayFn(player, lastTrack) {
   if (!lastTrack) return;
-  const isEnabled = !!player.data.get("enabledAutoplay") || player.manager.options.queueOptions.autoPlay;
+  const isEnabled = !!await player.data.get("enabledAutoplay") || player.manager.options.queueOptions.autoPlay;
   if (!isEnabled) return;
   const filter = (tracks) => tracks.filter(
     (track) => !(player.queue.history.some((t) => t.info.identifier === track.info.identifier) || lastTrack.info.identifier === track.info.identifier)
@@ -4245,8 +4668,54 @@ async function autoplayFn(player, lastTrack) {
   }
 }
 
-// src/classes/queue/adapters/memory.ts
-var MemoryAdapter = class extends StorageAdapter {
+// src/classes/storage/PlayerMemory.ts
+var PlayerMemoryStorage = class extends PlayerStorageAdapter {
+  /**
+   * The internal storage.
+   * @type {Map<K, V>}
+   * @private
+   * @readonly
+   * @internal
+   */
+  internal = /* @__PURE__ */ new Map();
+  get(key) {
+    return this.internal.get(this.buildKey(this.namespace, key));
+  }
+  set(key, value) {
+    this.internal.set(this.buildKey(this.namespace, key), value);
+  }
+  has(key) {
+    return this.internal.has(this.buildKey(this.namespace, key));
+  }
+  delete(key) {
+    return this.internal.delete(this.buildKey(this.namespace, key));
+  }
+  keys() {
+    return [...this.internal.keys()];
+  }
+  values() {
+    return [...this.internal.values()];
+  }
+  entries() {
+    return [...this.internal.entries()];
+  }
+  all() {
+    return Object.fromEntries([...this.internal.entries()].filter(([key]) => !key.startsWith("internal_")));
+  }
+  clear() {
+    this.internal.clear();
+  }
+  size() {
+    return this.internal.size;
+  }
+  buildKey(...parts) {
+    const flattern = parts.flat();
+    return flattern.join(":");
+  }
+};
+
+// src/classes/storage/QueueMemory.ts
+var QueueMemoryStorage = class extends QueueStorageAdapter {
   /**
    * Memory storage.
    * @type {Map<string, QueueJson>}
@@ -4259,16 +4728,16 @@ var MemoryAdapter = class extends StorageAdapter {
     return this.parse(this.storage.get(key));
   }
   set(key, value) {
-    this.storage.set(key, this.stringify(value));
+    this.storage.set(this.buildKey(this.namespace, key), this.stringify(value));
   }
   delete(key) {
-    return this.storage.delete(key);
+    return this.storage.delete(this.buildKey(this.namespace, key));
   }
   clear() {
     this.storage.clear();
   }
   has(key) {
-    return this.storage.has(key);
+    return this.storage.has(this.buildKey(this.namespace, key));
   }
   parse(value) {
     return value;
@@ -4276,6 +4745,10 @@ var MemoryAdapter = class extends StorageAdapter {
   stringify(value) {
     return value;
   }
+  buildKey(...parts) {
+    const flattern = parts.flat();
+    return flattern.join(":");
+  }
 };
 
 // src/classes/Hoshimi.ts
@@ -4306,6 +4779,7 @@ var Hoshimi = class extends import_node_events.EventEmitter {
    * The constructor for the manager.
    * @param {HoshimiOptions} options The options for the manager.
    * @throws {ManagerError} If the options are not provided.
+   * @throws {OptionError} If the options are invalid.
    * @example
    * ```ts
    * const manager = new Hoshimi({
@@ -4331,10 +4805,24 @@ var Hoshimi = class extends import_node_events.EventEmitter {
    * 		resumeByLibrary: false,
    * 	},
    * 	queueOptions: {
-   * 		maxPreviousTracks: 25,
-   * 		autoplayFn: autoplayFn,
-   * 		autoPlay: false,
+   *      maxHistory: 25,
+   *      autoplayFn: autoplayFn,
+   *      autoPlay: false,
+   *      storage: new MemoryAdapter(),
+   *      requesterFn: defaultRequesterFn,
    * 	},
+   *   playerOptions: {
+   *    	onDisconnect: {
+   *        autoDestroy: false,
+   *        autoReconnect: false,
+   *        autoQueue: false,
+   *   	},
+   *   	onError: {
+   *        autoDestroy: false,
+   *        autoSkip: false,
+   *        autoStop: false,
+   *      },
+   *   },
    * });
    *
    * console.log(manager); // The manager instance
@@ -4356,10 +4844,24 @@ var Hoshimi = class extends import_node_events.EventEmitter {
         resumeTimeout: options.nodeOptions?.resumeTimeout ?? 1e4
       },
       queueOptions: {
-        maxPreviousTracks: options.queueOptions?.maxPreviousTracks ?? 25,
+        maxHistory: options.queueOptions?.maxHistory ?? 25,
         autoplayFn: options.queueOptions?.autoplayFn ?? autoplayFn,
         autoPlay: options.queueOptions?.autoPlay ?? false,
-        storage: options.queueOptions?.storage ?? new MemoryAdapter()
+        storage: options.queueOptions?.storage ?? new QueueMemoryStorage()
+      },
+      playerOptions: {
+        requesterFn: options.playerOptions?.requesterFn ?? requesterFn,
+        storage: options.playerOptions?.storage ?? new PlayerMemoryStorage(),
+        onDisconnect: {
+          autoDestroy: options.playerOptions?.onDisconnect?.autoDestroy ?? false,
+          autoReconnect: options.playerOptions?.onDisconnect?.autoReconnect ?? false,
+          autoQueue: options.playerOptions?.onDisconnect?.autoQueue ?? false
+        },
+        onError: {
+          autoDestroy: options.playerOptions?.onError?.autoDestroy ?? false,
+          autoSkip: options.playerOptions?.onError?.autoSkip ?? false,
+          autoStop: options.playerOptions?.onError?.autoStop ?? false
+        }
       },
       client: {
         id: options.client?.id ?? "",
@@ -4471,37 +4973,98 @@ var Hoshimi = class extends import_node_events.EventEmitter {
             this.emit("debug" /* Debug */, 3 /* Player */, "[Player] -> [Voice] The guild id is missing.");
             return;
           }
-          if ("user_id" in data && data.user_id !== this.options.client?.id) {
-            this.emit("debug" /* Debug */, 3 /* Player */, "[Player] -> [Voice] The user id does not match the client id.");
-            return;
-          }
           const player = this.getPlayer(data.guild_id);
           if (!player) {
             this.emit("debug" /* Debug */, 3 /* Player */, "[Player] -> [Voice] The player is not found.");
             return;
           }
           if ("session_id" in data) player.voice.sessionId = data.session_id;
-          if ("token" in data) player.voice.token = data.token;
-          if ("endpoint" in data) player.voice.endpoint = data.endpoint;
-          if (player.voice.sessionId && player.voice.token && player.voice.endpoint) {
-            await player.node.updatePlayer({
-              guildId: data.guild_id,
+          if ("token" in data && "endpoint" in data) {
+            if (!player.voice.sessionId) {
+              this.emit(
+                "debug" /* Debug */,
+                3 /* Player */,
+                `[Player] -> [Voice] The session id is missing for: ${data.guild_id}`
+              );
+              return;
+            }
+            await player.updatePlayer({
               playerOptions: {
-                voice: player.voice
+                voice: {
+                  sessionId: player.voice.sessionId,
+                  token: data.token,
+                  endpoint: data.endpoint
+                }
               }
             });
             this.emit(
               "debug" /* Debug */,
               3 /* Player */,
-              `[Player] -> [Voice] Updated the player voice for: ${data.guild_id} | Session: ${player.voice.sessionId} | Token: ${player.voice.token} | Endpoint: ${player.voice.endpoint}`
+              `[Player] -> [Voice] Updated the player voice for: ${data.guild_id} | Session: ${player.voice.sessionId} | Token: ${data.token} | Endpoint: ${data.endpoint}`
             );
             return;
           }
-          this.emit("debug" /* Debug */, 3 /* Player */, `[Player] -> [Voice] The player voice is missing for: ${data.guild_id}`);
+          if (data.user_id !== this.options.client.id) {
+            this.emit("debug" /* Debug */, 3 /* Player */, "[Player] -> [Voice] The user id does not match the client id.");
+            return;
+          }
+          if (data.channel_id !== null) {
+            const voiceId = player.voiceId ?? player.options.voiceId;
+            if (data.channel_id !== voiceId) {
+              this.emit(
+                "debug" /* Debug */,
+                3 /* Player */,
+                `[Player] -> [Voice] Updating the voice channel for: ${data.guild_id} | Old: ${voiceId} | New: ${data.channel_id}`
+              );
+              player.voice.sessionId = data.session_id ?? player.voice.sessionId;
+              player.voiceId = data.channel_id;
+              player.options.voiceId = data.channel_id;
+              if (!player.connected) await player.connect();
+              return;
+            }
+          } else {
+            this.emit(
+              "debug" /* Debug */,
+              3 /* Player */,
+              `[Player] -> [Voice] The channel id is missing for: ${data.guild_id}`
+            );
+            const { autoDestroy, autoReconnect, autoQueue } = this.options.playerOptions.onDisconnect;
+            if (autoDestroy) {
+              await player.destroy("Player-VoiceChannelLeft" /* VoiceChannelLeft */);
+              return;
+            }
+            if (autoReconnect) {
+              try {
+                const position = player.position;
+                const paused = player.paused;
+                this.emit(
+                  "debug" /* Debug */,
+                  3 /* Player */,
+                  `[Player] -> [Voice] Attempting to reconnect the player for: ${data.guild_id}`
+                );
+                if (autoQueue && player.queue.current && !player.queue.isEmpty()) await player.connect();
+                if (player.queue.current) return player.play({ track: player.queue.current, paused, position });
+                if (!player.queue.isEmpty()) return player.play({ paused });
+                this.emit(
+                  "debug" /* Debug */,
+                  3 /* Player */,
+                  `[Player] -> [Voice] No tracks to play after reconnect for: ${data.guild_id}`
+                );
+              } catch (error) {
+                this.emit("playerError" /* PlayerError */, player, error);
+                await player.destroy("Player-ReconnectFailed" /* ReconnectFailed */);
+              }
+            }
+            player.voiceId = void 0;
+            player.voice = {
+              endpoint: null,
+              sessionId: null,
+              token: null
+            };
+            return;
+          }
         }
         break;
-      default:
-        break;
     }
   }
   /**
@@ -4606,6 +5169,7 @@ var Hoshimi = class extends import_node_events.EventEmitter {
       1 /* Manager */,
       `[Manager] -> [Search] Searching for: ${options.query} (${options.engine ?? "unknown"}) | Result: ${stringify(res)}`
     );
+    const requesterFn2 = this.options.playerOptions.requesterFn;
     switch (res.loadType) {
       case "empty" /* Empty */: {
         return {
@@ -4631,7 +5195,7 @@ var Hoshimi = class extends import_node_events.EventEmitter {
           exception: null,
           playlist: res.data,
           pluginInfo: res.data.pluginInfo,
-          tracks: res.data.tracks.map((t) => new Track(t, options.requester))
+          tracks: res.data.tracks.map((t) => new Track(t, requesterFn2(options.requester)))
         };
       }
       case "search" /* Search */: {
@@ -4640,7 +5204,7 @@ var Hoshimi = class extends import_node_events.EventEmitter {
           exception: null,
           playlist: null,
           pluginInfo: null,
-          tracks: res.data.map((t) => new Track(t, options.requester))
+          tracks: res.data.map((t) => new Track(t, requesterFn2(options.requester)))
         };
       }
       case "track" /* Track */: {
@@ -4649,7 +5213,7 @@ var Hoshimi = class extends import_node_events.EventEmitter {
           exception: null,
           playlist: null,
           pluginInfo: res.data.pluginInfo,
-          tracks: [new Track(res.data, options.requester)]
+          tracks: [new Track(res.data, requesterFn2(options.requester))]
         };
       }
     }
@@ -4661,45 +5225,56 @@ function createHoshimi(...args) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AudioOutput,
+  AudioOutputData,
   DSPXPluginFilter,
   DebugLevels,
+  DefaultFilterPreset,
+  DefaultPlayerFilters,
   DestroyReasons,
-  Events,
+  EventNames,
   FilterManager,
   FilterType,
   Hoshimi,
+  HoshimiAgent,
   HttpMethods,
   HttpStatusCodes,
   LavalinkPluginFilter,
   LoadType,
   LoopMode,
   ManagerError,
-  MemoryAdapter,
   Node,
   NodeDestroyReasons,
   NodeError,
+  NodeManagerError,
   NodeSortTypes,
   OpCodes,
   OptionError,
   Player,
   PlayerError,
   PlayerEventType,
+  PlayerMemoryStorage,
+  PlayerStorageAdapter,
   PluginInfoType,
   PluginNames,
   Queue,
+  QueueMemoryStorage,
+  QueueStorageAdapter,
   ResolveError,
   Rest,
   RestPathType,
+  RestRoutes,
   SearchEngines,
   Severity,
   SourceNames,
   State,
-  StorageAdapter,
   StorageError,
   Structures,
   Track,
   TrackEndReason,
   UnresolvedTrack,
+  UrlRegex,
+  ValidEngines,
+  ValidSources,
   WebsocketCloseCodes,
   createHoshimi
 });