lavalink-client 2.10.1 → 2.10.2

package/README.md

@@ -200,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);
@@ -1668,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;
@@ -3153,13 +3178,119 @@ var LavalinkNode = class _LavalinkNode {
     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("pandora")) source.add("pdsearch").add("pdisrc").add("pdrec");
     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) {
@@ -6362,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,
@@ -6415,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
@@ -6899,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);
@@ -4073,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 */
@@ -4347,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);
@@ -4073,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 */
@@ -4347,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.js

@@ -421,8 +421,6 @@ var DefaultSources = {
   pandora: "pdsearch",
   pd: "pdsearch",
   pdsearch: "pdsearch",
-  pdisrc: "pdisrc",
-  pdrec: "pdrec",
   "pandora music": "pdsearch",
   pandoramusic: "pdsearch",
   // speak PLUGIN
@@ -457,7 +455,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",
@@ -466,7 +472,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 */
@@ -542,6 +549,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;
   }
@@ -869,13 +878,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;
@@ -888,7 +897,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;
@@ -919,7 +928,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,
@@ -943,7 +952,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(
@@ -967,7 +976,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`
@@ -1045,6 +1054,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;
   }
 };
@@ -1367,8 +1388,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);
@@ -1603,7 +1626,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;
@@ -3088,13 +3112,119 @@ var LavalinkNode = class _LavalinkNode {
     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("pandora")) source.add("pdsearch").add("pdisrc").add("pdrec");
     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) {
@@ -6297,6 +6427,7 @@ var LavalinkManager = class _LavalinkManager extends EventEmitter2 {
         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,
@@ -6350,6 +6481,19 @@ var LavalinkManager = class _LavalinkManager extends EventEmitter2 {
     }
     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
@@ -6833,6 +6977,7 @@ export {
   LavalinkPlugins,
   ManagerUtils,
   MiniMap,
+  NodeLinkDefaultSources,
   NodeLinkExclusiveEvents,
   NodeLinkNode,
   NodeManager,

package/dist/index.mjs

@@ -421,8 +421,6 @@ var DefaultSources = {
   pandora: "pdsearch",
   pd: "pdsearch",
   pdsearch: "pdsearch",
-  pdisrc: "pdisrc",
-  pdrec: "pdrec",
   "pandora music": "pdsearch",
   pandoramusic: "pdsearch",
   // speak PLUGIN
@@ -457,7 +455,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",
@@ -466,7 +472,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 */
@@ -542,6 +549,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;
   }
@@ -869,13 +878,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;
@@ -888,7 +897,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;
@@ -919,7 +928,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,
@@ -943,7 +952,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(
@@ -967,7 +976,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`
@@ -1045,6 +1054,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;
   }
 };
@@ -1367,8 +1388,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);
@@ -1603,7 +1626,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;
@@ -3088,13 +3112,119 @@ var LavalinkNode = class _LavalinkNode {
     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("pandora")) source.add("pdsearch").add("pdisrc").add("pdrec");
     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) {
@@ -6297,6 +6427,7 @@ var LavalinkManager = class _LavalinkManager extends EventEmitter2 {
         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,
@@ -6350,6 +6481,19 @@ var LavalinkManager = class _LavalinkManager extends EventEmitter2 {
     }
     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
@@ -6833,6 +6977,7 @@ export {
   LavalinkPlugins,
   ManagerUtils,
   MiniMap,
+  NodeLinkDefaultSources,
   NodeLinkExclusiveEvents,
   NodeLinkNode,
   NodeManager,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lavalink-client",
-    "version": "2.10.1",
+    "version": "2.10.2",
     "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients. - Supports NodeLink@v3 too.",
     "keywords": [
         "advanced",
@@ -59,14 +59,14 @@
     },
     "dependencies": {
         "tslib": "^2.8.1",
-        "ws": "^8.19.0"
+        "ws": "^8.20.0"
     },
     "devDependencies": {
         "@types/bun": "latest",
-        "@types/node": "^24.10.15",
+        "@types/node": "^24.12.3",
         "@types/ws": "^8.18.1",
         "oxfmt": "^0.28.0",
-        "oxlint": "^1.50.0",
+        "oxlint": "^1.63.0",
         "tsup": "^8.5.1",
         "typescript": "^5.9.3"
     },