lavalink-client 2.9.0 → 2.9.2

package/README.md

@@ -44,7 +44,7 @@
 
 ## 📦 Installation
 
-**Latest Stable Version: `v2.5.x`**
+**Latest Stable Version: `v2.9.x`**
 
 <details>
 <summary><strong>👉 via NPM</strong></summary>
@@ -359,6 +359,7 @@ This client powers various Discord bots:
     - [All Time Bot](https://top.gg/bot/1163027457671180418) (@PeterGamez)
     - [BeatDock](https://github.com/lazaroagomez/BeatDock) (@lazaroagomez)
     - [Nazha](https://top.gg/bot/1124681788070055967) (@Nazha-Team)
+    - [Arii Music](https://arimusic.me/) (@friston_ae)
 
 ---
 

package/dist/index.d.mts

@@ -417,7 +417,19 @@ declare function parseLavalinkConnUrl(connectionUrl: string): {
 declare class ManagerUtils {
     LavalinkManager: LavalinkManager | undefined;
     constructor(LavalinkManager?: LavalinkManager);
+    /**
+     * Builds a pluginInfo object based on the provided data, extracting relevant information from the data and clientData parameters. This function is used to construct the pluginInfo property for tracks, allowing for consistent handling of plugin-related information across different track sources and formats.
+     * @param data
+     * @param clientData
+     * @returns
+     */
     buildPluginInfo(data: any, clientData?: any): any;
+    /**
+     * Builds a Track object from the provided data and requester information. It validates the presence of required properties in the data, transforms the requester using a custom transformer function if provided, and constructs a Track object with the appropriate properties and plugin information. The function also includes error handling to ensure that the input data is valid and provides debug information if track building fails.
+     * @param data
+     * @param requester
+     * @returns
+     */
     buildTrack(data: LavalinkTrack | Track, requester: unknown): Track;
     /**
      * Builds a UnresolvedTrack to be resolved before being played  .
@@ -430,6 +442,11 @@ declare class ManagerUtils {
      * @param data
      */
     isNode(data: LavalinkNode): boolean;
+    /**
+     * Gets the transformed requester based on the LavalinkManager options. If a custom requester transformer function is provided in the player options, it applies that function to the requester; otherwise, it returns the requester as is. The function also includes error handling to catch any exceptions that may occur during the transformation process and emits a debug event if the transformation fails.
+     * @param requester
+     * @returns
+     */
     getTransformedRequester(requester: unknown): unknown;
     /**
      * Validate if a data is equal to node options
@@ -470,18 +487,73 @@ declare class ManagerUtils {
      * @param track
      */
     isUnresolvedTrackQuery(data: UnresolvedQuery): boolean;
+    /**
+     * Gets the closest track by resolving the provided UnresolvedTrack using the getClosestTrack function. It includes error handling to catch any exceptions that may occur during the resolution process and emits a debug event if the resolution fails. The function returns a Promise that resolves to a Track object if successful, or undefined if no closest track is found.
+     * @param data
+     * @param player
+     * @returns
+     */
     getClosestTrack(data: UnresolvedTrack, player: Player): Promise<Track | undefined>;
-    validateQueryString(node: LavalinkNode, queryString: string, sourceString?: LavalinkSearchPlatform): void;
+    /**
+     * Validates the query string against various criteria, including checking for empty strings, length limits for specific sources, blacklisted links or words, and ensuring that the Lavalink node has the necessary source managers enabled for the provided query. The function also includes debug event emissions to assist with troubleshooting and understanding the validation process.
+     * @param node
+     * @param queryString
+     * @param sourceString
+     * @returns
+     */
+    validateQueryString(node: LavalinkNode, queryString: string, sourceString?: SearchPlatform): void;
+    /**
+     * Finds the source of a query string by checking if it starts with a valid source prefix defined in the DefaultSources object. If a valid source prefix is found, it returns the corresponding SearchPlatform; otherwise, it returns null. This function is useful for determining the intended search platform for a given query string, allowing for more accurate search results when the user specifies a source (e.g., "ytsearch:Never Gonna Give You Up" would indicate that the search should be performed on YouTube).
+     * @param queryString
+     * @returns
+     */
+    findSourceOfQuery(queryString: string): SearchPlatform;
+    /**
+     * Extracts the source from the query if it starts with a valid source prefix (e.g., "ytsearch:") and updates the searchQuery object accordingly.
+     * @param searchQuery
+     * @returns The updated searchQuery object with the extracted source and modified query string.
+     */
+    extractSourceOfQuery<T extends {
+        query: string;
+        source?: string;
+    }>(searchQuery: T): T;
+    /**
+     * Converts a string to lowercase if the input is a string, otherwise returns the input as is. This is useful for ensuring that search platform identifiers are case-insensitive while allowing other types of input to pass through unchanged.
+     * @param input
+     * @returns
+     */
+    typedLowerCase<T extends unknown>(input: T): T;
+    /**
+     * Transforms a search query by determining the appropriate search platform based on the query string and the default search platform specified in the LavalinkManager options. It checks if the query string starts with a valid source prefix and extracts it if present. The function returns an object containing the modified query string, any extra URL parameters, and the determined search platform to be used for the search operation.
+     * @param query
+     * @returns
+     */
     transformQuery(query: SearchQuery): {
         query: string;
-        extraQueryUrlParams: URLSearchParams;
-        source: any;
+        extraQueryUrlParams: any;
+        source: SearchPlatform;
     };
+    /**
+     * Transforms a LavaSearchQuery by determining the appropriate search platform based on the query string and the default search platform specified in the LavalinkManager options. It checks if the query string starts with a valid source prefix and extracts it if present. The function returns an object containing the modified query string, any extra URL parameters, the determined search platform to be used for the search operation, and the types of search (track, playlist, artist, album, text) to be performed.
+     * @param query
+     * @returns
+     */
     transformLavaSearchQuery(query: LavaSearchQuery): {
+        query: never;
+        types: any[];
+        extraQueryUrlParams: any;
+        source: SearchPlatform;
+    } | {
         query: string;
         types: string[];
-        source: any;
+        source: "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec" | "tdsearch" | "tdrec" | "qbsearch" | "qbisrc" | "qbrec" | "pdsearch" | "pdisrc" | "pdrec" | "ftts" | "speak" | "phsearch" | "pornhub" | "porn" | "tts" | "jssearch" | "jsrec" | "local" | "http" | "https" | "link" | "uri" | "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "vk" | "vk music" | "vkmusic" | "tidal" | "tidal music" | "qobuz" | "pandora" | "pd" | "pandora music" | "pandoramusic" | "flowerytts" | "flowery" | "flowery.tts" | "bandcamp" | "bc" | "js" | "jiosaavn" | "td";
     };
+    /**
+     * Validates the provided source string against the capabilities of the Lavalink node. It checks if the source string is supported by the node's enabled source managers and plugins, throwing errors if any required sources or plugins are missing for the specified search platform. This ensures that search queries are only executed with compatible sources based on the node's configuration.
+     * @param node
+     * @param sourceString
+     * @returns
+     */
     validateSourceString(node: LavalinkNode, sourceString: SearchPlatform): void;
 }
 /**
@@ -2627,6 +2699,14 @@ declare class Player {
      * @param options
      */
     play(options?: Partial<PlayOptions>): any;
+    /**
+     * The old JSON of the player, used for the "playerClientUpdate" event, which is emitted on every update of the player via a function call, so that you can compare the old data with the new data and do something with it if you want to.
+     */
+    oldJSON: PlayerJson;
+    /**
+     * Emits the "playerClientUpdate" event, which is emitted on every update of the player via a function call, so that you can compare the old data with the new data and do something with it if you want to.
+     */
+    triggerPlayerClientUpdate(): void;
     /**
      * Set the Volume for the Player
      * @param volume The Volume in percent
@@ -3721,6 +3801,20 @@ interface LavalinkManagerEvents<CustomPlayerT extends Player = Player> {
      * @event Manager#playerUpdate
      */
     playerUpdate: (oldPlayerJson: PlayerJson, newPlayer: CustomPlayerT) => void;
+    /**
+     * Always emits when the player (on client side) got updated via a function-call.
+     * This is useful for example, if you want to save the player data on every update, or similar.
+     * @event Manager#playerClientUpdate
+     *
+     * Emits only when you call one of those functions:
+     * player.pause()
+     * player.resume()
+     * player.seek()
+     * player.setRepeatMode()
+     * player.setVolume()
+     * and on every call of the filterManager.
+     */
+    playerClientUpdate: (oldPlayerJson: PlayerJson, newPlayer: CustomPlayerT) => void;
     /**
      * Emitted when the player's selfMuted or serverMuted state changed (true -> false | false -> true)
      * @event Manager#playerMuteChange
@@ -3842,6 +3936,8 @@ interface ManagerPlayerOptions<CustomPlayerT extends Player = Player> {
     clientBasedPositionUpdateInterval?: number;
     /** What should be used as a searchPlatform, if no source was provided during the query */
     defaultSearchPlatform?: SearchPlatform;
+    /** Allow custom sources which lavalink-client does not support (yet) */
+    allowCustomSources?: boolean;
     /** Applies the volume via a filter, not via the lavalink volume transformer */
     applyVolumeAsFilter?: boolean;
     /** Transforms the saved data of a requested user */
@@ -3870,6 +3966,14 @@ interface ManagerPlayerOptions<CustomPlayerT extends Player = Player> {
         destroyAfterMs?: number;
     };
     useUnresolvedData?: boolean;
+    /**
+     * If true (default), when changing nodes, `setSponsorBlock()` with default categories is called
+     * even if the user never explicitly set categories. This is needed so the SponsorBlock plugin
+     * registers its event listeners (ChapterStarted/ChapterLoaded) on the new node.
+     * Set to false to disable this behavior if you don't use SponsorBlock events.
+     * @default true
+     */
+    enforceSponsorBlockRequestForEventEnablement?: boolean;
 }
 type DeepRequired<T> = {
     [K in keyof T]-?: NonNullable<T[K]> extends object ? DeepRequired<NonNullable<T[K]>> : NonNullable<T[K]>;
@@ -4016,6 +4120,7 @@ declare class LavalinkManager<CustomPlayerT extends Player = Player> extends Eve
      *       applyVolumeAsFilter: false,
      *       clientBasedPositionUpdateInterval: 150,
      *       defaultSearchPlatform: "ytmsearch",
+     *       allowCustomSources: false,
      *       volumeDecrementer: 0.75,
      *       //requesterTransformer: YourRequesterTransformerFunction,
      *       onDisconnect: {

package/dist/index.d.ts

@@ -417,7 +417,19 @@ declare function parseLavalinkConnUrl(connectionUrl: string): {
 declare class ManagerUtils {
     LavalinkManager: LavalinkManager | undefined;
     constructor(LavalinkManager?: LavalinkManager);
+    /**
+     * Builds a pluginInfo object based on the provided data, extracting relevant information from the data and clientData parameters. This function is used to construct the pluginInfo property for tracks, allowing for consistent handling of plugin-related information across different track sources and formats.
+     * @param data
+     * @param clientData
+     * @returns
+     */
     buildPluginInfo(data: any, clientData?: any): any;
+    /**
+     * Builds a Track object from the provided data and requester information. It validates the presence of required properties in the data, transforms the requester using a custom transformer function if provided, and constructs a Track object with the appropriate properties and plugin information. The function also includes error handling to ensure that the input data is valid and provides debug information if track building fails.
+     * @param data
+     * @param requester
+     * @returns
+     */
     buildTrack(data: LavalinkTrack | Track, requester: unknown): Track;
     /**
      * Builds a UnresolvedTrack to be resolved before being played  .
@@ -430,6 +442,11 @@ declare class ManagerUtils {
      * @param data
      */
     isNode(data: LavalinkNode): boolean;
+    /**
+     * Gets the transformed requester based on the LavalinkManager options. If a custom requester transformer function is provided in the player options, it applies that function to the requester; otherwise, it returns the requester as is. The function also includes error handling to catch any exceptions that may occur during the transformation process and emits a debug event if the transformation fails.
+     * @param requester
+     * @returns
+     */
     getTransformedRequester(requester: unknown): unknown;
     /**
      * Validate if a data is equal to node options
@@ -470,18 +487,73 @@ declare class ManagerUtils {
      * @param track
      */
     isUnresolvedTrackQuery(data: UnresolvedQuery): boolean;
+    /**
+     * Gets the closest track by resolving the provided UnresolvedTrack using the getClosestTrack function. It includes error handling to catch any exceptions that may occur during the resolution process and emits a debug event if the resolution fails. The function returns a Promise that resolves to a Track object if successful, or undefined if no closest track is found.
+     * @param data
+     * @param player
+     * @returns
+     */
     getClosestTrack(data: UnresolvedTrack, player: Player): Promise<Track | undefined>;
-    validateQueryString(node: LavalinkNode, queryString: string, sourceString?: LavalinkSearchPlatform): void;
+    /**
+     * Validates the query string against various criteria, including checking for empty strings, length limits for specific sources, blacklisted links or words, and ensuring that the Lavalink node has the necessary source managers enabled for the provided query. The function also includes debug event emissions to assist with troubleshooting and understanding the validation process.
+     * @param node
+     * @param queryString
+     * @param sourceString
+     * @returns
+     */
+    validateQueryString(node: LavalinkNode, queryString: string, sourceString?: SearchPlatform): void;
+    /**
+     * Finds the source of a query string by checking if it starts with a valid source prefix defined in the DefaultSources object. If a valid source prefix is found, it returns the corresponding SearchPlatform; otherwise, it returns null. This function is useful for determining the intended search platform for a given query string, allowing for more accurate search results when the user specifies a source (e.g., "ytsearch:Never Gonna Give You Up" would indicate that the search should be performed on YouTube).
+     * @param queryString
+     * @returns
+     */
+    findSourceOfQuery(queryString: string): SearchPlatform;
+    /**
+     * Extracts the source from the query if it starts with a valid source prefix (e.g., "ytsearch:") and updates the searchQuery object accordingly.
+     * @param searchQuery
+     * @returns The updated searchQuery object with the extracted source and modified query string.
+     */
+    extractSourceOfQuery<T extends {
+        query: string;
+        source?: string;
+    }>(searchQuery: T): T;
+    /**
+     * Converts a string to lowercase if the input is a string, otherwise returns the input as is. This is useful for ensuring that search platform identifiers are case-insensitive while allowing other types of input to pass through unchanged.
+     * @param input
+     * @returns
+     */
+    typedLowerCase<T extends unknown>(input: T): T;
+    /**
+     * Transforms a search query by determining the appropriate search platform based on the query string and the default search platform specified in the LavalinkManager options. It checks if the query string starts with a valid source prefix and extracts it if present. The function returns an object containing the modified query string, any extra URL parameters, and the determined search platform to be used for the search operation.
+     * @param query
+     * @returns
+     */
     transformQuery(query: SearchQuery): {
         query: string;
-        extraQueryUrlParams: URLSearchParams;
-        source: any;
+        extraQueryUrlParams: any;
+        source: SearchPlatform;
     };
+    /**
+     * Transforms a LavaSearchQuery by determining the appropriate search platform based on the query string and the default search platform specified in the LavalinkManager options. It checks if the query string starts with a valid source prefix and extracts it if present. The function returns an object containing the modified query string, any extra URL parameters, the determined search platform to be used for the search operation, and the types of search (track, playlist, artist, album, text) to be performed.
+     * @param query
+     * @returns
+     */
     transformLavaSearchQuery(query: LavaSearchQuery): {
+        query: never;
+        types: any[];
+        extraQueryUrlParams: any;
+        source: SearchPlatform;
+    } | {
         query: string;
         types: string[];
-        source: any;
+        source: "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec" | "tdsearch" | "tdrec" | "qbsearch" | "qbisrc" | "qbrec" | "pdsearch" | "pdisrc" | "pdrec" | "ftts" | "speak" | "phsearch" | "pornhub" | "porn" | "tts" | "jssearch" | "jsrec" | "local" | "http" | "https" | "link" | "uri" | "youtube" | "yt" | "youtube music" | "youtubemusic" | "ytm" | "musicyoutube" | "music youtube" | "soundcloud" | "sc" | "am" | "apple music" | "applemusic" | "apple" | "musicapple" | "music apple" | "sp" | "spsuggestion" | "spotify" | "spotify.com" | "spotifycom" | "dz" | "deezer" | "yandex" | "yandex music" | "yandexmusic" | "vk" | "vk music" | "vkmusic" | "tidal" | "tidal music" | "qobuz" | "pandora" | "pd" | "pandora music" | "pandoramusic" | "flowerytts" | "flowery" | "flowery.tts" | "bandcamp" | "bc" | "js" | "jiosaavn" | "td";
     };
+    /**
+     * Validates the provided source string against the capabilities of the Lavalink node. It checks if the source string is supported by the node's enabled source managers and plugins, throwing errors if any required sources or plugins are missing for the specified search platform. This ensures that search queries are only executed with compatible sources based on the node's configuration.
+     * @param node
+     * @param sourceString
+     * @returns
+     */
     validateSourceString(node: LavalinkNode, sourceString: SearchPlatform): void;
 }
 /**
@@ -2627,6 +2699,14 @@ declare class Player {
      * @param options
      */
     play(options?: Partial<PlayOptions>): any;
+    /**
+     * The old JSON of the player, used for the "playerClientUpdate" event, which is emitted on every update of the player via a function call, so that you can compare the old data with the new data and do something with it if you want to.
+     */
+    oldJSON: PlayerJson;
+    /**
+     * Emits the "playerClientUpdate" event, which is emitted on every update of the player via a function call, so that you can compare the old data with the new data and do something with it if you want to.
+     */
+    triggerPlayerClientUpdate(): void;
     /**
      * Set the Volume for the Player
      * @param volume The Volume in percent
@@ -3721,6 +3801,20 @@ interface LavalinkManagerEvents<CustomPlayerT extends Player = Player> {
      * @event Manager#playerUpdate
      */
     playerUpdate: (oldPlayerJson: PlayerJson, newPlayer: CustomPlayerT) => void;
+    /**
+     * Always emits when the player (on client side) got updated via a function-call.
+     * This is useful for example, if you want to save the player data on every update, or similar.
+     * @event Manager#playerClientUpdate
+     *
+     * Emits only when you call one of those functions:
+     * player.pause()
+     * player.resume()
+     * player.seek()
+     * player.setRepeatMode()
+     * player.setVolume()
+     * and on every call of the filterManager.
+     */
+    playerClientUpdate: (oldPlayerJson: PlayerJson, newPlayer: CustomPlayerT) => void;
     /**
      * Emitted when the player's selfMuted or serverMuted state changed (true -> false | false -> true)
      * @event Manager#playerMuteChange
@@ -3842,6 +3936,8 @@ interface ManagerPlayerOptions<CustomPlayerT extends Player = Player> {
     clientBasedPositionUpdateInterval?: number;
     /** What should be used as a searchPlatform, if no source was provided during the query */
     defaultSearchPlatform?: SearchPlatform;
+    /** Allow custom sources which lavalink-client does not support (yet) */
+    allowCustomSources?: boolean;
     /** Applies the volume via a filter, not via the lavalink volume transformer */
     applyVolumeAsFilter?: boolean;
     /** Transforms the saved data of a requested user */
@@ -3870,6 +3966,14 @@ interface ManagerPlayerOptions<CustomPlayerT extends Player = Player> {
         destroyAfterMs?: number;
     };
     useUnresolvedData?: boolean;
+    /**
+     * If true (default), when changing nodes, `setSponsorBlock()` with default categories is called
+     * even if the user never explicitly set categories. This is needed so the SponsorBlock plugin
+     * registers its event listeners (ChapterStarted/ChapterLoaded) on the new node.
+     * Set to false to disable this behavior if you don't use SponsorBlock events.
+     * @default true
+     */
+    enforceSponsorBlockRequestForEventEnablement?: boolean;
 }
 type DeepRequired<T> = {
     [K in keyof T]-?: NonNullable<T[K]> extends object ? DeepRequired<NonNullable<T[K]>> : NonNullable<T[K]>;
@@ -4016,6 +4120,7 @@ declare class LavalinkManager<CustomPlayerT extends Player = Player> extends Eve
      *       applyVolumeAsFilter: false,
      *       clientBasedPositionUpdateInterval: 150,
      *       defaultSearchPlatform: "ytmsearch",
+     *       allowCustomSources: false,
      *       volumeDecrementer: 0.75,
      *       //requesterTransformer: YourRequesterTransformerFunction,
      *       onDisconnect: {

package/dist/index.js

@@ -604,12 +604,24 @@ var ManagerUtils = class {
   constructor(LavalinkManager2) {
     this.LavalinkManager = LavalinkManager2;
   }
+  /**
+   * Builds a pluginInfo object based on the provided data, extracting relevant information from the data and clientData parameters. This function is used to construct the pluginInfo property for tracks, allowing for consistent handling of plugin-related information across different track sources and formats.
+   * @param data
+   * @param clientData
+   * @returns
+   */
   buildPluginInfo(data, clientData = {}) {
     return {
       clientData,
       ...data.pluginInfo || data.plugin
     };
   }
+  /**
+   * Builds a Track object from the provided data and requester information. It validates the presence of required properties in the data, transforms the requester using a custom transformer function if provided, and constructs a Track object with the appropriate properties and plugin information. The function also includes error handling to ensure that the input data is valid and provides debug information if track building fails.
+   * @param data
+   * @param requester
+   * @returns
+   */
   buildTrack(data, requester) {
     if (!data?.encoded || typeof data.encoded !== "string")
       throw new RangeError("Argument 'data.encoded' must be present.");
@@ -707,6 +719,11 @@ var ManagerUtils = class {
       return false;
     return true;
   }
+  /**
+   * Gets the transformed requester based on the LavalinkManager options. If a custom requester transformer function is provided in the player options, it applies that function to the requester; otherwise, it returns the requester as is. The function also includes error handling to catch any exceptions that may occur during the transformation process and emits a debug event if the transformation fails.
+   * @param requester
+   * @returns
+   */
   getTransformedRequester(requester) {
     try {
       return typeof this.LavalinkManager?.options?.playerOptions?.requesterTransformer === "function" ? this.LavalinkManager?.options?.playerOptions?.requesterTransformer(requester) : requester;
@@ -795,6 +812,12 @@ var ManagerUtils = class {
   isUnresolvedTrackQuery(data) {
     return typeof data === "object" && !("info" in data) && typeof data.title === "string";
   }
+  /**
+   * Gets the closest track by resolving the provided UnresolvedTrack using the getClosestTrack function. It includes error handling to catch any exceptions that may occur during the resolution process and emits a debug event if the resolution fails. The function returns a Promise that resolves to a Track object if successful, or undefined if no closest track is found.
+   * @param data
+   * @param player
+   * @returns
+   */
   async getClosestTrack(data, player) {
     try {
       return getClosestTrack(data, player);
@@ -810,6 +833,13 @@ var ManagerUtils = class {
       throw e;
     }
   }
+  /**
+   * Validates the query string against various criteria, including checking for empty strings, length limits for specific sources, blacklisted links or words, and ensuring that the Lavalink node has the necessary source managers enabled for the provided query. The function also includes debug event emissions to assist with troubleshooting and understanding the validation process.
+   * @param node
+   * @param queryString
+   * @param sourceString
+   * @returns
+   */
   validateQueryString(node, queryString, sourceString) {
     if (!node.info) throw new Error("No Lavalink Node was provided");
     if (node._checkForSources && !node.info.sourceManagers?.length)
@@ -897,24 +927,84 @@ var ManagerUtils = class {
     }
     return;
   }
-  transformQuery(query) {
-    const sourceOfQuery = typeof query === "string" ? void 0 : DefaultSources[query.source?.trim?.()?.toLowerCase?.() ?? this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform?.toLowerCase?.()] ?? query.source?.trim?.()?.toLowerCase?.();
-    const Query = {
-      query: typeof query === "string" ? query : query.query,
-      extraQueryUrlParams: typeof query !== "string" ? query.extraQueryUrlParams : void 0,
-      source: sourceOfQuery ?? this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform?.toLowerCase?.()
-    };
-    const foundSource = Object.keys(DefaultSources).find((source) => Query.query?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
+  /**
+   * Finds the source of a query string by checking if it starts with a valid source prefix defined in the DefaultSources object. If a valid source prefix is found, it returns the corresponding SearchPlatform; otherwise, it returns null. This function is useful for determining the intended search platform for a given query string, allowing for more accurate search results when the user specifies a source (e.g., "ytsearch:Never Gonna Give You Up" would indicate that the search should be performed on YouTube).
+   * @param queryString
+   * @returns
+   */
+  findSourceOfQuery(queryString) {
+    const foundSource = Object.keys(DefaultSources).find((source) => queryString?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
     if (foundSource && !["https", "http"].includes(foundSource) && DefaultSources[foundSource]) {
-      Query.source = DefaultSources[foundSource];
-      Query.query = Query.query.slice(`${foundSource}:`.length, Query.query.length);
+      return foundSource;
+    }
+    return null;
+  }
+  /**
+   * Extracts the source from the query if it starts with a valid source prefix (e.g., "ytsearch:") and updates the searchQuery object accordingly.
+   * @param searchQuery
+   * @returns The updated searchQuery object with the extracted source and modified query string.
+   */
+  extractSourceOfQuery(searchQuery) {
+    const foundSource = this.findSourceOfQuery(searchQuery.query);
+    if (foundSource) {
+      searchQuery.source = DefaultSources[foundSource];
+      searchQuery.query = searchQuery.query.slice(`${foundSource}:`.length, searchQuery.query.length);
     }
-    return Query;
+    return searchQuery;
+  }
+  /**
+   * Converts a string to lowercase if the input is a string, otherwise returns the input as is. This is useful for ensuring that search platform identifiers are case-insensitive while allowing other types of input to pass through unchanged.
+   * @param input
+   * @returns
+   */
+  typedLowerCase(input) {
+    if (!input) return input;
+    if (typeof input === "string") return input.toLowerCase();
+    return input;
   }
+  /**
+   * Transforms a search query by determining the appropriate search platform based on the query string and the default search platform specified in the LavalinkManager options. It checks if the query string starts with a valid source prefix and extracts it if present. The function returns an object containing the modified query string, any extra URL parameters, and the determined search platform to be used for the search operation.
+   * @param query
+   * @returns
+   */
+  transformQuery(query) {
+    const typedDefault = this.typedLowerCase(this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform);
+    if (typeof query === "string") {
+      const Query = {
+        query,
+        extraQueryUrlParams: void 0,
+        source: typedDefault
+      };
+      return this.extractSourceOfQuery(Query);
+    }
+    const providedSource = query?.source?.trim?.()?.toLowerCase?.();
+    const validSourceExtracted = DefaultSources[providedSource ?? typedDefault];
+    return this.extractSourceOfQuery({
+      query: query.query,
+      extraQueryUrlParams: query.extraQueryUrlParams,
+      source: validSourceExtracted ?? providedSource ?? typedDefault
+    });
+  }
+  /**
+   * Transforms a LavaSearchQuery by determining the appropriate search platform based on the query string and the default search platform specified in the LavalinkManager options. It checks if the query string starts with a valid source prefix and extracts it if present. The function returns an object containing the modified query string, any extra URL parameters, the determined search platform to be used for the search operation, and the types of search (track, playlist, artist, album, text) to be performed.
+   * @param query
+   * @returns
+   */
   transformLavaSearchQuery(query) {
-    const sourceOfQuery = typeof query === "string" ? void 0 : DefaultSources[query.source?.trim?.()?.toLowerCase?.() ?? this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform?.toLowerCase?.()] ?? query.source?.trim?.()?.toLowerCase?.();
+    const typedDefault = this.typedLowerCase(this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform);
+    if (typeof query === "string") {
+      const Query2 = {
+        query,
+        types: [],
+        extraQueryUrlParams: void 0,
+        source: typedDefault
+      };
+      return this.extractSourceOfQuery(Query2);
+    }
+    const providedSource = query?.source?.trim?.()?.toLowerCase?.();
+    const validSourceExtracted = DefaultSources[providedSource ?? typedDefault];
     const Query = {
-      query: typeof query === "string" ? query : query.query,
+      query: query.query,
       types: query.types ? ["track", "playlist", "artist", "album", "text"].filter(
         (v) => query.types?.find((x) => x.toLowerCase().startsWith(v))
       ) : [
@@ -924,19 +1014,23 @@ var ManagerUtils = class {
         "album"
         /*"text"*/
       ],
-      source: sourceOfQuery ?? this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform?.toLowerCase?.()
+      source: validSourceExtracted ?? providedSource ?? typedDefault
     };
-    const foundSource = Object.keys(DefaultSources).find((source) => Query.query.toLowerCase().startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
-    if (foundSource && DefaultSources[foundSource]) {
-      Query.source = DefaultSources[foundSource];
-      Query.query = Query.query.slice(`${foundSource}:`.length, Query.query.length);
-    }
-    return Query;
+    return this.extractSourceOfQuery(Query);
   }
+  /**
+   * Validates the provided source string against the capabilities of the Lavalink node. It checks if the source string is supported by the node's enabled source managers and plugins, throwing errors if any required sources or plugins are missing for the specified search platform. This ensures that search queries are only executed with compatible sources based on the node's configuration.
+   * @param node
+   * @param sourceString
+   * @returns
+   */
   validateSourceString(node, sourceString) {
     if (!sourceString) throw new Error(`No SourceString was provided`);
     const source = DefaultSources[sourceString.toLowerCase().trim()];
-    if (!source) throw new Error(`Lavalink Node SearchQuerySource: '${sourceString}' is not available`);
+    if (!source && !!this.LavalinkManager.options.playerOptions.allowCustomSources)
+      throw new Error(
+        `Lavalink-Client does not support SearchQuerySource: '${sourceString}'. You can disable this check by setting 'ManagerOptions.PlayerOptions.allowCustomSources' to true`
+      );
     if (!node.info) throw new Error("Lavalink Node does not have any info cached yet, not ready yet!");
     if (!node._checkForSources) return;
     if (source === "amsearch" && !node.info?.sourceManagers?.includes("applemusic")) {
@@ -2487,12 +2581,13 @@ var LavalinkNode = class _LavalinkNode {
     if (!error) return;
     this.NodeManager.emit("error", this, error);
     this.reconnectionState = "IDLE" /* IDLE */;
-    this.reconnect();
     if (this.options.closeOnError) {
       if (this.heartBeatInterval) clearInterval(this.heartBeatInterval);
       if (this.pingTimeout) clearTimeout(this.pingTimeout);
       this.socket?.close(500, "Node-Error - Force Reconnect");
+      return;
     }
+    this.reconnect();
   }
   /** @private util function for handling message events from websocket */
   async message(d) {
@@ -2716,7 +2811,7 @@ var LavalinkNode = class _LavalinkNode {
         (v) => Date.now() - v < this._LManager.options.playerOptions.maxErrorsPerTime?.threshold
       );
       player.set("internal_erroredTracksTimestamps", [...oldTimestamps, Date.now()]);
-      if (oldTimestamps.length > this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount) {
+      if (oldTimestamps.length >= this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount) {
         this._emitDebugEvent("TrackStuckMaxTracksErroredPerTime" /* TrackStuckMaxTracksErroredPerTime */, {
           state: "log",
           message: `trackStuck Event was triggered too often within a given threshold (LavalinkManager.options.playerOptions.maxErrorsPerTime). Threshold: "${this._LManager.options.playerOptions.maxErrorsPerTime?.threshold}ms", maxAmount: "${this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount}"`,
@@ -2754,7 +2849,7 @@ var LavalinkNode = class _LavalinkNode {
         (v) => Date.now() - v < this._LManager.options.playerOptions.maxErrorsPerTime?.threshold
       );
       player.set("internal_erroredTracksTimestamps", [...oldTimestamps, Date.now()]);
-      if (oldTimestamps.length > this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount) {
+      if (oldTimestamps.length >= this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount) {
         this._emitDebugEvent("TrackErrorMaxTracksErroredPerTime" /* TrackErrorMaxTracksErroredPerTime */, {
           state: "log",
           message: `TrackError Event was triggered too often within a given threshold (LavalinkManager.options.playerOptions.maxErrorsPerTime). Threshold: "${this._LManager.options.playerOptions.maxErrorsPerTime?.threshold}ms", maxAmount: "${this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount}"`,
@@ -3814,6 +3909,7 @@ var FilterManager = class {
     }
     const now = performance.now();
     if (this.player.options.instaUpdateFiltersFix === true) this.filterUpdatedState = true;
+    this.player.triggerPlayerClientUpdate();
     await this.player.node.updatePlayer({
       guildId: this.player.guildId,
       playerOptions: {
@@ -3908,7 +4004,7 @@ var FilterManager = class {
     this.filters.tremolo = false;
     this.filters.vibrato = false;
     this.filters.karaoke = false;
-    this.filters.karaoke = false;
+    this.filters.vaporwave = false;
     this.filters.volume = false;
     this.filters.nodeLinkEcho = false;
     this.filters.nodeLinkChorus = false;
@@ -3989,7 +4085,7 @@ var FilterManager = class {
     this.data = this.data ?? {};
     this.filters.nightcore = false;
     this.filters.vaporwave = false;
-    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, speed };
+    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, ...this.data.timescale, speed };
     this.isCustomFilterActive();
     await this.applyPlayerFilters();
     return this;
@@ -4011,7 +4107,7 @@ var FilterManager = class {
     this.data = this.data ?? {};
     this.filters.nightcore = false;
     this.filters.vaporwave = false;
-    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, pitch };
+    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, ...this.data.timescale, pitch };
     this.isCustomFilterActive();
     await this.applyPlayerFilters();
     return this;
@@ -4033,7 +4129,7 @@ var FilterManager = class {
     this.data = this.data ?? {};
     this.filters.nightcore = false;
     this.filters.vaporwave = false;
-    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, rate };
+    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, ...this.data.timescale, rate };
     this.isCustomFilterActive();
     await this.applyPlayerFilters();
     return this;
@@ -4462,6 +4558,7 @@ var FilterManager = class {
     if (!this.player.node.sessionId) throw new Error("The Lavalink-Node is either not ready or not up to date");
     const now = performance.now();
     if (this.player.options.instaUpdateFiltersFix === true) this.filterUpdatedState = true;
+    this.player.triggerPlayerClientUpdate();
     await this.player.node.updatePlayer({
       guildId: this.player.guildId,
       playerOptions: {
@@ -4618,7 +4715,7 @@ var Queue = class {
    * @param queueOptions
    */
   constructor(guildId, data = {}, QueueSaver2, queueOptions) {
-    this.queueChanges = queueOptions.queueChangesWatcher || null;
+    this.queueChanges = queueOptions?.queueChangesWatcher || null;
     this.guildId = guildId;
     this.QueueSaver = QueueSaver2;
     this.options.maxPreviousTracks = this.QueueSaver?.options?.maxPreviousTracks ?? this.options.maxPreviousTracks;
@@ -4669,7 +4766,7 @@ var Queue = class {
       ))
         this.previous.splice(
           0,
-          override ? this.tracks.length : 0,
+          override ? this.previous.length : 0,
           ...data.previous.filter(
             (track) => this.managerUtils.isTrack(track) || this.managerUtils.isUnresolvedTrack(track)
           )
@@ -4684,8 +4781,8 @@ var Queue = class {
      * @returns {{current:Track|null, previous:Track[], tracks:Track[]}}The Queue, but in a raw State, which allows easier handling for the QueueStoreManager
      */
     toJSON: () => {
-      if (this.previous.length > this.options.maxPreviousTracks)
-        this.previous.splice(this.options.maxPreviousTracks, this.previous.length);
+      if (this.previous?.length > this.options?.maxPreviousTracks)
+        this.previous?.splice(this.options?.maxPreviousTracks, this.previous.length);
       return {
         current: this.current ? { ...this.current } : null,
         previous: this.previous ? [...this.previous] : [],
@@ -5501,6 +5598,17 @@ var Player = class {
     this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     return this;
   }
+  /**
+   * The old JSON of the player, used for the "playerClientUpdate" event, which is emitted on every update of the player via a function call, so that you can compare the old data with the new data and do something with it if you want to.
+   */
+  oldJSON = this.toJSON();
+  /**
+   * Emits the "playerClientUpdate" event, which is emitted on every update of the player via a function call, so that you can compare the old data with the new data and do something with it if you want to.
+   */
+  triggerPlayerClientUpdate() {
+    this.LavalinkManager.emit("playerClientUpdate", this.oldJSON, this);
+    this.oldJSON = this.toJSON();
+  }
   /**
    * Set the Volume for the Player
    * @param volume The Volume in percent
@@ -5521,6 +5629,7 @@ var Player = class {
         0
       )
     );
+    this.triggerPlayerClientUpdate();
     const now = performance.now();
     if (this.LavalinkManager.options.playerOptions.applyVolumeAsFilter) {
       this._emitDebugEvent("PlayerVolumeAsFilter" /* PlayerVolumeAsFilter */, {
@@ -5595,6 +5704,7 @@ var Player = class {
     this.paused = true;
     this.lastPositionChange = null;
     const now = performance.now();
+    this.triggerPlayerClientUpdate();
     await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { paused: true } });
     this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     this.LavalinkManager.emit("playerPaused", this, this.queue.current);
@@ -5607,6 +5717,7 @@ var Player = class {
     if (!this.paused) throw new Error("Player isn't paused - not able to resume.");
     this.paused = false;
     const now = performance.now();
+    this.triggerPlayerClientUpdate();
     await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { paused: false } });
     this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     this.LavalinkManager.emit("playerResumed", this, this.queue.current);
@@ -5627,6 +5738,7 @@ var Player = class {
     this.lastPositionChange = Date.now();
     this.lastPosition = position;
     const now = performance.now();
+    this.triggerPlayerClientUpdate();
     await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { position } });
     this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     return this;
@@ -5639,6 +5751,7 @@ var Player = class {
     if (!["off", "track", "queue"].includes(repeatMode))
       throw new RangeError("Repeatmode must be either 'off', 'track', or 'queue'");
     this.repeatMode = repeatMode;
+    this.triggerPlayerClientUpdate();
     return this;
   }
   /**
@@ -5893,7 +6006,7 @@ var Player = class {
               functionLayer: "Player > changeNode()"
             });
           });
-        } else {
+        } else if (this.LavalinkManager.options?.playerOptions?.enforceSponsorBlockRequestForEventEnablement !== false) {
           await this.setSponsorBlock().catch((error) => {
             this._emitDebugEvent("PlayerChangeNode" /* PlayerChangeNode */, {
               state: "error",
@@ -5989,7 +6102,7 @@ var Player = class {
       nodeId: this.node?.id,
       nodeSessionId: this.node?.sessionId,
       ping: this.ping,
-      queue: this.queue.utils.toJSON()
+      queue: this.queue?.utils?.toJSON?.()
     };
   }
 };
@@ -6072,6 +6185,7 @@ var LavalinkManager = class extends import_events2.EventEmitter {
         applyVolumeAsFilter: options?.playerOptions?.applyVolumeAsFilter ?? false,
         clientBasedPositionUpdateInterval: options?.playerOptions?.clientBasedPositionUpdateInterval ?? 100,
         defaultSearchPlatform: options?.playerOptions?.defaultSearchPlatform ?? "ytsearch",
+        allowCustomSources: options?.playerOptions?.allowCustomSources ?? false,
         onDisconnect: {
           destroyPlayer: options?.playerOptions?.onDisconnect?.destroyPlayer ?? true,
           autoReconnect: options?.playerOptions?.onDisconnect?.autoReconnect ?? false,
@@ -6088,7 +6202,8 @@ var LavalinkManager = class extends import_events2.EventEmitter {
         maxErrorsPerTime: {
           threshold: options?.playerOptions?.maxErrorsPerTime?.threshold ?? 35e3,
           maxAmount: options?.playerOptions?.maxErrorsPerTime?.maxAmount ?? 3
-        }
+        },
+        enforceSponsorBlockRequestForEventEnablement: options?.playerOptions?.enforceSponsorBlockRequestForEventEnablement ?? true
       },
       linksWhitelist: options?.linksWhitelist ?? [],
       linksBlacklist: options?.linksBlacklist ?? [],
@@ -6188,6 +6303,7 @@ var LavalinkManager = class extends import_events2.EventEmitter {
    *       applyVolumeAsFilter: false,
    *       clientBasedPositionUpdateInterval: 150,
    *       defaultSearchPlatform: "ytmsearch",
+   *       allowCustomSources: false,
    *       volumeDecrementer: 0.75,
    *       //requesterTransformer: YourRequesterTransformerFunction,
    *       onDisconnect: {

package/dist/index.mjs

@@ -540,12 +540,24 @@ var ManagerUtils = class {
   constructor(LavalinkManager2) {
     this.LavalinkManager = LavalinkManager2;
   }
+  /**
+   * Builds a pluginInfo object based on the provided data, extracting relevant information from the data and clientData parameters. This function is used to construct the pluginInfo property for tracks, allowing for consistent handling of plugin-related information across different track sources and formats.
+   * @param data
+   * @param clientData
+   * @returns
+   */
   buildPluginInfo(data, clientData = {}) {
     return {
       clientData,
       ...data.pluginInfo || data.plugin
     };
   }
+  /**
+   * Builds a Track object from the provided data and requester information. It validates the presence of required properties in the data, transforms the requester using a custom transformer function if provided, and constructs a Track object with the appropriate properties and plugin information. The function also includes error handling to ensure that the input data is valid and provides debug information if track building fails.
+   * @param data
+   * @param requester
+   * @returns
+   */
   buildTrack(data, requester) {
     if (!data?.encoded || typeof data.encoded !== "string")
       throw new RangeError("Argument 'data.encoded' must be present.");
@@ -643,6 +655,11 @@ var ManagerUtils = class {
       return false;
     return true;
   }
+  /**
+   * Gets the transformed requester based on the LavalinkManager options. If a custom requester transformer function is provided in the player options, it applies that function to the requester; otherwise, it returns the requester as is. The function also includes error handling to catch any exceptions that may occur during the transformation process and emits a debug event if the transformation fails.
+   * @param requester
+   * @returns
+   */
   getTransformedRequester(requester) {
     try {
       return typeof this.LavalinkManager?.options?.playerOptions?.requesterTransformer === "function" ? this.LavalinkManager?.options?.playerOptions?.requesterTransformer(requester) : requester;
@@ -731,6 +748,12 @@ var ManagerUtils = class {
   isUnresolvedTrackQuery(data) {
     return typeof data === "object" && !("info" in data) && typeof data.title === "string";
   }
+  /**
+   * Gets the closest track by resolving the provided UnresolvedTrack using the getClosestTrack function. It includes error handling to catch any exceptions that may occur during the resolution process and emits a debug event if the resolution fails. The function returns a Promise that resolves to a Track object if successful, or undefined if no closest track is found.
+   * @param data
+   * @param player
+   * @returns
+   */
   async getClosestTrack(data, player) {
     try {
       return getClosestTrack(data, player);
@@ -746,6 +769,13 @@ var ManagerUtils = class {
       throw e;
     }
   }
+  /**
+   * Validates the query string against various criteria, including checking for empty strings, length limits for specific sources, blacklisted links or words, and ensuring that the Lavalink node has the necessary source managers enabled for the provided query. The function also includes debug event emissions to assist with troubleshooting and understanding the validation process.
+   * @param node
+   * @param queryString
+   * @param sourceString
+   * @returns
+   */
   validateQueryString(node, queryString, sourceString) {
     if (!node.info) throw new Error("No Lavalink Node was provided");
     if (node._checkForSources && !node.info.sourceManagers?.length)
@@ -833,24 +863,84 @@ var ManagerUtils = class {
     }
     return;
   }
-  transformQuery(query) {
-    const sourceOfQuery = typeof query === "string" ? void 0 : DefaultSources[query.source?.trim?.()?.toLowerCase?.() ?? this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform?.toLowerCase?.()] ?? query.source?.trim?.()?.toLowerCase?.();
-    const Query = {
-      query: typeof query === "string" ? query : query.query,
-      extraQueryUrlParams: typeof query !== "string" ? query.extraQueryUrlParams : void 0,
-      source: sourceOfQuery ?? this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform?.toLowerCase?.()
-    };
-    const foundSource = Object.keys(DefaultSources).find((source) => Query.query?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
+  /**
+   * Finds the source of a query string by checking if it starts with a valid source prefix defined in the DefaultSources object. If a valid source prefix is found, it returns the corresponding SearchPlatform; otherwise, it returns null. This function is useful for determining the intended search platform for a given query string, allowing for more accurate search results when the user specifies a source (e.g., "ytsearch:Never Gonna Give You Up" would indicate that the search should be performed on YouTube).
+   * @param queryString
+   * @returns
+   */
+  findSourceOfQuery(queryString) {
+    const foundSource = Object.keys(DefaultSources).find((source) => queryString?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
     if (foundSource && !["https", "http"].includes(foundSource) && DefaultSources[foundSource]) {
-      Query.source = DefaultSources[foundSource];
-      Query.query = Query.query.slice(`${foundSource}:`.length, Query.query.length);
+      return foundSource;
+    }
+    return null;
+  }
+  /**
+   * Extracts the source from the query if it starts with a valid source prefix (e.g., "ytsearch:") and updates the searchQuery object accordingly.
+   * @param searchQuery
+   * @returns The updated searchQuery object with the extracted source and modified query string.
+   */
+  extractSourceOfQuery(searchQuery) {
+    const foundSource = this.findSourceOfQuery(searchQuery.query);
+    if (foundSource) {
+      searchQuery.source = DefaultSources[foundSource];
+      searchQuery.query = searchQuery.query.slice(`${foundSource}:`.length, searchQuery.query.length);
     }
-    return Query;
+    return searchQuery;
+  }
+  /**
+   * Converts a string to lowercase if the input is a string, otherwise returns the input as is. This is useful for ensuring that search platform identifiers are case-insensitive while allowing other types of input to pass through unchanged.
+   * @param input
+   * @returns
+   */
+  typedLowerCase(input) {
+    if (!input) return input;
+    if (typeof input === "string") return input.toLowerCase();
+    return input;
   }
+  /**
+   * Transforms a search query by determining the appropriate search platform based on the query string and the default search platform specified in the LavalinkManager options. It checks if the query string starts with a valid source prefix and extracts it if present. The function returns an object containing the modified query string, any extra URL parameters, and the determined search platform to be used for the search operation.
+   * @param query
+   * @returns
+   */
+  transformQuery(query) {
+    const typedDefault = this.typedLowerCase(this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform);
+    if (typeof query === "string") {
+      const Query = {
+        query,
+        extraQueryUrlParams: void 0,
+        source: typedDefault
+      };
+      return this.extractSourceOfQuery(Query);
+    }
+    const providedSource = query?.source?.trim?.()?.toLowerCase?.();
+    const validSourceExtracted = DefaultSources[providedSource ?? typedDefault];
+    return this.extractSourceOfQuery({
+      query: query.query,
+      extraQueryUrlParams: query.extraQueryUrlParams,
+      source: validSourceExtracted ?? providedSource ?? typedDefault
+    });
+  }
+  /**
+   * Transforms a LavaSearchQuery by determining the appropriate search platform based on the query string and the default search platform specified in the LavalinkManager options. It checks if the query string starts with a valid source prefix and extracts it if present. The function returns an object containing the modified query string, any extra URL parameters, the determined search platform to be used for the search operation, and the types of search (track, playlist, artist, album, text) to be performed.
+   * @param query
+   * @returns
+   */
   transformLavaSearchQuery(query) {
-    const sourceOfQuery = typeof query === "string" ? void 0 : DefaultSources[query.source?.trim?.()?.toLowerCase?.() ?? this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform?.toLowerCase?.()] ?? query.source?.trim?.()?.toLowerCase?.();
+    const typedDefault = this.typedLowerCase(this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform);
+    if (typeof query === "string") {
+      const Query2 = {
+        query,
+        types: [],
+        extraQueryUrlParams: void 0,
+        source: typedDefault
+      };
+      return this.extractSourceOfQuery(Query2);
+    }
+    const providedSource = query?.source?.trim?.()?.toLowerCase?.();
+    const validSourceExtracted = DefaultSources[providedSource ?? typedDefault];
     const Query = {
-      query: typeof query === "string" ? query : query.query,
+      query: query.query,
       types: query.types ? ["track", "playlist", "artist", "album", "text"].filter(
         (v) => query.types?.find((x) => x.toLowerCase().startsWith(v))
       ) : [
@@ -860,19 +950,23 @@ var ManagerUtils = class {
         "album"
         /*"text"*/
       ],
-      source: sourceOfQuery ?? this.LavalinkManager?.options?.playerOptions?.defaultSearchPlatform?.toLowerCase?.()
+      source: validSourceExtracted ?? providedSource ?? typedDefault
     };
-    const foundSource = Object.keys(DefaultSources).find((source) => Query.query.toLowerCase().startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
-    if (foundSource && DefaultSources[foundSource]) {
-      Query.source = DefaultSources[foundSource];
-      Query.query = Query.query.slice(`${foundSource}:`.length, Query.query.length);
-    }
-    return Query;
+    return this.extractSourceOfQuery(Query);
   }
+  /**
+   * Validates the provided source string against the capabilities of the Lavalink node. It checks if the source string is supported by the node's enabled source managers and plugins, throwing errors if any required sources or plugins are missing for the specified search platform. This ensures that search queries are only executed with compatible sources based on the node's configuration.
+   * @param node
+   * @param sourceString
+   * @returns
+   */
   validateSourceString(node, sourceString) {
     if (!sourceString) throw new Error(`No SourceString was provided`);
     const source = DefaultSources[sourceString.toLowerCase().trim()];
-    if (!source) throw new Error(`Lavalink Node SearchQuerySource: '${sourceString}' is not available`);
+    if (!source && !!this.LavalinkManager.options.playerOptions.allowCustomSources)
+      throw new Error(
+        `Lavalink-Client does not support SearchQuerySource: '${sourceString}'. You can disable this check by setting 'ManagerOptions.PlayerOptions.allowCustomSources' to true`
+      );
     if (!node.info) throw new Error("Lavalink Node does not have any info cached yet, not ready yet!");
     if (!node._checkForSources) return;
     if (source === "amsearch" && !node.info?.sourceManagers?.includes("applemusic")) {
@@ -2423,12 +2517,13 @@ var LavalinkNode = class _LavalinkNode {
     if (!error) return;
     this.NodeManager.emit("error", this, error);
     this.reconnectionState = "IDLE" /* IDLE */;
-    this.reconnect();
     if (this.options.closeOnError) {
       if (this.heartBeatInterval) clearInterval(this.heartBeatInterval);
       if (this.pingTimeout) clearTimeout(this.pingTimeout);
       this.socket?.close(500, "Node-Error - Force Reconnect");
+      return;
     }
+    this.reconnect();
   }
   /** @private util function for handling message events from websocket */
   async message(d) {
@@ -2652,7 +2747,7 @@ var LavalinkNode = class _LavalinkNode {
         (v) => Date.now() - v < this._LManager.options.playerOptions.maxErrorsPerTime?.threshold
       );
       player.set("internal_erroredTracksTimestamps", [...oldTimestamps, Date.now()]);
-      if (oldTimestamps.length > this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount) {
+      if (oldTimestamps.length >= this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount) {
         this._emitDebugEvent("TrackStuckMaxTracksErroredPerTime" /* TrackStuckMaxTracksErroredPerTime */, {
           state: "log",
           message: `trackStuck Event was triggered too often within a given threshold (LavalinkManager.options.playerOptions.maxErrorsPerTime). Threshold: "${this._LManager.options.playerOptions.maxErrorsPerTime?.threshold}ms", maxAmount: "${this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount}"`,
@@ -2690,7 +2785,7 @@ var LavalinkNode = class _LavalinkNode {
         (v) => Date.now() - v < this._LManager.options.playerOptions.maxErrorsPerTime?.threshold
       );
       player.set("internal_erroredTracksTimestamps", [...oldTimestamps, Date.now()]);
-      if (oldTimestamps.length > this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount) {
+      if (oldTimestamps.length >= this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount) {
         this._emitDebugEvent("TrackErrorMaxTracksErroredPerTime" /* TrackErrorMaxTracksErroredPerTime */, {
           state: "log",
           message: `TrackError Event was triggered too often within a given threshold (LavalinkManager.options.playerOptions.maxErrorsPerTime). Threshold: "${this._LManager.options.playerOptions.maxErrorsPerTime?.threshold}ms", maxAmount: "${this._LManager.options.playerOptions.maxErrorsPerTime?.maxAmount}"`,
@@ -3750,6 +3845,7 @@ var FilterManager = class {
     }
     const now = performance.now();
     if (this.player.options.instaUpdateFiltersFix === true) this.filterUpdatedState = true;
+    this.player.triggerPlayerClientUpdate();
     await this.player.node.updatePlayer({
       guildId: this.player.guildId,
       playerOptions: {
@@ -3844,7 +3940,7 @@ var FilterManager = class {
     this.filters.tremolo = false;
     this.filters.vibrato = false;
     this.filters.karaoke = false;
-    this.filters.karaoke = false;
+    this.filters.vaporwave = false;
     this.filters.volume = false;
     this.filters.nodeLinkEcho = false;
     this.filters.nodeLinkChorus = false;
@@ -3925,7 +4021,7 @@ var FilterManager = class {
     this.data = this.data ?? {};
     this.filters.nightcore = false;
     this.filters.vaporwave = false;
-    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, speed };
+    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, ...this.data.timescale, speed };
     this.isCustomFilterActive();
     await this.applyPlayerFilters();
     return this;
@@ -3947,7 +4043,7 @@ var FilterManager = class {
     this.data = this.data ?? {};
     this.filters.nightcore = false;
     this.filters.vaporwave = false;
-    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, pitch };
+    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, ...this.data.timescale, pitch };
     this.isCustomFilterActive();
     await this.applyPlayerFilters();
     return this;
@@ -3969,7 +4065,7 @@ var FilterManager = class {
     this.data = this.data ?? {};
     this.filters.nightcore = false;
     this.filters.vaporwave = false;
-    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, rate };
+    this.data.timescale = { ...DEFAULT_FILTER_DATAS.timescale, ...this.data.timescale, rate };
     this.isCustomFilterActive();
     await this.applyPlayerFilters();
     return this;
@@ -4398,6 +4494,7 @@ var FilterManager = class {
     if (!this.player.node.sessionId) throw new Error("The Lavalink-Node is either not ready or not up to date");
     const now = performance.now();
     if (this.player.options.instaUpdateFiltersFix === true) this.filterUpdatedState = true;
+    this.player.triggerPlayerClientUpdate();
     await this.player.node.updatePlayer({
       guildId: this.player.guildId,
       playerOptions: {
@@ -4554,7 +4651,7 @@ var Queue = class {
    * @param queueOptions
    */
   constructor(guildId, data = {}, QueueSaver2, queueOptions) {
-    this.queueChanges = queueOptions.queueChangesWatcher || null;
+    this.queueChanges = queueOptions?.queueChangesWatcher || null;
     this.guildId = guildId;
     this.QueueSaver = QueueSaver2;
     this.options.maxPreviousTracks = this.QueueSaver?.options?.maxPreviousTracks ?? this.options.maxPreviousTracks;
@@ -4605,7 +4702,7 @@ var Queue = class {
       ))
         this.previous.splice(
           0,
-          override ? this.tracks.length : 0,
+          override ? this.previous.length : 0,
           ...data.previous.filter(
             (track) => this.managerUtils.isTrack(track) || this.managerUtils.isUnresolvedTrack(track)
           )
@@ -4620,8 +4717,8 @@ var Queue = class {
      * @returns {{current:Track|null, previous:Track[], tracks:Track[]}}The Queue, but in a raw State, which allows easier handling for the QueueStoreManager
      */
     toJSON: () => {
-      if (this.previous.length > this.options.maxPreviousTracks)
-        this.previous.splice(this.options.maxPreviousTracks, this.previous.length);
+      if (this.previous?.length > this.options?.maxPreviousTracks)
+        this.previous?.splice(this.options?.maxPreviousTracks, this.previous.length);
       return {
         current: this.current ? { ...this.current } : null,
         previous: this.previous ? [...this.previous] : [],
@@ -5437,6 +5534,17 @@ var Player = class {
     this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     return this;
   }
+  /**
+   * The old JSON of the player, used for the "playerClientUpdate" event, which is emitted on every update of the player via a function call, so that you can compare the old data with the new data and do something with it if you want to.
+   */
+  oldJSON = this.toJSON();
+  /**
+   * Emits the "playerClientUpdate" event, which is emitted on every update of the player via a function call, so that you can compare the old data with the new data and do something with it if you want to.
+   */
+  triggerPlayerClientUpdate() {
+    this.LavalinkManager.emit("playerClientUpdate", this.oldJSON, this);
+    this.oldJSON = this.toJSON();
+  }
   /**
    * Set the Volume for the Player
    * @param volume The Volume in percent
@@ -5457,6 +5565,7 @@ var Player = class {
         0
       )
     );
+    this.triggerPlayerClientUpdate();
     const now = performance.now();
     if (this.LavalinkManager.options.playerOptions.applyVolumeAsFilter) {
       this._emitDebugEvent("PlayerVolumeAsFilter" /* PlayerVolumeAsFilter */, {
@@ -5531,6 +5640,7 @@ var Player = class {
     this.paused = true;
     this.lastPositionChange = null;
     const now = performance.now();
+    this.triggerPlayerClientUpdate();
     await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { paused: true } });
     this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     this.LavalinkManager.emit("playerPaused", this, this.queue.current);
@@ -5543,6 +5653,7 @@ var Player = class {
     if (!this.paused) throw new Error("Player isn't paused - not able to resume.");
     this.paused = false;
     const now = performance.now();
+    this.triggerPlayerClientUpdate();
     await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { paused: false } });
     this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     this.LavalinkManager.emit("playerResumed", this, this.queue.current);
@@ -5563,6 +5674,7 @@ var Player = class {
     this.lastPositionChange = Date.now();
     this.lastPosition = position;
     const now = performance.now();
+    this.triggerPlayerClientUpdate();
     await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { position } });
     this.ping.lavalink = Math.round((performance.now() - now) / 10) / 100;
     return this;
@@ -5575,6 +5687,7 @@ var Player = class {
     if (!["off", "track", "queue"].includes(repeatMode))
       throw new RangeError("Repeatmode must be either 'off', 'track', or 'queue'");
     this.repeatMode = repeatMode;
+    this.triggerPlayerClientUpdate();
     return this;
   }
   /**
@@ -5829,7 +5942,7 @@ var Player = class {
               functionLayer: "Player > changeNode()"
             });
           });
-        } else {
+        } else if (this.LavalinkManager.options?.playerOptions?.enforceSponsorBlockRequestForEventEnablement !== false) {
           await this.setSponsorBlock().catch((error) => {
             this._emitDebugEvent("PlayerChangeNode" /* PlayerChangeNode */, {
               state: "error",
@@ -5925,7 +6038,7 @@ var Player = class {
       nodeId: this.node?.id,
       nodeSessionId: this.node?.sessionId,
       ping: this.ping,
-      queue: this.queue.utils.toJSON()
+      queue: this.queue?.utils?.toJSON?.()
     };
   }
 };
@@ -6008,6 +6121,7 @@ var LavalinkManager = class extends EventEmitter2 {
         applyVolumeAsFilter: options?.playerOptions?.applyVolumeAsFilter ?? false,
         clientBasedPositionUpdateInterval: options?.playerOptions?.clientBasedPositionUpdateInterval ?? 100,
         defaultSearchPlatform: options?.playerOptions?.defaultSearchPlatform ?? "ytsearch",
+        allowCustomSources: options?.playerOptions?.allowCustomSources ?? false,
         onDisconnect: {
           destroyPlayer: options?.playerOptions?.onDisconnect?.destroyPlayer ?? true,
           autoReconnect: options?.playerOptions?.onDisconnect?.autoReconnect ?? false,
@@ -6024,7 +6138,8 @@ var LavalinkManager = class extends EventEmitter2 {
         maxErrorsPerTime: {
           threshold: options?.playerOptions?.maxErrorsPerTime?.threshold ?? 35e3,
           maxAmount: options?.playerOptions?.maxErrorsPerTime?.maxAmount ?? 3
-        }
+        },
+        enforceSponsorBlockRequestForEventEnablement: options?.playerOptions?.enforceSponsorBlockRequestForEventEnablement ?? true
       },
       linksWhitelist: options?.linksWhitelist ?? [],
       linksBlacklist: options?.linksBlacklist ?? [],
@@ -6124,6 +6239,7 @@ var LavalinkManager = class extends EventEmitter2 {
    *       applyVolumeAsFilter: false,
    *       clientBasedPositionUpdateInterval: 150,
    *       defaultSearchPlatform: "ytmsearch",
+   *       allowCustomSources: false,
    *       volumeDecrementer: 0.75,
    *       //requesterTransformer: YourRequesterTransformerFunction,
    *       onDisconnect: {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lavalink-client",
-    "version": "2.9.0",
+    "version": "2.9.2",
     "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients. - Supports NodeLink@v3 too.",
     "keywords": [
         "advanced",