lavalink-client 2.10.0 → 2.10.2

package/README.md

@@ -181,6 +181,8 @@ const node = client.lavalink.lavalinkManager.getNode("id") as NodeLinkNode;
 node.addMixerLayer()
 ```
 
+⚠️ NODELINK does not really require you to run "instaUpdateFiltersFix" on player creation.
+
 ### NodeLink Specific Methods
 
 - **`node.getYoutubeOAUTH(refreshToken)`**: Exchange a Refresh Token for an Access Token. [Docs](https://nodelink.js.org/docs/api/nodelink-features#oauth)
@@ -198,6 +200,48 @@ node.addMixerLayer()
 - **`node.getConnectionMetrics()`**: Get connection metrics. [Docs](https://nodelink.js.org/docs/api/rest#node-information)
 - **`node.loadDirectStream(track, volume, position, filters)`**: Stream raw PCM audio. [Docs](https://nodelink.js.org/docs/api/nodelink-features#loadstream)
 
+### NodeLink Specific Sources (`SourcesRecord`)
+
+By default, the client uses a generic `DefaultSources` record to map human-friendly prefixes like `youtube:`, `spotify:`, etc. to Lavalink search sources.
+
+For NodeLink, you can override this behavior to use the NodeLink-specific source prefixes (including `admsearch`, `audiomack`, `gaanasearch`, `gtts`, `pipertts`, etc.) via the `NodeLinkDefaultSources` export and the `ManagerUtils#SourcesRecord` property:
+
+```ts
+import { LavalinkManager, NodeType, NodeLinkNode, NodeLinkDefaultSources } from "lavalink-client";
+
+// create the manager as usual, but with a NodeLink node
+client.lavalink = new LavalinkManager({
+    nodes: [
+        {
+            authorization: "youshallnotpass",
+            host: "localhost",
+            port: 2333,
+            id: "nodelink-main",
+            nodeType: NodeType.NodeLink,
+        },
+    ],
+    sendToShard: (guildId, payload) => client.guilds.cache.get(guildId)?.shard?.send(payload),
+    autoSkip: true,
+    client: {
+        id: envConfig.clientId,
+        username: "MyBot",
+    },
+});
+
+// IMPORTANT: Override the default source mapping so `ytsearch:`, `amsearch:`, `admsearch:`, etc.
+// use the NodeLink-specific prefixes.
+client.lavalink.utils.SourcesRecord = NodeLinkDefaultSources;
+
+// Optional: You can also provide your own custom record extending NodeLinkDefaultSources:
+client.lavalink.utils.SourcesRecord = {
+    ...NodeLinkDefaultSources,
+    // custom alias that only your bot understands, which resolves to a NodeLink source
+    mycustomsource: "ytsearch",
+};
+```
+
+This makes all helper methods that use `ManagerUtils` (such as `transformQuery`, `transformLavaSearchQuery` and `validateSourceString`) work with NodeLink’s extended search prefixes when you are connected to a NodeLink node.
+
 ### NodeLink Specififc Events?
 
 ```ts

package/dist/index.cjs

@@ -41,6 +41,7 @@ __export(index_exports, {
   LavalinkPlugins: () => LavalinkPlugins,
   ManagerUtils: () => ManagerUtils,
   MiniMap: () => MiniMap,
+  NodeLinkDefaultSources: () => NodeLinkDefaultSources,
   NodeLinkExclusiveEvents: () => NodeLinkExclusiveEvents,
   NodeLinkNode: () => NodeLinkNode,
   NodeManager: () => NodeManager,
@@ -486,8 +487,6 @@ var DefaultSources = {
   pandora: "pdsearch",
   pd: "pdsearch",
   pdsearch: "pdsearch",
-  pdisrc: "pdisrc",
-  pdrec: "pdrec",
   "pandora music": "pdsearch",
   pandoramusic: "pdsearch",
   // speak PLUGIN
@@ -522,7 +521,15 @@ var DefaultSources = {
   jiosaavn: "jssearch",
   js: "jssearch",
   jssearch: "jssearch",
-  jsrec: "jsrec"
+  jsrec: "jsrec",
+  // amazon music
+  amzsearch: "amzsearch",
+  // audiomack
+  admsearch: "admsearch",
+  // gaana
+  gnsearch: "gnsearch",
+  // shazam
+  szsearch: "szsearch"
 };
 var LavalinkPlugins = {
   DuncteBot_Plugin: "DuncteBot-plugin",
@@ -531,7 +538,8 @@ var LavalinkPlugins = {
   LavaSearch: "lavasearch-plugin",
   Jiosaavn_Plugin: "jiosaavn-plugin",
   LavalinkFilterPlugin: "lavalink-filter-plugin",
-  JavaTimedLyricsPlugin: "java-lyrics-plugin"
+  JavaTimedLyricsPlugin: "java-lyrics-plugin",
+  PulseLinkPlugin: "pulselink-plugin"
 };
 var SourceLinksRegexes = {
   /** DEFAULT SUPPORTED BY LAVALINK */
@@ -607,6 +615,8 @@ function parseLavalinkConnUrl(connectionUrl) {
 }
 var ManagerUtils = class {
   LavalinkManager = void 0;
+  /** Override this with your custom sources record if you want to use custom sources for your node */
+  SourcesRecord = DefaultSources;
   constructor(LavalinkManager2) {
     this.LavalinkManager = LavalinkManager2;
   }
@@ -934,13 +944,13 @@ var ManagerUtils = class {
     return;
   }
   /**
-   * 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).
+   * Finds the source of a query string by checking if it starts with a valid source prefix defined in the Default Sources 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]) {
+    const foundSource = Object.keys(this.SourcesRecord).find((source) => queryString?.toLowerCase?.()?.startsWith(`${source}:`.toLowerCase()))?.trim?.()?.toLowerCase?.();
+    if (foundSource && !["https", "http"].includes(foundSource) && this.SourcesRecord[foundSource]) {
       return foundSource;
     }
     return null;
@@ -953,7 +963,7 @@ var ManagerUtils = class {
   extractSourceOfQuery(searchQuery) {
     const foundSource = this.findSourceOfQuery(searchQuery.query);
     if (foundSource) {
-      searchQuery.source = DefaultSources[foundSource];
+      searchQuery.source = this.SourcesRecord[foundSource];
       searchQuery.query = searchQuery.query.slice(`${foundSource}:`.length, searchQuery.query.length);
     }
     return searchQuery;
@@ -984,7 +994,7 @@ var ManagerUtils = class {
       return this.extractSourceOfQuery(Query);
     }
     const providedSource = query?.source?.trim?.()?.toLowerCase?.();
-    const validSourceExtracted = DefaultSources[providedSource ?? typedDefault];
+    const validSourceExtracted = this.SourcesRecord[providedSource ?? typedDefault];
     return this.extractSourceOfQuery({
       query: query.query,
       extraQueryUrlParams: query.extraQueryUrlParams,
@@ -1008,7 +1018,7 @@ var ManagerUtils = class {
       return this.extractSourceOfQuery(Query2);
     }
     const providedSource = query?.source?.trim?.()?.toLowerCase?.();
-    const validSourceExtracted = DefaultSources[providedSource ?? typedDefault];
+    const validSourceExtracted = this.SourcesRecord[providedSource ?? typedDefault];
     const Query = {
       query: query.query,
       types: query.types ? ["track", "playlist", "artist", "album", "text"].filter(
@@ -1032,7 +1042,7 @@ var ManagerUtils = class {
    */
   validateSourceString(node, sourceString) {
     if (!sourceString) throw new Error(`No SourceString was provided`);
-    const source = DefaultSources[sourceString.toLowerCase().trim()];
+    const source = this.SourcesRecord[sourceString.toLowerCase().trim()];
     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`
@@ -1110,6 +1120,18 @@ var ManagerUtils = class {
     if (["pdsearch", "pdisrc", "pdrec"].includes(source) && !node.info?.sourceManagers?.includes("pandora")) {
       throw new Error("Lavalink Node has not 'pandora' enabled, which is required to have '" + source + "' work");
     }
+    if (source === "amzsearch" && !node.info?.sourceManagers?.includes("amazonmusic")) {
+      throw new Error("Lavalink Node has not 'amazonmusic' enabled, which is required to have 'amzsearch' work");
+    }
+    if (source === "admsearch" && !node.info?.sourceManagers?.includes("audiomack")) {
+      throw new Error("Lavalink Node has not 'audiomack' enabled, which is required to have 'admsearch' work");
+    }
+    if (source === "gnsearch" && !node.info?.sourceManagers?.includes("gaana")) {
+      throw new Error("Lavalink Node has not 'gaana' enabled, which is required to have 'gnsearch' work");
+    }
+    if (source === "szsearch" && !node.info?.sourceManagers?.includes("shazam")) {
+      throw new Error("Lavalink Node has not 'shazam' enabled, which is required to have 'szsearch' work");
+    }
     return;
   }
 };
@@ -1432,8 +1454,10 @@ var LavalinkNode = class _LavalinkNode {
       path: `/${this.version}/${endpoint.startsWith("/") ? endpoint.slice(1) : endpoint}`,
       method: "GET",
       headers: {
-        Authorization: this.options.authorization
+        Authorization: this.options.authorization,
+        ...this.NodeManager.LavalinkManager?.options?.httpHeaders
       },
+      // if httpHeaders is undefined/null, it won't be added, so we can keept it short like this
       signal: this.options.requestSignalTimeoutMS && this.options.requestSignalTimeoutMS > 0 ? AbortSignal.timeout(this.options.requestSignalTimeoutMS) : void 0
     };
     modify?.(options);
@@ -1546,10 +1570,8 @@ var LavalinkNode = class _LavalinkNode {
     if (Query.source) this._LManager.utils.validateSourceString(this, Query.source);
     if (/^https?:\/\//.test(Query.query))
       return this.search({ query: Query.query, source: Query.source }, requestUser);
-    if (!["spsearch", "sprec", "amsearch", "dzsearch", "dzisrc", "ytmsearch", "ytsearch"].includes(Query.source))
-      throw new SyntaxError(
-        `Query.source must be a source from LavaSrc: "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "ytmsearch" | "ytsearch"`
-      );
+    if (!this.isLavaSrcSource(Query.source))
+      throw new SyntaxError(`Query.source must be an available source from LavaSrc`);
     if (this._checkForPlugins && !this.info?.plugins?.find?.((v) => v.name === "lavasearch-plugin"))
       throw new RangeError(`there is no lavasearch-plugin available in the lavalink node: ${this.id}`);
     if (this._checkForPlugins && !this.info?.plugins?.find?.((v) => v.name === "lavasrc-plugin"))
@@ -1670,7 +1692,8 @@ var LavalinkNode = class _LavalinkNode {
       "Client-Name": String(this._LManager.options.client.username || "Lavalink-Client").replace(
         /[^\x20-\x7E]/g,
         ""
-      )
+      ),
+      ...this.NodeManager.LavalinkManager.options?.httpHeaders
     };
     if (typeof this.options.sessionId === "string" || typeof sessionId === "string") {
       headers["Session-Id"] = this.options.sessionId || sessionId;
@@ -1975,7 +1998,10 @@ var LavalinkNode = class _LavalinkNode {
         throw new RangeError(
           `there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`
         );
-      const url = `/lyrics?track=${track.encoded}&skipTrackSource=${skipTrackSource}`;
+      let url = `/lyrics?track=${track.encoded}&skipTrackSource=${skipTrackSource}`;
+      if (this.nodeType === "NodeLink" /* NodeLink */) {
+        url = `/loadlyrics?encodedTrack=${track.encoded}`;
+      }
       return await this.request(url);
     },
     /**
@@ -2001,7 +2027,10 @@ var LavalinkNode = class _LavalinkNode {
         throw new RangeError(
           `there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`
         );
-      const url = `/sessions/${this.sessionId}/players/${guildId}/track/lyrics?skipTrackSource=${skipTrackSource}`;
+      let url = `/sessions/${this.sessionId}/players/${guildId}/track/lyrics?skipTrackSource=${skipTrackSource}`;
+      if (this.nodeType === "NodeLink" /* NodeLink */) {
+        url = `/loadlyrics?encodedTrack=${this._LManager.getPlayer(guildId)?.queue.current?.encoded}`;
+      }
       return await this.request(url);
     },
     /**
@@ -3134,9 +3163,134 @@ var LavalinkNode = class _LavalinkNode {
     this._LManager.emit("LyricsNotFound", player, track, payload);
     return;
   }
+  /**
+   * @private
+   * util function to check if a provided source is valid with current node.
+   * @param {LavalinkSearchPlatform} src
+   * @returns {boolean} True if provided source is valid.
+   */
+  isLavaSrcSource(src) {
+    const source = /* @__PURE__ */ new Set([]);
+    if (this.info?.sourceManagers.includes("spotify")) source.add("spsearch").add("sprec");
+    if (this.info?.sourceManagers.includes("applemusic")) source.add("amsearch");
+    if (this.info?.sourceManagers.includes("deezer")) source.add("dzsearch").add("dzrec").add("dzisrc");
+    if (this.info?.sourceManagers.includes("yandexmusic")) source.add("ymsearch").add("ymrec");
+    if (this.info?.sourceManagers.includes("vkmusic")) source.add("vksearch").add("vkrec");
+    if (this.info?.sourceManagers.includes("tidal")) source.add("tdsearch").add("tdrec");
+    if (this.info?.sourceManagers.includes("qobuz")) source.add("qbsearch").add("qbisrc").add("qbrec");
+    if (this.info?.sourceManagers.includes("youtube")) source.add("ytsearch").add("ytmsearch");
+    return typeof src === "string" && source.has(src);
+  }
 };
 
 // src/structures/NodeLink.ts
+var NodeLinkDefaultSources = {
+  // youtubemusic
+  "youtube music": "ytmsearch",
+  youtubemusic: "ytmsearch",
+  ytmsearch: "ytmsearch",
+  ytm: "ytmsearch",
+  musicyoutube: "ytmsearch",
+  "music youtube": "ytmsearch",
+  // youtube
+  youtube: "ytsearch",
+  yt: "ytsearch",
+  ytsearch: "ytsearch",
+  // soundcloud
+  soundcloud: "scsearch",
+  scsearch: "scsearch",
+  sc: "scsearch",
+  // apple music
+  "apple music": "amsearch",
+  apple: "amsearch",
+  applemusic: "amsearch",
+  amsearch: "amsearch",
+  am: "amsearch",
+  musicapple: "amsearch",
+  "music apple": "amsearch",
+  // spotify
+  spotify: "spsearch",
+  spsearch: "spsearch",
+  sp: "spsearch",
+  "spotify.com": "spsearch",
+  spotifycom: "spsearch",
+  sprec: "sprec",
+  spsuggestion: "sprec",
+  // deezer
+  deezer: "dzsearch",
+  dz: "dzsearch",
+  dzsearch: "dzsearch",
+  dzisrc: "dzsearch",
+  // NodeLink doesn't expose `dzisrc` as a prefix string
+  dzrec: "dzrec",
+  // yandexmusic
+  "yandex music": "ymsearch",
+  yandexmusic: "ymsearch",
+  yandex: "ymsearch",
+  ymsearch: "ymsearch",
+  ymrec: "ymsearch",
+  // VK Music
+  vksearch: "vksearch",
+  vkmusic: "vksearch",
+  "vk music": "vksearch",
+  vkrec: "vkrec",
+  vk: "vksearch",
+  // Qobuz
+  qbsearch: "qbsearch",
+  qobuz: "qbsearch",
+  qbisrc: "qbsearch",
+  // NodeLink doesn't expose `qbisrc` as a prefix string
+  qbrec: "qbsearch",
+  // NodeLink doesn't expose `qbrec` as a prefix string
+  // pandora
+  pandora: "pdsearch",
+  pd: "pdsearch",
+  pdsearch: "pdsearch",
+  "pandora music": "pdsearch",
+  pandoramusic: "pdsearch",
+  // speak PLUGIN
+  speak: "speak",
+  // Map Lavalink's `tts` prefix to NodeLink's `gtts`
+  tts: "gtts",
+  ftts: "ftts",
+  flowery: "flowery",
+  "flowery.tts": "flowery",
+  flowerytts: "flowery",
+  // Client sided search platforms
+  bandcamp: "bcsearch",
+  bc: "bcsearch",
+  bcsearch: "bcsearch",
+  // other searches (not supported explicitly in NodeLink prefixes)
+  phsearch: "search",
+  pornhub: "search",
+  porn: "search",
+  // local files
+  local: "local",
+  // http requests
+  http: "http",
+  https: "https",
+  link: "link",
+  uri: "uri",
+  // tidal
+  tidal: "tdsearch",
+  td: "tdsearch",
+  "tidal music": "tdsearch",
+  tdsearch: "tdsearch",
+  tdrec: "tdrec",
+  // jiosaavn
+  jiosaavn: "jssearch",
+  js: "jssearch",
+  jssearch: "jssearch",
+  jsrec: "jsrec",
+  amzsearch: "amsearch",
+  // amazon music (falls back to Apple Music search on NodeLink)
+  // audiomack
+  admsearch: "admsearch",
+  // gaana
+  gnsearch: "gaanasearch",
+  // shazam
+  szsearch: "szsearch"
+};
 var NodeLinkNode = class extends LavalinkNode {
   nodeType = "NodeLink" /* NodeLink */;
   constructor(options, manager) {
@@ -6092,7 +6246,7 @@ var Player = class {
         );
       if (this.queue.current || this.queue.tracks.length) {
         const trackSources = new Set(
-          [this.queue.current, ...this.queue.tracks].map((track) => track.info.sourceName)
+          [this.queue.current, ...this.queue.tracks].map((track) => track?.info?.sourceName).filter(Boolean)
         );
         const missingSources = [...trackSources].filter(
           (source) => !updateNode.info?.sourceManagers.includes(source)
@@ -6339,6 +6493,7 @@ var LavalinkManager = class _LavalinkManager extends import_node_events2.EventEm
         queueChangesWatcher: options?.queueOptions?.queueChangesWatcher ?? null,
         queueStore: options?.queueOptions?.queueStore ?? new DefaultQueueStore()
       },
+      httpHeaders: options?.httpHeaders ?? {},
       advancedOptions: {
         enableDebugEvents: options?.advancedOptions?.enableDebugEvents ?? false,
         maxFilterFixDuration: options?.advancedOptions?.maxFilterFixDuration ?? 6e5,
@@ -6392,6 +6547,19 @@ var LavalinkManager = class _LavalinkManager extends import_node_events2.EventEm
     }
     if (typeof options?.queueOptions?.maxPreviousTracks !== "number" || options?.queueOptions?.maxPreviousTracks < 0)
       options.queueOptions.maxPreviousTracks = 25;
+    if (options?.httpHeaders) {
+      if (typeof options.httpHeaders !== "object" || Array.isArray(options.httpHeaders))
+        throw new SyntaxError("ManagerOption.httpHeaders must be an object with string keys and string values");
+      const forbiddenHeaders = ["authorization", "user-id", "client-name", "session-id"];
+      for (const header in options.httpHeaders) {
+        if (forbiddenHeaders.includes(header.toLowerCase()))
+          throw new SyntaxError(
+            `ManagerOption.httpHeaders cannot have the following headers: ${forbiddenHeaders.join(", ")}`
+          );
+        if (typeof options.httpHeaders[header] !== "string")
+          throw new SyntaxError(`ManagerOption.httpHeaders values must be of type string :: ${header}`);
+      }
+    }
   }
   /**
    * Emits a debug event to the LavalinkManager
@@ -6876,6 +7044,7 @@ var LavalinkManager = class _LavalinkManager extends import_node_events2.EventEm
   LavalinkPlugins,
   ManagerUtils,
   MiniMap,
+  NodeLinkDefaultSources,
   NodeLinkExclusiveEvents,
   NodeLinkNode,
   NodeManager,

package/dist/index.d.cts

@@ -417,6 +417,8 @@ declare function parseLavalinkConnUrl(connectionUrl: string): {
 };
 declare class ManagerUtils {
     LavalinkManager: LavalinkManager | undefined;
+    /** Override this with your custom sources record if you want to use custom sources for your node */
+    SourcesRecord: Record<SearchPlatform, LavalinkSearchPlatform | ClientCustomSearchPlatformUtils>;
     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.
@@ -504,7 +506,7 @@ declare class ManagerUtils {
      */
     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).
+     * Finds the source of a query string by checking if it starts with a valid source prefix defined in the Default Sources 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
      */
@@ -547,7 +549,7 @@ declare class ManagerUtils {
     } | {
         query: string;
         types: string[];
-        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";
+        source: "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec" | "tdsearch" | "tdrec" | "qbsearch" | "qbisrc" | "qbrec" | "jssearch" | "jsrec" | "ftts" | "speak" | "phsearch" | "pornhub" | "porn" | "tts" | "amzsearch" | "admsearch" | "gnsearch" | "szsearch" | "pdsearch" | "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.
@@ -609,13 +611,17 @@ type Opaque<T, K> = T & {
 type IntegerNumber = Opaque<number, "Int">;
 /** Opqaue tyep for floatnumber */
 type FloatNumber = Opaque<number, "Float">;
-type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec" | "tdsearch" | "tdrec" | "qbsearch" | "qbisrc" | "qbrec" | "pdsearch" | "pdisrc" | "pdrec";
+type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec" | "tdsearch" | "tdrec" | "qbsearch" | "qbisrc" | "qbrec" | "ytsearch" | "jssearch" | "jsrec";
 type LavaSrcSearchPlatform = LavaSrcSearchPlatformBase | "ftts";
 type JioSaavnSearchPlatform = "jssearch" | "jsrec";
 type DuncteSearchPlatform = "speak" | "phsearch" | "pornhub" | "porn" | "tts";
+type PulseLinkSearchPlatform = "spsearch" | "amzsearch" | "amsearch" | "dzsearch" | "ymsearch" | "vksearch" | "tdsearch" | "qbsearch" | "jssearch" | "admsearch" | "gnsearch" | "szsearch" | "pdsearch" | "ytsearch" | "ytmsearch";
 type LavalinkClientSearchPlatform = "bcsearch";
 type LavalinkClientSearchPlatformResolve = "bandcamp" | "bc";
-type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | JioSaavnSearchPlatform | LavalinkClientSearchPlatform;
+type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | PulseLinkSearchPlatform | JioSaavnSearchPlatform | LavalinkClientSearchPlatform;
+type NodeLinkSearchPlatformBase = "ytsearch" | "ytmsearch" | "scsearch" | "search" | "spsearch" | "amsearch" | "dzsearch" | "tdsearch" | "bcsearch" | "admsearch" | "audiomack" | "gaanasearch" | "jssearch" | "lfsearch" | "pdsearch" | "vksearch" | "mcsearch" | "ncsearch" | "nicovideo" | "bilibili" | "shsearch" | "szsearch" | "ebox" | "jukebox" | "slsearch" | "qbsearch" | "ymsearch" | "ausearch" | "azsearch" | "agsearch" | "bksearch" | "lmsearch" | "pipertts" | "gtts" | "speak" | "ftts" | "flowery" | "gdsearch";
+type NodeLinkRecommendationPlatform = "ytrec" | "sprec" | "dzrec" | "tdrec" | "jsrec" | "vkrec";
+type NodeLinkSearchPlatform = NodeLinkSearchPlatformBase | NodeLinkRecommendationPlatform;
 type ClientCustomSearchPlatformUtils = "local" | "http" | "https" | "link" | "uri";
 type ClientSearchPlatform = ClientCustomSearchPlatformUtils | "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" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform | "js" | "jiosaavn" | "td" | "tidal" | "tdrec";
 type SearchPlatform = LavalinkSearchPlatform | ClientSearchPlatform;
@@ -2893,6 +2899,8 @@ declare class Player {
     toJSON(): PlayerJson;
 }
 
+/** Default Sources Record for NodeLink, to allow source parsing with multiple inputs. */
+declare const NodeLinkDefaultSources: Record<SearchPlatform, NodeLinkSearchPlatform | ClientCustomSearchPlatformUtils>;
 declare class NodeLinkNode extends LavalinkNode {
     nodeType: NodeType;
     constructor(options: LavalinkNodeOptions, manager: NodeManager);
@@ -3680,6 +3688,13 @@ declare class LavalinkNode {
      * @param {LyricsNotFoundEvent} payload The payload of the event
      */
     private LyricsNotFound;
+    /**
+     * @private
+     * util function to check if a provided source is valid with current node.
+     * @param {LavalinkSearchPlatform} src
+     * @returns {boolean} True if provided source is valid.
+     */
+    private isLavaSrcSource;
 }
 
 declare class NodeManager extends EventEmitter {
@@ -4066,6 +4081,8 @@ interface ManagerOptions<CustomPlayerT extends Player = Player> {
     linksBlacklist?: (RegExp | string)[];
     /** If links should be allowed or not. If set to false, it will throw an error if a link was provided. */
     linksAllowed?: boolean;
+    /** Custom http headers to be sent with every request to lavalink */
+    httpHeaders?: Record<string, string>;
     /** Advanced Options for the Library, which may or may not be "library breaking" */
     advancedOptions?: {
         /** Max duration for that the filter fix duration works (in ms) - default is 8mins */
@@ -4340,8 +4357,9 @@ declare const LavalinkPlugins: {
     Jiosaavn_Plugin: string;
     LavalinkFilterPlugin: string;
     JavaTimedLyricsPlugin: string;
+    PulseLinkPlugin: string;
 };
 /** Lavalink Sources regexes for url validations */
 declare const SourceLinksRegexes: Record<SourcesRegex, RegExp>;
 
-export { type AudioOutputs, type Awaitable, type Base64, type BaseNodeStats, type BasePlayOptions, type BotClientOptions, type CPUStats, type ChannelDeletePacket, type ChannelMixFilter, type ClientCustomSearchPlatformUtils, type ClientSearchPlatform, DebugEvents, type DeepRequired, DefaultQueueStore, DefaultSources, DestroyReasons, type DestroyReasonsType, DisconnectReasons, type DisconnectReasonsType, type DistortionFilter, type DuncteSearchPlatform, type EQBand, EQList, type Exception, type FailingAddress, type FilterData, FilterManager, type FloatNumber, type FrameStats, type GitObject, type GuildShardPayload, type IntegerNumber, type InvalidLavalinkRestRequest, type JioSaavnSearchPlatform, type KaraokeFilter, type LavaSearchFilteredResponse, type LavaSearchQuery, type LavaSearchResponse, type LavaSearchType, type LavaSrcSearchPlatform, type LavaSrcSearchPlatformBase, type LavalinkClientSearchPlatform, type LavalinkClientSearchPlatformResolve, type LavalinkFilterData, type LavalinkInfo, LavalinkManager, type LavalinkManagerEvents, LavalinkNode, type LavalinkNodeIdentifier, type LavalinkNodeOptions, type LavalinkPlayOptions, type LavalinkPlayer, type LavalinkPlayerVoice, type LavalinkPlayerVoiceOptions, type LavalinkPlugin_JioSaavn_SourceNames, type LavalinkPlugin_LavaSrc_SourceNames, LavalinkPlugins, type LavalinkSearchPlatform, type LavalinkSourceNames, type LavalinkTrack, type LavalinkTrackInfo, type LoadTypes, type LowPassFilter, type LyricsEvent, type LyricsEventType, type LyricsFoundEvent, type LyricsLine, type LyricsLineEvent, type LyricsNotFoundEvent, type LyricsResult, type ManagerOptions, type ManagerPlayerOptions, type ManagerQueueOptions, ManagerUtils, type MemoryStats, MiniMap, type MiniMapConstructor, type ModifyRequest, type NodeLinkConnectionMetrics, NodeLinkExclusiveEvents, NodeLinkNode, type NodeLink_ChorusFilter, type NodeLink_CompressorFilter, type NodeLink_EchoFilter, type NodeLink_HighPassFilter, type NodeLink_PhaserFilter, type NodeLink_SpatialFilter, NodeManager, type NodeManagerEvents, type NodeMessage, type NodeStats, NodeSymbol, NodeType, type Opaque, type PlayOptions, Player, type PlayerEvent, type PlayerEventType, type PlayerEvents, type PlayerFilters, type PlayerJson, type PlayerOptions, type PlayerUpdateInfo, type PlaylistInfo, type PluginInfo, type PluginObject, Queue, type QueueChangesWatcher, QueueSaver, type QueueStoreManager, QueueSymbol, RecommendationsStrings, ReconnectionState, type RepeatMode, type RequiredManagerOptions, type RotationFilter, type RoutePlanner, type RoutePlannerTypes, type SearchPlatform, type SearchQuery, type SearchResult, type Session, type Severity, SourceLinksRegexes, type SourceNames, type SourcesRegex, type SponsorBlockChapterStarted, type SponsorBlockChaptersLoaded, type SponsorBlockSegment, type SponsorBlockSegmentEventType, type SponsorBlockSegmentEvents, type SponsorBlockSegmentSkipped, type SponsorBlockSegmentsLoaded, type State, type StoredQueue, type TimescaleFilter, type Track, type TrackEndEvent, type TrackEndReason, type TrackExceptionEvent, type TrackInfo, type TrackRequester, type TrackStartEvent, type TrackStuckEvent, TrackSymbol, type TremoloFilter, type UnresolvedQuery, type UnresolvedSearchResult, type UnresolvedTrack, type UnresolvedTrackInfo, UnresolvedTrackSymbol, type VersionObject, type VibratoFilter, type VoicePacket, type VoiceServer, type VoiceState, type WebSocketClosedEvent, type anyObject, audioOutputsData, parseLavalinkConnUrl, queueTrackEnd, safeStringify, validSponsorBlocks };
+export { type AudioOutputs, type Awaitable, type Base64, type BaseNodeStats, type BasePlayOptions, type BotClientOptions, type CPUStats, type ChannelDeletePacket, type ChannelMixFilter, type ClientCustomSearchPlatformUtils, type ClientSearchPlatform, DebugEvents, type DeepRequired, DefaultQueueStore, DefaultSources, DestroyReasons, type DestroyReasonsType, DisconnectReasons, type DisconnectReasonsType, type DistortionFilter, type DuncteSearchPlatform, type EQBand, EQList, type Exception, type FailingAddress, type FilterData, FilterManager, type FloatNumber, type FrameStats, type GitObject, type GuildShardPayload, type IntegerNumber, type InvalidLavalinkRestRequest, type JioSaavnSearchPlatform, type KaraokeFilter, type LavaSearchFilteredResponse, type LavaSearchQuery, type LavaSearchResponse, type LavaSearchType, type LavaSrcSearchPlatform, type LavaSrcSearchPlatformBase, type LavalinkClientSearchPlatform, type LavalinkClientSearchPlatformResolve, type LavalinkFilterData, type LavalinkInfo, LavalinkManager, type LavalinkManagerEvents, LavalinkNode, type LavalinkNodeIdentifier, type LavalinkNodeOptions, type LavalinkPlayOptions, type LavalinkPlayer, type LavalinkPlayerVoice, type LavalinkPlayerVoiceOptions, type LavalinkPlugin_JioSaavn_SourceNames, type LavalinkPlugin_LavaSrc_SourceNames, LavalinkPlugins, type LavalinkSearchPlatform, type LavalinkSourceNames, type LavalinkTrack, type LavalinkTrackInfo, type LoadTypes, type LowPassFilter, type LyricsEvent, type LyricsEventType, type LyricsFoundEvent, type LyricsLine, type LyricsLineEvent, type LyricsNotFoundEvent, type LyricsResult, type ManagerOptions, type ManagerPlayerOptions, type ManagerQueueOptions, ManagerUtils, type MemoryStats, MiniMap, type MiniMapConstructor, type ModifyRequest, type NodeLinkConnectionMetrics, NodeLinkDefaultSources, NodeLinkExclusiveEvents, NodeLinkNode, type NodeLinkRecommendationPlatform, type NodeLinkSearchPlatform, type NodeLinkSearchPlatformBase, type NodeLink_ChorusFilter, type NodeLink_CompressorFilter, type NodeLink_EchoFilter, type NodeLink_HighPassFilter, type NodeLink_PhaserFilter, type NodeLink_SpatialFilter, NodeManager, type NodeManagerEvents, type NodeMessage, type NodeStats, NodeSymbol, NodeType, type Opaque, type PlayOptions, Player, type PlayerEvent, type PlayerEventType, type PlayerEvents, type PlayerFilters, type PlayerJson, type PlayerOptions, type PlayerUpdateInfo, type PlaylistInfo, type PluginInfo, type PluginObject, type PulseLinkSearchPlatform, Queue, type QueueChangesWatcher, QueueSaver, type QueueStoreManager, QueueSymbol, RecommendationsStrings, ReconnectionState, type RepeatMode, type RequiredManagerOptions, type RotationFilter, type RoutePlanner, type RoutePlannerTypes, type SearchPlatform, type SearchQuery, type SearchResult, type Session, type Severity, SourceLinksRegexes, type SourceNames, type SourcesRegex, type SponsorBlockChapterStarted, type SponsorBlockChaptersLoaded, type SponsorBlockSegment, type SponsorBlockSegmentEventType, type SponsorBlockSegmentEvents, type SponsorBlockSegmentSkipped, type SponsorBlockSegmentsLoaded, type State, type StoredQueue, type TimescaleFilter, type Track, type TrackEndEvent, type TrackEndReason, type TrackExceptionEvent, type TrackInfo, type TrackRequester, type TrackStartEvent, type TrackStuckEvent, TrackSymbol, type TremoloFilter, type UnresolvedQuery, type UnresolvedSearchResult, type UnresolvedTrack, type UnresolvedTrackInfo, UnresolvedTrackSymbol, type VersionObject, type VibratoFilter, type VoicePacket, type VoiceServer, type VoiceState, type WebSocketClosedEvent, type anyObject, audioOutputsData, parseLavalinkConnUrl, queueTrackEnd, safeStringify, validSponsorBlocks };

package/dist/index.d.ts

@@ -417,6 +417,8 @@ declare function parseLavalinkConnUrl(connectionUrl: string): {
 };
 declare class ManagerUtils {
     LavalinkManager: LavalinkManager | undefined;
+    /** Override this with your custom sources record if you want to use custom sources for your node */
+    SourcesRecord: Record<SearchPlatform, LavalinkSearchPlatform | ClientCustomSearchPlatformUtils>;
     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.
@@ -504,7 +506,7 @@ declare class ManagerUtils {
      */
     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).
+     * Finds the source of a query string by checking if it starts with a valid source prefix defined in the Default Sources 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
      */
@@ -547,7 +549,7 @@ declare class ManagerUtils {
     } | {
         query: string;
         types: string[];
-        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";
+        source: "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec" | "tdsearch" | "tdrec" | "qbsearch" | "qbisrc" | "qbrec" | "jssearch" | "jsrec" | "ftts" | "speak" | "phsearch" | "pornhub" | "porn" | "tts" | "amzsearch" | "admsearch" | "gnsearch" | "szsearch" | "pdsearch" | "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.
@@ -609,13 +611,17 @@ type Opaque<T, K> = T & {
 type IntegerNumber = Opaque<number, "Int">;
 /** Opqaue tyep for floatnumber */
 type FloatNumber = Opaque<number, "Float">;
-type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec" | "tdsearch" | "tdrec" | "qbsearch" | "qbisrc" | "qbrec" | "pdsearch" | "pdisrc" | "pdrec";
+type LavaSrcSearchPlatformBase = "spsearch" | "sprec" | "amsearch" | "dzsearch" | "dzisrc" | "dzrec" | "ymsearch" | "ymrec" | "vksearch" | "vkrec" | "tdsearch" | "tdrec" | "qbsearch" | "qbisrc" | "qbrec" | "ytsearch" | "jssearch" | "jsrec";
 type LavaSrcSearchPlatform = LavaSrcSearchPlatformBase | "ftts";
 type JioSaavnSearchPlatform = "jssearch" | "jsrec";
 type DuncteSearchPlatform = "speak" | "phsearch" | "pornhub" | "porn" | "tts";
+type PulseLinkSearchPlatform = "spsearch" | "amzsearch" | "amsearch" | "dzsearch" | "ymsearch" | "vksearch" | "tdsearch" | "qbsearch" | "jssearch" | "admsearch" | "gnsearch" | "szsearch" | "pdsearch" | "ytsearch" | "ytmsearch";
 type LavalinkClientSearchPlatform = "bcsearch";
 type LavalinkClientSearchPlatformResolve = "bandcamp" | "bc";
-type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | JioSaavnSearchPlatform | LavalinkClientSearchPlatform;
+type LavalinkSearchPlatform = "ytsearch" | "ytmsearch" | "scsearch" | "bcsearch" | LavaSrcSearchPlatform | DuncteSearchPlatform | PulseLinkSearchPlatform | JioSaavnSearchPlatform | LavalinkClientSearchPlatform;
+type NodeLinkSearchPlatformBase = "ytsearch" | "ytmsearch" | "scsearch" | "search" | "spsearch" | "amsearch" | "dzsearch" | "tdsearch" | "bcsearch" | "admsearch" | "audiomack" | "gaanasearch" | "jssearch" | "lfsearch" | "pdsearch" | "vksearch" | "mcsearch" | "ncsearch" | "nicovideo" | "bilibili" | "shsearch" | "szsearch" | "ebox" | "jukebox" | "slsearch" | "qbsearch" | "ymsearch" | "ausearch" | "azsearch" | "agsearch" | "bksearch" | "lmsearch" | "pipertts" | "gtts" | "speak" | "ftts" | "flowery" | "gdsearch";
+type NodeLinkRecommendationPlatform = "ytrec" | "sprec" | "dzrec" | "tdrec" | "jsrec" | "vkrec";
+type NodeLinkSearchPlatform = NodeLinkSearchPlatformBase | NodeLinkRecommendationPlatform;
 type ClientCustomSearchPlatformUtils = "local" | "http" | "https" | "link" | "uri";
 type ClientSearchPlatform = ClientCustomSearchPlatformUtils | "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" | LavalinkClientSearchPlatformResolve | LavalinkClientSearchPlatform | "js" | "jiosaavn" | "td" | "tidal" | "tdrec";
 type SearchPlatform = LavalinkSearchPlatform | ClientSearchPlatform;
@@ -2893,6 +2899,8 @@ declare class Player {
     toJSON(): PlayerJson;
 }
 
+/** Default Sources Record for NodeLink, to allow source parsing with multiple inputs. */
+declare const NodeLinkDefaultSources: Record<SearchPlatform, NodeLinkSearchPlatform | ClientCustomSearchPlatformUtils>;
 declare class NodeLinkNode extends LavalinkNode {
     nodeType: NodeType;
     constructor(options: LavalinkNodeOptions, manager: NodeManager);
@@ -3680,6 +3688,13 @@ declare class LavalinkNode {
      * @param {LyricsNotFoundEvent} payload The payload of the event
      */
     private LyricsNotFound;
+    /**
+     * @private
+     * util function to check if a provided source is valid with current node.
+     * @param {LavalinkSearchPlatform} src
+     * @returns {boolean} True if provided source is valid.
+     */
+    private isLavaSrcSource;
 }
 
 declare class NodeManager extends EventEmitter {
@@ -4066,6 +4081,8 @@ interface ManagerOptions<CustomPlayerT extends Player = Player> {
     linksBlacklist?: (RegExp | string)[];
     /** If links should be allowed or not. If set to false, it will throw an error if a link was provided. */
     linksAllowed?: boolean;
+    /** Custom http headers to be sent with every request to lavalink */
+    httpHeaders?: Record<string, string>;
     /** Advanced Options for the Library, which may or may not be "library breaking" */
     advancedOptions?: {
         /** Max duration for that the filter fix duration works (in ms) - default is 8mins */
@@ -4340,8 +4357,9 @@ declare const LavalinkPlugins: {
     Jiosaavn_Plugin: string;
     LavalinkFilterPlugin: string;
     JavaTimedLyricsPlugin: string;
+    PulseLinkPlugin: string;
 };
 /** Lavalink Sources regexes for url validations */
 declare const SourceLinksRegexes: Record<SourcesRegex, RegExp>;
 
-export { type AudioOutputs, type Awaitable, type Base64, type BaseNodeStats, type BasePlayOptions, type BotClientOptions, type CPUStats, type ChannelDeletePacket, type ChannelMixFilter, type ClientCustomSearchPlatformUtils, type ClientSearchPlatform, DebugEvents, type DeepRequired, DefaultQueueStore, DefaultSources, DestroyReasons, type DestroyReasonsType, DisconnectReasons, type DisconnectReasonsType, type DistortionFilter, type DuncteSearchPlatform, type EQBand, EQList, type Exception, type FailingAddress, type FilterData, FilterManager, type FloatNumber, type FrameStats, type GitObject, type GuildShardPayload, type IntegerNumber, type InvalidLavalinkRestRequest, type JioSaavnSearchPlatform, type KaraokeFilter, type LavaSearchFilteredResponse, type LavaSearchQuery, type LavaSearchResponse, type LavaSearchType, type LavaSrcSearchPlatform, type LavaSrcSearchPlatformBase, type LavalinkClientSearchPlatform, type LavalinkClientSearchPlatformResolve, type LavalinkFilterData, type LavalinkInfo, LavalinkManager, type LavalinkManagerEvents, LavalinkNode, type LavalinkNodeIdentifier, type LavalinkNodeOptions, type LavalinkPlayOptions, type LavalinkPlayer, type LavalinkPlayerVoice, type LavalinkPlayerVoiceOptions, type LavalinkPlugin_JioSaavn_SourceNames, type LavalinkPlugin_LavaSrc_SourceNames, LavalinkPlugins, type LavalinkSearchPlatform, type LavalinkSourceNames, type LavalinkTrack, type LavalinkTrackInfo, type LoadTypes, type LowPassFilter, type LyricsEvent, type LyricsEventType, type LyricsFoundEvent, type LyricsLine, type LyricsLineEvent, type LyricsNotFoundEvent, type LyricsResult, type ManagerOptions, type ManagerPlayerOptions, type ManagerQueueOptions, ManagerUtils, type MemoryStats, MiniMap, type MiniMapConstructor, type ModifyRequest, type NodeLinkConnectionMetrics, NodeLinkExclusiveEvents, NodeLinkNode, type NodeLink_ChorusFilter, type NodeLink_CompressorFilter, type NodeLink_EchoFilter, type NodeLink_HighPassFilter, type NodeLink_PhaserFilter, type NodeLink_SpatialFilter, NodeManager, type NodeManagerEvents, type NodeMessage, type NodeStats, NodeSymbol, NodeType, type Opaque, type PlayOptions, Player, type PlayerEvent, type PlayerEventType, type PlayerEvents, type PlayerFilters, type PlayerJson, type PlayerOptions, type PlayerUpdateInfo, type PlaylistInfo, type PluginInfo, type PluginObject, Queue, type QueueChangesWatcher, QueueSaver, type QueueStoreManager, QueueSymbol, RecommendationsStrings, ReconnectionState, type RepeatMode, type RequiredManagerOptions, type RotationFilter, type RoutePlanner, type RoutePlannerTypes, type SearchPlatform, type SearchQuery, type SearchResult, type Session, type Severity, SourceLinksRegexes, type SourceNames, type SourcesRegex, type SponsorBlockChapterStarted, type SponsorBlockChaptersLoaded, type SponsorBlockSegment, type SponsorBlockSegmentEventType, type SponsorBlockSegmentEvents, type SponsorBlockSegmentSkipped, type SponsorBlockSegmentsLoaded, type State, type StoredQueue, type TimescaleFilter, type Track, type TrackEndEvent, type TrackEndReason, type TrackExceptionEvent, type TrackInfo, type TrackRequester, type TrackStartEvent, type TrackStuckEvent, TrackSymbol, type TremoloFilter, type UnresolvedQuery, type UnresolvedSearchResult, type UnresolvedTrack, type UnresolvedTrackInfo, UnresolvedTrackSymbol, type VersionObject, type VibratoFilter, type VoicePacket, type VoiceServer, type VoiceState, type WebSocketClosedEvent, type anyObject, audioOutputsData, parseLavalinkConnUrl, queueTrackEnd, safeStringify, validSponsorBlocks };
+export { type AudioOutputs, type Awaitable, type Base64, type BaseNodeStats, type BasePlayOptions, type BotClientOptions, type CPUStats, type ChannelDeletePacket, type ChannelMixFilter, type ClientCustomSearchPlatformUtils, type ClientSearchPlatform, DebugEvents, type DeepRequired, DefaultQueueStore, DefaultSources, DestroyReasons, type DestroyReasonsType, DisconnectReasons, type DisconnectReasonsType, type DistortionFilter, type DuncteSearchPlatform, type EQBand, EQList, type Exception, type FailingAddress, type FilterData, FilterManager, type FloatNumber, type FrameStats, type GitObject, type GuildShardPayload, type IntegerNumber, type InvalidLavalinkRestRequest, type JioSaavnSearchPlatform, type KaraokeFilter, type LavaSearchFilteredResponse, type LavaSearchQuery, type LavaSearchResponse, type LavaSearchType, type LavaSrcSearchPlatform, type LavaSrcSearchPlatformBase, type LavalinkClientSearchPlatform, type LavalinkClientSearchPlatformResolve, type LavalinkFilterData, type LavalinkInfo, LavalinkManager, type LavalinkManagerEvents, LavalinkNode, type LavalinkNodeIdentifier, type LavalinkNodeOptions, type LavalinkPlayOptions, type LavalinkPlayer, type LavalinkPlayerVoice, type LavalinkPlayerVoiceOptions, type LavalinkPlugin_JioSaavn_SourceNames, type LavalinkPlugin_LavaSrc_SourceNames, LavalinkPlugins, type LavalinkSearchPlatform, type LavalinkSourceNames, type LavalinkTrack, type LavalinkTrackInfo, type LoadTypes, type LowPassFilter, type LyricsEvent, type LyricsEventType, type LyricsFoundEvent, type LyricsLine, type LyricsLineEvent, type LyricsNotFoundEvent, type LyricsResult, type ManagerOptions, type ManagerPlayerOptions, type ManagerQueueOptions, ManagerUtils, type MemoryStats, MiniMap, type MiniMapConstructor, type ModifyRequest, type NodeLinkConnectionMetrics, NodeLinkDefaultSources, NodeLinkExclusiveEvents, NodeLinkNode, type NodeLinkRecommendationPlatform, type NodeLinkSearchPlatform, type NodeLinkSearchPlatformBase, type NodeLink_ChorusFilter, type NodeLink_CompressorFilter, type NodeLink_EchoFilter, type NodeLink_HighPassFilter, type NodeLink_PhaserFilter, type NodeLink_SpatialFilter, NodeManager, type NodeManagerEvents, type NodeMessage, type NodeStats, NodeSymbol, NodeType, type Opaque, type PlayOptions, Player, type PlayerEvent, type PlayerEventType, type PlayerEvents, type PlayerFilters, type PlayerJson, type PlayerOptions, type PlayerUpdateInfo, type PlaylistInfo, type PluginInfo, type PluginObject, type PulseLinkSearchPlatform, Queue, type QueueChangesWatcher, QueueSaver, type QueueStoreManager, QueueSymbol, RecommendationsStrings, ReconnectionState, type RepeatMode, type RequiredManagerOptions, type RotationFilter, type RoutePlanner, type RoutePlannerTypes, type SearchPlatform, type SearchQuery, type SearchResult, type Session, type Severity, SourceLinksRegexes, type SourceNames, type SourcesRegex, type SponsorBlockChapterStarted, type SponsorBlockChaptersLoaded, type SponsorBlockSegment, type SponsorBlockSegmentEventType, type SponsorBlockSegmentEvents, type SponsorBlockSegmentSkipped, type SponsorBlockSegmentsLoaded, type State, type StoredQueue, type TimescaleFilter, type Track, type TrackEndEvent, type TrackEndReason, type TrackExceptionEvent, type TrackInfo, type TrackRequester, type TrackStartEvent, type TrackStuckEvent, TrackSymbol, type TremoloFilter, type UnresolvedQuery, type UnresolvedSearchResult, type UnresolvedTrack, type UnresolvedTrackInfo, UnresolvedTrackSymbol, type VersionObject, type VibratoFilter, type VoicePacket, type VoiceServer, type VoiceState, type WebSocketClosedEvent, type anyObject, audioOutputsData, parseLavalinkConnUrl, queueTrackEnd, safeStringify, validSponsorBlocks };