lavalink-client 1.2.0 → 1.2.1

package/README.md

@@ -111,9 +111,22 @@ Check out the [Documentation](https://lc4.gitbook.io/lavalink-client) for **Exam
   - `player.deleteSponsorBlock()` / `node.deleteSponsorBlock()`
     - That Plugin adds following **Events** to the **Manager**: `"SegmentsLoaded"`, `"SegmentSkipped"`, `"ChapterStarted"`, `"ChaptersLoaded"`
 - Example Bot show example in autoplayFunction how to "disable" / "enable" Autoplay with bot data variables.
-- Added `ManagerOptions#onlyEmitNewTracks`. If set to true, it won't emit "trackStart" Event, when track.loop is active, or the new current track == the previous (current) track. 
+- Added `ManagerOptions#emitNewSongsOnly`. If set to true, it won't emit "trackStart" Event, when track.loop is active, or the new current track == the previous (current) track. 
 - Added `ManagerOptions#linksBlacklist` which allows user to specify an array of regExp / strings to match query strings (for links / words) and if a match happens it doesn't allow the request (blacklist) 
 - Added `ManagerOptions#linksWhitelist` which allows user to specify an array of regExp / strings to match query strings (for links only) and if a match does NOT HAPPEN it doesn't allow the request (whitelist)
 - Added `ManagerOptions#linksAllowed` if set to false, it does not allow requests which are links
 - Moved `ManaagerOptions#debugOptions` to `ManaagerOptions#advancedOptions.debugOptions`
 
+### **Version 1.2.1**
+- Adjusted `player.stopPlaying()`
+  - There are now following parameters. `stopPlaying(clearQueue:boolean = true, executeAutoplay:boolean = false)`.
+    - On Default it now clears the queue and stops playing. Also it does not execute Autoplay on default. IF you want the function to behave differently, you can use the 2 states for that. 
+  - Fixed that it looped the current track if repeatmode === "track" / "queue". (it stops playing and loop stays)
+- Implemented a `parseLavalinkConnUrl(connectionUrl:string)` Util Function.
+  - It allows you to parse Lavalink Connection Data of a Lavalink Connection Url. 
+  Pattern: `lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>`
+  - Note that the nodeId and NodeAuthorization must be encoded via encodeURIComponents before you provide it into the function.
+  - The function will return the following: `{ id: string, authorization: string, host: string, port: number }`
+  - Example: `parseLavalinkConnUrl("lavalink://LavalinkNode_1:strong%23password1@localhost:2345")` will give you:
+  `{ id: "LavalinkNode_1", authorization: "strong#password1", host: "localhost", port: 2345 }`
+    - Note that the password "strong#password1" when encoded turns into "strong%23password1". For more information check the example bot

package/dist/cjs/structures/Node.d.ts

@@ -240,17 +240,17 @@ export declare class LavalinkNode {
     private error;
     private message;
     private handleEvent;
+    private trackStart;
+    private trackEnd;
+    private trackStuck;
+    private trackError;
+    private socketClosed;
     private SponsorBlockSegmentLoaded;
     private SponsorBlockSegmentkipped;
     private SponsorBlockChaptersLoaded;
     private SponsorBlockChapterStarted;
-    private trackStart;
-    private trackEnd;
     getSponsorBlock(player: Player): Promise<SponsorBlockSegment[]>;
     setSponsorBlock(player: Player, segments?: SponsorBlockSegment[]): Promise<void>;
     deleteSponsorBlock(player: Player): Promise<void>;
     private queueEnd;
-    private trackStuck;
-    private trackError;
-    private socketClosed;
 }

package/dist/cjs/structures/Node.js

@@ -566,6 +566,7 @@ class LavalinkNode {
                 return;
         }
     }
+    // LAVALINK EVENT HANDLING UTIL FUNCTION
     async handleEvent(payload) {
         if (!payload.guildId)
             return;
@@ -606,18 +607,7 @@ class LavalinkNode {
         }
         return;
     }
-    SponsorBlockSegmentLoaded(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("SegmentsLoaded", player, track, payload);
-    }
-    SponsorBlockSegmentkipped(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("SegmentSkipped", player, track, payload);
-    }
-    SponsorBlockChaptersLoaded(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("ChaptersLoaded", player, track, payload);
-    }
-    SponsorBlockChapterStarted(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("ChapterStarted", player, track, payload);
-    }
+    // LAVALINK EVENT HANDLING FUNCTIONS
     trackStart(player, track, payload) {
         player.playing = true;
         player.paused = false;
@@ -628,7 +618,7 @@ class LavalinkNode {
     }
     async trackEnd(player, track, payload) {
         // If there are no songs in the queue
-        if (!player.queue.tracks.length && player.repeatMode === "off")
+        if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
             return this.queueEnd(player, track, payload);
         // If a track was forcibly played
         if (payload.reason === "replaced")
@@ -661,6 +651,49 @@ class LavalinkNode {
         // play track if autoSkip is true
         return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
     }
+    async trackStuck(player, track, payload) {
+        this.NodeManager.LavalinkManager.emit("trackStuck", player, track, payload);
+        // If there are no songs in the queue
+        if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
+            return this.queueEnd(player, track, payload);
+        // remove the current track, and enqueue the next one
+        await (0, Utils_1.queueTrackEnd)(player);
+        // if no track available, end queue
+        if (!player.queue.current)
+            return this.queueEnd(player, track, payload);
+        // play track if autoSkip is true
+        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
+    }
+    async trackError(player, track, payload) {
+        this.NodeManager.LavalinkManager.emit("trackError", player, track, payload);
+        // If there are no songs in the queue
+        if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
+            return this.queueEnd(player, track, payload);
+        // remove the current track, and enqueue the next one
+        await (0, Utils_1.queueTrackEnd)(player);
+        // if no track available, end queue
+        if (!player.queue.current)
+            return this.queueEnd(player, track, payload);
+        // play track if autoSkip is true
+        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
+    }
+    socketClosed(player, payload) {
+        return this.NodeManager.LavalinkManager.emit("playerSocketClosed", player, payload);
+    }
+    // SPONSOR BLOCK EVENT FUNCTIONS
+    SponsorBlockSegmentLoaded(player, track, payload) {
+        return this.NodeManager.LavalinkManager.emit("SegmentsLoaded", player, track, payload);
+    }
+    SponsorBlockSegmentkipped(player, track, payload) {
+        return this.NodeManager.LavalinkManager.emit("SegmentSkipped", player, track, payload);
+    }
+    SponsorBlockChaptersLoaded(player, track, payload) {
+        return this.NodeManager.LavalinkManager.emit("ChaptersLoaded", player, track, payload);
+    }
+    SponsorBlockChapterStarted(player, track, payload) {
+        return this.NodeManager.LavalinkManager.emit("ChapterStarted", player, track, payload);
+    }
+    // SPONSOR BLOCK EXECUTE FUNCTIONS
     async getSponsorBlock(player) {
         // no plugin enabled
         if (!this.info.plugins.find(v => v.name === "sponsorblock-plugin"))
@@ -697,11 +730,13 @@ class LavalinkNode {
         });
         return;
     }
+    // UTIL FOR QUEUE END
     async queueEnd(player, track, payload) {
         // add previous track to the queue!
         player.queue.current = null;
         player.playing = false;
-        if (typeof this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction === "function") {
+        player.set("internal_stopPlaying", undefined);
+        if (typeof this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction === "function" && typeof player.get("internal_autoplayStopPlaying") === "undefined") {
             await this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction(player, track);
             if (player.queue.tracks.length > 0)
                 await (0, Utils_1.queueTrackEnd)(player);
@@ -711,6 +746,7 @@ class LavalinkNode {
                 return player.play({ noReplace: true, paused: false });
             }
         }
+        player.set("internal_autoplayStopPlaying", undefined);
         player.queue.previous.unshift(track);
         if (payload?.reason !== "stopped") {
             await player.queue.utils.save();
@@ -730,31 +766,5 @@ class LavalinkNode {
         }
         return this.NodeManager.LavalinkManager.emit("queueEnd", player, track, payload);
     }
-    async trackStuck(player, track, payload) {
-        this.NodeManager.LavalinkManager.emit("trackStuck", player, track, payload);
-        // If there are no songs in the queue
-        if (!player.queue.tracks.length && player.repeatMode === "off")
-            return;
-        // remove the current track, and enqueue the next one
-        await (0, Utils_1.queueTrackEnd)(player);
-        // if no track available, end queue
-        if (!player.queue.current)
-            return this.queueEnd(player, track, payload);
-        // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
-    }
-    async trackError(player, track, payload) {
-        this.NodeManager.LavalinkManager.emit("trackError", player, track, payload);
-        // remove the current track, and enqueue the next one
-        await (0, Utils_1.queueTrackEnd)(player);
-        // if no track available, end queue
-        if (!player.queue.current)
-            return this.queueEnd(player, track, payload);
-        // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
-    }
-    socketClosed(player, payload) {
-        return this.NodeManager.LavalinkManager.emit("playerSocketClosed", player, payload);
-    }
 }
 exports.LavalinkNode = LavalinkNode;

package/dist/cjs/structures/Player.d.ts

@@ -185,7 +185,7 @@ export declare class Player {
      * Clears the queue and stops playing. Does not destroy the Player and not leave the channel
      * @returns
      */
-    stopPlaying(): Promise<this>;
+    stopPlaying(clearQueue?: boolean, executeAutoplay?: boolean): Promise<this>;
     /**
      * Connects the Player to the Voice Channel
      * @returns

package/dist/cjs/structures/Player.js

@@ -313,10 +313,16 @@ class Player {
      * Clears the queue and stops playing. Does not destroy the Player and not leave the channel
      * @returns
      */
-    async stopPlaying() {
+    async stopPlaying(clearQueue = true, executeAutoplay = false) {
+        // use internal_stopPlaying on true, so that it doesn't utilize current loop states. on trackEnd event
+        this.set("internal_stopPlaying", true);
         // remove tracks from the queue
-        if (this.queue.tracks.length)
+        if (this.queue.tracks.length && clearQueue === true)
             await this.queue.splice(0, this.queue.tracks.length);
+        if (executeAutoplay === false)
+            this.set("internal_autoplayStopPlaying", true);
+        else
+            this.set("internal_autoplayStopPlaying", undefined);
         const now = performance.now();
         // send to lavalink, that it should stop playing
         await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { encodedTrack: null } });

package/dist/cjs/structures/Utils.d.ts

@@ -51,6 +51,17 @@ export interface UnresolvedSearchResult {
     playlist: PlaylistInfo | null;
     tracks: UnresolvedTrack[];
 }
+/**
+ * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
+ * @param connectionUrl
+ * @returns
+ */
+export declare function parseLavalinkConnUrl(connectionUrl: string): {
+    authorization: string;
+    id: string;
+    host: string;
+    port: number;
+};
 export declare class ManagerUtils {
     LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);

package/dist/cjs/structures/Utils.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queueTrackEnd = exports.MiniMap = exports.ManagerUtils = exports.NodeSymbol = exports.QueueSymbol = exports.UnresolvedTrackSymbol = exports.TrackSymbol = void 0;
-const types_1 = require("util/types");
+exports.queueTrackEnd = exports.MiniMap = exports.ManagerUtils = exports.parseLavalinkConnUrl = exports.NodeSymbol = exports.QueueSymbol = exports.UnresolvedTrackSymbol = exports.TrackSymbol = void 0;
+const node_url_1 = require("node:url");
+const types_1 = require("node:util/types");
 const LavalinkManagerStatics_1 = require("./LavalinkManagerStatics");
 exports.TrackSymbol = Symbol("LC-Track");
 exports.UnresolvedTrackSymbol = Symbol("LC-Track-Unresolved");
@@ -9,6 +10,23 @@ exports.QueueSymbol = Symbol("LC-Queue");
 exports.NodeSymbol = Symbol("LC-Node");
 /** @hidden */
 const escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+ * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
+ * @param connectionUrl
+ * @returns
+ */
+function parseLavalinkConnUrl(connectionUrl) {
+    if (!connectionUrl.startsWith("lavalink://"))
+        throw new Error(`ConnectionUrl (${connectionUrl}) must start with 'lavalink://'`);
+    const parsed = new node_url_1.URL(connectionUrl);
+    return {
+        authorization: parsed.password,
+        id: parsed.username,
+        host: parsed.hostname,
+        port: Number(parsed.port),
+    };
+}
+exports.parseLavalinkConnUrl = parseLavalinkConnUrl;
 class ManagerUtils {
     LavalinkManager = null;
     constructor(LavalinkManager) {

package/dist/esm/structures/Node.d.ts

@@ -240,17 +240,17 @@ export declare class LavalinkNode {
     private error;
     private message;
     private handleEvent;
+    private trackStart;
+    private trackEnd;
+    private trackStuck;
+    private trackError;
+    private socketClosed;
     private SponsorBlockSegmentLoaded;
     private SponsorBlockSegmentkipped;
     private SponsorBlockChaptersLoaded;
     private SponsorBlockChapterStarted;
-    private trackStart;
-    private trackEnd;
     getSponsorBlock(player: Player): Promise<SponsorBlockSegment[]>;
     setSponsorBlock(player: Player, segments?: SponsorBlockSegment[]): Promise<void>;
     deleteSponsorBlock(player: Player): Promise<void>;
     private queueEnd;
-    private trackStuck;
-    private trackError;
-    private socketClosed;
 }

package/dist/esm/structures/Node.js

@@ -562,6 +562,7 @@ export class LavalinkNode {
                 return;
         }
     }
+    // LAVALINK EVENT HANDLING UTIL FUNCTION
     async handleEvent(payload) {
         if (!payload.guildId)
             return;
@@ -602,18 +603,7 @@ export class LavalinkNode {
         }
         return;
     }
-    SponsorBlockSegmentLoaded(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("SegmentsLoaded", player, track, payload);
-    }
-    SponsorBlockSegmentkipped(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("SegmentSkipped", player, track, payload);
-    }
-    SponsorBlockChaptersLoaded(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("ChaptersLoaded", player, track, payload);
-    }
-    SponsorBlockChapterStarted(player, track, payload) {
-        return this.NodeManager.LavalinkManager.emit("ChapterStarted", player, track, payload);
-    }
+    // LAVALINK EVENT HANDLING FUNCTIONS
     trackStart(player, track, payload) {
         player.playing = true;
         player.paused = false;
@@ -624,7 +614,7 @@ export class LavalinkNode {
     }
     async trackEnd(player, track, payload) {
         // If there are no songs in the queue
-        if (!player.queue.tracks.length && player.repeatMode === "off")
+        if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
             return this.queueEnd(player, track, payload);
         // If a track was forcibly played
         if (payload.reason === "replaced")
@@ -657,6 +647,49 @@ export class LavalinkNode {
         // play track if autoSkip is true
         return this.NodeManager.LavalinkManager.options.autoSkip && player.play({ noReplace: true });
     }
+    async trackStuck(player, track, payload) {
+        this.NodeManager.LavalinkManager.emit("trackStuck", player, track, payload);
+        // If there are no songs in the queue
+        if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
+            return this.queueEnd(player, track, payload);
+        // remove the current track, and enqueue the next one
+        await queueTrackEnd(player);
+        // if no track available, end queue
+        if (!player.queue.current)
+            return this.queueEnd(player, track, payload);
+        // play track if autoSkip is true
+        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
+    }
+    async trackError(player, track, payload) {
+        this.NodeManager.LavalinkManager.emit("trackError", player, track, payload);
+        // If there are no songs in the queue
+        if (!player.queue.tracks.length && (player.repeatMode === "off" || player.get("internal_stopPlaying")))
+            return this.queueEnd(player, track, payload);
+        // remove the current track, and enqueue the next one
+        await queueTrackEnd(player);
+        // if no track available, end queue
+        if (!player.queue.current)
+            return this.queueEnd(player, track, payload);
+        // play track if autoSkip is true
+        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
+    }
+    socketClosed(player, payload) {
+        return this.NodeManager.LavalinkManager.emit("playerSocketClosed", player, payload);
+    }
+    // SPONSOR BLOCK EVENT FUNCTIONS
+    SponsorBlockSegmentLoaded(player, track, payload) {
+        return this.NodeManager.LavalinkManager.emit("SegmentsLoaded", player, track, payload);
+    }
+    SponsorBlockSegmentkipped(player, track, payload) {
+        return this.NodeManager.LavalinkManager.emit("SegmentSkipped", player, track, payload);
+    }
+    SponsorBlockChaptersLoaded(player, track, payload) {
+        return this.NodeManager.LavalinkManager.emit("ChaptersLoaded", player, track, payload);
+    }
+    SponsorBlockChapterStarted(player, track, payload) {
+        return this.NodeManager.LavalinkManager.emit("ChapterStarted", player, track, payload);
+    }
+    // SPONSOR BLOCK EXECUTE FUNCTIONS
     async getSponsorBlock(player) {
         // no plugin enabled
         if (!this.info.plugins.find(v => v.name === "sponsorblock-plugin"))
@@ -693,11 +726,13 @@ export class LavalinkNode {
         });
         return;
     }
+    // UTIL FOR QUEUE END
     async queueEnd(player, track, payload) {
         // add previous track to the queue!
         player.queue.current = null;
         player.playing = false;
-        if (typeof this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction === "function") {
+        player.set("internal_stopPlaying", undefined);
+        if (typeof this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction === "function" && typeof player.get("internal_autoplayStopPlaying") === "undefined") {
             await this.NodeManager.LavalinkManager.options?.playerOptions?.onEmptyQueue?.autoPlayFunction(player, track);
             if (player.queue.tracks.length > 0)
                 await queueTrackEnd(player);
@@ -707,6 +742,7 @@ export class LavalinkNode {
                 return player.play({ noReplace: true, paused: false });
             }
         }
+        player.set("internal_autoplayStopPlaying", undefined);
         player.queue.previous.unshift(track);
         if (payload?.reason !== "stopped") {
             await player.queue.utils.save();
@@ -726,30 +762,4 @@ export class LavalinkNode {
         }
         return this.NodeManager.LavalinkManager.emit("queueEnd", player, track, payload);
     }
-    async trackStuck(player, track, payload) {
-        this.NodeManager.LavalinkManager.emit("trackStuck", player, track, payload);
-        // If there are no songs in the queue
-        if (!player.queue.tracks.length && player.repeatMode === "off")
-            return;
-        // remove the current track, and enqueue the next one
-        await queueTrackEnd(player);
-        // if no track available, end queue
-        if (!player.queue.current)
-            return this.queueEnd(player, track, payload);
-        // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
-    }
-    async trackError(player, track, payload) {
-        this.NodeManager.LavalinkManager.emit("trackError", player, track, payload);
-        // remove the current track, and enqueue the next one
-        await queueTrackEnd(player);
-        // if no track available, end queue
-        if (!player.queue.current)
-            return this.queueEnd(player, track, payload);
-        // play track if autoSkip is true
-        return (this.NodeManager.LavalinkManager.options.autoSkip && player.queue.current) && player.play({ noReplace: true });
-    }
-    socketClosed(player, payload) {
-        return this.NodeManager.LavalinkManager.emit("playerSocketClosed", player, payload);
-    }
 }

package/dist/esm/structures/Player.d.ts

@@ -185,7 +185,7 @@ export declare class Player {
      * Clears the queue and stops playing. Does not destroy the Player and not leave the channel
      * @returns
      */
-    stopPlaying(): Promise<this>;
+    stopPlaying(clearQueue?: boolean, executeAutoplay?: boolean): Promise<this>;
     /**
      * Connects the Player to the Voice Channel
      * @returns

package/dist/esm/structures/Player.js

@@ -310,10 +310,16 @@ export class Player {
      * Clears the queue and stops playing. Does not destroy the Player and not leave the channel
      * @returns
      */
-    async stopPlaying() {
+    async stopPlaying(clearQueue = true, executeAutoplay = false) {
+        // use internal_stopPlaying on true, so that it doesn't utilize current loop states. on trackEnd event
+        this.set("internal_stopPlaying", true);
         // remove tracks from the queue
-        if (this.queue.tracks.length)
+        if (this.queue.tracks.length && clearQueue === true)
             await this.queue.splice(0, this.queue.tracks.length);
+        if (executeAutoplay === false)
+            this.set("internal_autoplayStopPlaying", true);
+        else
+            this.set("internal_autoplayStopPlaying", undefined);
         const now = performance.now();
         // send to lavalink, that it should stop playing
         await this.node.updatePlayer({ guildId: this.guildId, playerOptions: { encodedTrack: null } });

package/dist/esm/structures/Utils.d.ts

@@ -51,6 +51,17 @@ export interface UnresolvedSearchResult {
     playlist: PlaylistInfo | null;
     tracks: UnresolvedTrack[];
 }
+/**
+ * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
+ * @param connectionUrl
+ * @returns
+ */
+export declare function parseLavalinkConnUrl(connectionUrl: string): {
+    authorization: string;
+    id: string;
+    host: string;
+    port: number;
+};
 export declare class ManagerUtils {
     LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);

package/dist/esm/structures/Utils.js

@@ -1,4 +1,5 @@
-import { isRegExp } from "util/types";
+import { URL } from "node:url";
+import { isRegExp } from "node:util/types";
 import { DefaultSources, LavalinkPlugins, SourceLinksRegexes } from "./LavalinkManagerStatics";
 export const TrackSymbol = Symbol("LC-Track");
 export const UnresolvedTrackSymbol = Symbol("LC-Track-Unresolved");
@@ -6,6 +7,22 @@ export const QueueSymbol = Symbol("LC-Queue");
 export const NodeSymbol = Symbol("LC-Node");
 /** @hidden */
 const escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+ * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
+ * @param connectionUrl
+ * @returns
+ */
+export function parseLavalinkConnUrl(connectionUrl) {
+    if (!connectionUrl.startsWith("lavalink://"))
+        throw new Error(`ConnectionUrl (${connectionUrl}) must start with 'lavalink://'`);
+    const parsed = new URL(connectionUrl);
+    return {
+        authorization: parsed.password,
+        id: parsed.username,
+        host: parsed.hostname,
+        port: Number(parsed.port),
+    };
+}
 export class ManagerUtils {
     LavalinkManager = null;
     constructor(LavalinkManager) {

package/dist/types/structures/Node.d.ts

@@ -240,17 +240,17 @@ export declare class LavalinkNode {
     private error;
     private message;
     private handleEvent;
+    private trackStart;
+    private trackEnd;
+    private trackStuck;
+    private trackError;
+    private socketClosed;
     private SponsorBlockSegmentLoaded;
     private SponsorBlockSegmentkipped;
     private SponsorBlockChaptersLoaded;
     private SponsorBlockChapterStarted;
-    private trackStart;
-    private trackEnd;
     getSponsorBlock(player: Player): Promise<SponsorBlockSegment[]>;
     setSponsorBlock(player: Player, segments?: SponsorBlockSegment[]): Promise<void>;
     deleteSponsorBlock(player: Player): Promise<void>;
     private queueEnd;
-    private trackStuck;
-    private trackError;
-    private socketClosed;
 }

package/dist/types/structures/Player.d.ts

@@ -185,7 +185,7 @@ export declare class Player {
      * Clears the queue and stops playing. Does not destroy the Player and not leave the channel
      * @returns
      */
-    stopPlaying(): Promise<this>;
+    stopPlaying(clearQueue?: boolean, executeAutoplay?: boolean): Promise<this>;
     /**
      * Connects the Player to the Voice Channel
      * @returns

package/dist/types/structures/Utils.d.ts

@@ -51,6 +51,17 @@ export interface UnresolvedSearchResult {
     playlist: PlaylistInfo | null;
     tracks: UnresolvedTrack[];
 }
+/**
+ * Parses Node Connection Url: "lavalink://<nodeId>:<nodeAuthorization(Password)>@<NodeHost>:<NodePort>"
+ * @param connectionUrl
+ * @returns
+ */
+export declare function parseLavalinkConnUrl(connectionUrl: string): {
+    authorization: string;
+    id: string;
+    host: string;
+    port: number;
+};
 export declare class ManagerUtils {
     LavalinkManager: LavalinkManager | null;
     constructor(LavalinkManager?: LavalinkManager);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavalink-client",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",