lavalink-client 2.5.5 → 2.5.7

package/dist/cjs/structures/Node.js

@@ -133,6 +133,8 @@ class LavalinkNode {
         const { response, options } = await this.rawRequest(endpoint, modify);
         if (["DELETE", "PUT"].includes(options.method))
             return;
+        if (response.status === 204)
+            return; // no content
         if (response.status === 404)
             throw new Error(`Node Request resulted into an error, request-PATH: ${options.path} | headers: ${(0, Utils_1.safeStringify)(response.headers)}`);
         return parseAsText ? await response.text() : await response.json();
@@ -730,7 +732,9 @@ class LavalinkNode {
             if (!this.info.plugins.find(v => v.name === "lavasrc-plugin") &&
                 !this.info.plugins.find(v => v.name === "java-lyrics-plugin"))
                 throw new RangeError(`there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`);
-            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/unsubscribe`);
+            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe`, (options) => {
+                options.method = "DELETE";
+            });
         },
     };
     /**

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

@@ -196,7 +196,6 @@ export declare class Player {
     getLyrics(track: Track, skipTrackSource?: boolean): Promise<import("./Types/Node.js").LyricsResult>;
     /**
      * Subscribe to the lyrics event on a specific guild to active live lyrics events
-     * @param guildId The guild id to subscribe to
      * @returns The unsubscribe function
      * @example
      * ```ts
@@ -206,14 +205,13 @@ export declare class Player {
     subscribeLyrics(): Promise<unknown>;
     /**
      * Unsubscribe from the lyrics event on a specific guild to disable live lyrics events
-     * @param guildId The guild id to unsubscribe from
      * @returns The unsubscribe function
      * @example
      * ```ts
      * const lyrics = await player.unsubscribeLyrics();
      * ```
      */
-    unsubscribeLyrics(guildId: string): Promise<void>;
+    unsubscribeLyrics(): Promise<void>;
     /**
      * Move the player on a different Audio-Node
      * @param newNode New Node / New Node Id

package/dist/cjs/structures/Player.js

@@ -631,7 +631,6 @@ class Player {
     }
     /**
      * Subscribe to the lyrics event on a specific guild to active live lyrics events
-     * @param guildId The guild id to subscribe to
      * @returns The unsubscribe function
      * @example
      * ```ts
@@ -643,15 +642,14 @@ class Player {
     }
     /**
      * Unsubscribe from the lyrics event on a specific guild to disable live lyrics events
-     * @param guildId The guild id to unsubscribe from
      * @returns The unsubscribe function
      * @example
      * ```ts
      * const lyrics = await player.unsubscribeLyrics();
      * ```
      */
-    unsubscribeLyrics(guildId) {
-        return this.node.lyrics.unsubscribe(guildId);
+    unsubscribeLyrics() {
+        return this.node.lyrics.unsubscribe(this.guildId);
     }
     /**
      * Move the player on a different Audio-Node

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

@@ -46,32 +46,32 @@ export declare class DefaultQueueStore implements QueueStoreManager {
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    get(guildId: string): Promise<StoredQueue>;
+    get(guildId: string): StoredQueue;
     /**
      * Set the queue for a guild
      * @param guildId The guild ID
      * @param valueToStringify The queue to set
      * @returns The queue for the guild
      */
-    set(guildId: string, valueToStringify: any): Promise<boolean>;
+    set(guildId: string, valueToStringify: any): boolean;
     /**
      * Delete the queue for a guild
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    delete(guildId: string): Promise<boolean>;
+    delete(guildId: string): boolean;
     /**
      * Stringify the queue for a guild
      * @param value The queue to stringify
      * @returns The stringified queue
      */
-    stringify(value: StoredQueue): Promise<StoredQueue>;
+    stringify(value: StoredQueue | string): StoredQueue | string;
     /**
      * Parse the queue for a guild
      * @param value The queue to parse
      * @returns The parsed queue
      */
-    parse(value: StoredQueue): Promise<StoredQueue>;
+    parse(value: StoredQueue | string): Partial<StoredQueue>;
 }
 export declare class Queue {
     readonly tracks: (Track | UnresolvedTrack)[];

package/dist/cjs/structures/Queue.js

@@ -60,7 +60,7 @@ class DefaultQueueStore {
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    async get(guildId) {
+    get(guildId) {
         return this.data.get(guildId);
     }
     /**
@@ -69,7 +69,7 @@ class DefaultQueueStore {
      * @param valueToStringify The queue to set
      * @returns The queue for the guild
      */
-    async set(guildId, valueToStringify) {
+    set(guildId, valueToStringify) {
         return this.data.set(guildId, valueToStringify) ? true : false;
     }
     /**
@@ -77,7 +77,7 @@ class DefaultQueueStore {
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    async delete(guildId) {
+    delete(guildId) {
         return this.data.delete(guildId);
     }
     /**
@@ -85,7 +85,7 @@ class DefaultQueueStore {
      * @param value The queue to stringify
      * @returns The stringified queue
      */
-    async stringify(value) {
+    stringify(value) {
         return value; // JSON.stringify(value);
     }
     /**
@@ -93,7 +93,7 @@ class DefaultQueueStore {
      * @param value The queue to parse
      * @returns The parsed queue
      */
-    async parse(value) {
+    parse(value) {
         return value; // JSON.parse(value)
     }
 }

package/dist/cjs/structures/Types/Queue.d.ts

@@ -1,4 +1,5 @@
 import type { Track, UnresolvedTrack } from "./Track.js";
+import type { Awaitable } from "./Utils.js";
 export interface StoredQueue {
     current: Track | null;
     previous: Track[];
@@ -6,15 +7,15 @@ export interface StoredQueue {
 }
 export interface QueueStoreManager {
     /** @async get a Value (MUST RETURN UNPARSED!) */
-    get: (guildId: string) => Promise<StoredQueue | string>;
+    get: (guildId: string) => Awaitable<StoredQueue | string>;
     /** @async Set a value inside a guildId (MUST BE UNPARSED) */
-    set: (guildId: string, value: StoredQueue | string) => Promise<void | boolean>;
+    set: (guildId: string, value: StoredQueue | string) => Awaitable<void | boolean>;
     /** @async Delete a Database Value based of it's guildId */
-    delete: (guildId: string) => Promise<void | boolean>;
+    delete: (guildId: string) => Awaitable<void | boolean>;
     /** @async Transform the value(s) inside of the QueueStoreManager (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
-    stringify: (value: StoredQueue | string) => Promise<StoredQueue | string>;
+    stringify: (value: StoredQueue | string) => Awaitable<StoredQueue | string>;
     /** @async Parse the saved value back to the Queue (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
-    parse: (value: StoredQueue | string) => Promise<Partial<StoredQueue>>;
+    parse: (value: StoredQueue | string) => Awaitable<Partial<StoredQueue>>;
 }
 export interface ManagerQueueOptions {
     /** Maximum Amount of tracks for the queue.previous array. Set to 0 to not save previous songs. Defaults to 25 Tracks */

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

@@ -74,6 +74,8 @@ export interface Exception {
     message: string;
     /** Cause by lavalink */
     cause: string;
+    /** causeStackTrace by lavalink */
+    causeStackTrace: string;
 }
 export interface PlayerEvent {
     op: "event";
@@ -438,3 +440,4 @@ export type LavaSearchQuery = {
     /** The Types to filter the search to */
     types?: LavaSearchType[];
 };
+export type Awaitable<T> = Promise<T> | T;

package/dist/esm/structures/Node.js

@@ -129,6 +129,8 @@ export class LavalinkNode {
         const { response, options } = await this.rawRequest(endpoint, modify);
         if (["DELETE", "PUT"].includes(options.method))
             return;
+        if (response.status === 204)
+            return; // no content
         if (response.status === 404)
             throw new Error(`Node Request resulted into an error, request-PATH: ${options.path} | headers: ${safeStringify(response.headers)}`);
         return parseAsText ? await response.text() : await response.json();
@@ -726,7 +728,9 @@ export class LavalinkNode {
             if (!this.info.plugins.find(v => v.name === "lavasrc-plugin") &&
                 !this.info.plugins.find(v => v.name === "java-lyrics-plugin"))
                 throw new RangeError(`there is no lyrics source (via lavasrc-plugin / java-lyrics-plugin) available in the lavalink node (required for lyrics): ${this.id}`);
-            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/unsubscribe`);
+            return await this.request(`/sessions/${this.sessionId}/players/${guildId}/lyrics/subscribe`, (options) => {
+                options.method = "DELETE";
+            });
         },
     };
     /**

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

@@ -196,7 +196,6 @@ export declare class Player {
     getLyrics(track: Track, skipTrackSource?: boolean): Promise<import("./Types/Node.js").LyricsResult>;
     /**
      * Subscribe to the lyrics event on a specific guild to active live lyrics events
-     * @param guildId The guild id to subscribe to
      * @returns The unsubscribe function
      * @example
      * ```ts
@@ -206,14 +205,13 @@ export declare class Player {
     subscribeLyrics(): Promise<unknown>;
     /**
      * Unsubscribe from the lyrics event on a specific guild to disable live lyrics events
-     * @param guildId The guild id to unsubscribe from
      * @returns The unsubscribe function
      * @example
      * ```ts
      * const lyrics = await player.unsubscribeLyrics();
      * ```
      */
-    unsubscribeLyrics(guildId: string): Promise<void>;
+    unsubscribeLyrics(): Promise<void>;
     /**
      * Move the player on a different Audio-Node
      * @param newNode New Node / New Node Id

package/dist/esm/structures/Player.js

@@ -628,7 +628,6 @@ export class Player {
     }
     /**
      * Subscribe to the lyrics event on a specific guild to active live lyrics events
-     * @param guildId The guild id to subscribe to
      * @returns The unsubscribe function
      * @example
      * ```ts
@@ -640,15 +639,14 @@ export class Player {
     }
     /**
      * Unsubscribe from the lyrics event on a specific guild to disable live lyrics events
-     * @param guildId The guild id to unsubscribe from
      * @returns The unsubscribe function
      * @example
      * ```ts
      * const lyrics = await player.unsubscribeLyrics();
      * ```
      */
-    unsubscribeLyrics(guildId) {
-        return this.node.lyrics.unsubscribe(guildId);
+    unsubscribeLyrics() {
+        return this.node.lyrics.unsubscribe(this.guildId);
     }
     /**
      * Move the player on a different Audio-Node

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

@@ -46,32 +46,32 @@ export declare class DefaultQueueStore implements QueueStoreManager {
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    get(guildId: string): Promise<StoredQueue>;
+    get(guildId: string): StoredQueue;
     /**
      * Set the queue for a guild
      * @param guildId The guild ID
      * @param valueToStringify The queue to set
      * @returns The queue for the guild
      */
-    set(guildId: string, valueToStringify: any): Promise<boolean>;
+    set(guildId: string, valueToStringify: any): boolean;
     /**
      * Delete the queue for a guild
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    delete(guildId: string): Promise<boolean>;
+    delete(guildId: string): boolean;
     /**
      * Stringify the queue for a guild
      * @param value The queue to stringify
      * @returns The stringified queue
      */
-    stringify(value: StoredQueue): Promise<StoredQueue>;
+    stringify(value: StoredQueue | string): StoredQueue | string;
     /**
      * Parse the queue for a guild
      * @param value The queue to parse
      * @returns The parsed queue
      */
-    parse(value: StoredQueue): Promise<StoredQueue>;
+    parse(value: StoredQueue | string): Partial<StoredQueue>;
 }
 export declare class Queue {
     readonly tracks: (Track | UnresolvedTrack)[];

package/dist/esm/structures/Queue.js

@@ -56,7 +56,7 @@ export class DefaultQueueStore {
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    async get(guildId) {
+    get(guildId) {
         return this.data.get(guildId);
     }
     /**
@@ -65,7 +65,7 @@ export class DefaultQueueStore {
      * @param valueToStringify The queue to set
      * @returns The queue for the guild
      */
-    async set(guildId, valueToStringify) {
+    set(guildId, valueToStringify) {
         return this.data.set(guildId, valueToStringify) ? true : false;
     }
     /**
@@ -73,7 +73,7 @@ export class DefaultQueueStore {
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    async delete(guildId) {
+    delete(guildId) {
         return this.data.delete(guildId);
     }
     /**
@@ -81,7 +81,7 @@ export class DefaultQueueStore {
      * @param value The queue to stringify
      * @returns The stringified queue
      */
-    async stringify(value) {
+    stringify(value) {
         return value; // JSON.stringify(value);
     }
     /**
@@ -89,7 +89,7 @@ export class DefaultQueueStore {
      * @param value The queue to parse
      * @returns The parsed queue
      */
-    async parse(value) {
+    parse(value) {
         return value; // JSON.parse(value)
     }
 }

package/dist/esm/structures/Types/Queue.d.ts

@@ -1,4 +1,5 @@
 import type { Track, UnresolvedTrack } from "./Track.js";
+import type { Awaitable } from "./Utils.js";
 export interface StoredQueue {
     current: Track | null;
     previous: Track[];
@@ -6,15 +7,15 @@ export interface StoredQueue {
 }
 export interface QueueStoreManager {
     /** @async get a Value (MUST RETURN UNPARSED!) */
-    get: (guildId: string) => Promise<StoredQueue | string>;
+    get: (guildId: string) => Awaitable<StoredQueue | string>;
     /** @async Set a value inside a guildId (MUST BE UNPARSED) */
-    set: (guildId: string, value: StoredQueue | string) => Promise<void | boolean>;
+    set: (guildId: string, value: StoredQueue | string) => Awaitable<void | boolean>;
     /** @async Delete a Database Value based of it's guildId */
-    delete: (guildId: string) => Promise<void | boolean>;
+    delete: (guildId: string) => Awaitable<void | boolean>;
     /** @async Transform the value(s) inside of the QueueStoreManager (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
-    stringify: (value: StoredQueue | string) => Promise<StoredQueue | string>;
+    stringify: (value: StoredQueue | string) => Awaitable<StoredQueue | string>;
     /** @async Parse the saved value back to the Queue (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
-    parse: (value: StoredQueue | string) => Promise<Partial<StoredQueue>>;
+    parse: (value: StoredQueue | string) => Awaitable<Partial<StoredQueue>>;
 }
 export interface ManagerQueueOptions {
     /** Maximum Amount of tracks for the queue.previous array. Set to 0 to not save previous songs. Defaults to 25 Tracks */

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

@@ -74,6 +74,8 @@ export interface Exception {
     message: string;
     /** Cause by lavalink */
     cause: string;
+    /** causeStackTrace by lavalink */
+    causeStackTrace: string;
 }
 export interface PlayerEvent {
     op: "event";
@@ -438,3 +440,4 @@ export type LavaSearchQuery = {
     /** The Types to filter the search to */
     types?: LavaSearchType[];
 };
+export type Awaitable<T> = Promise<T> | T;

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

@@ -196,7 +196,6 @@ export declare class Player {
     getLyrics(track: Track, skipTrackSource?: boolean): Promise<import("./Types/Node").LyricsResult>;
     /**
      * Subscribe to the lyrics event on a specific guild to active live lyrics events
-     * @param guildId The guild id to subscribe to
      * @returns The unsubscribe function
      * @example
      * ```ts
@@ -206,14 +205,13 @@ export declare class Player {
     subscribeLyrics(): Promise<unknown>;
     /**
      * Unsubscribe from the lyrics event on a specific guild to disable live lyrics events
-     * @param guildId The guild id to unsubscribe from
      * @returns The unsubscribe function
      * @example
      * ```ts
      * const lyrics = await player.unsubscribeLyrics();
      * ```
      */
-    unsubscribeLyrics(guildId: string): Promise<void>;
+    unsubscribeLyrics(): Promise<void>;
     /**
      * Move the player on a different Audio-Node
      * @param newNode New Node / New Node Id

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

@@ -46,32 +46,32 @@ export declare class DefaultQueueStore implements QueueStoreManager {
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    get(guildId: string): Promise<StoredQueue>;
+    get(guildId: string): StoredQueue;
     /**
      * Set the queue for a guild
      * @param guildId The guild ID
      * @param valueToStringify The queue to set
      * @returns The queue for the guild
      */
-    set(guildId: string, valueToStringify: any): Promise<boolean>;
+    set(guildId: string, valueToStringify: any): boolean;
     /**
      * Delete the queue for a guild
      * @param guildId The guild ID
      * @returns The queue for the guild
      */
-    delete(guildId: string): Promise<boolean>;
+    delete(guildId: string): boolean;
     /**
      * Stringify the queue for a guild
      * @param value The queue to stringify
      * @returns The stringified queue
      */
-    stringify(value: StoredQueue): Promise<StoredQueue>;
+    stringify(value: StoredQueue | string): StoredQueue | string;
     /**
      * Parse the queue for a guild
      * @param value The queue to parse
      * @returns The parsed queue
      */
-    parse(value: StoredQueue): Promise<StoredQueue>;
+    parse(value: StoredQueue | string): Partial<StoredQueue>;
 }
 export declare class Queue {
     readonly tracks: (Track | UnresolvedTrack)[];

package/dist/types/structures/Types/Queue.d.ts

@@ -1,4 +1,5 @@
 import type { Track, UnresolvedTrack } from "./Track";
+import type { Awaitable } from "./Utils";
 export interface StoredQueue {
     current: Track | null;
     previous: Track[];
@@ -6,15 +7,15 @@ export interface StoredQueue {
 }
 export interface QueueStoreManager {
     /** @async get a Value (MUST RETURN UNPARSED!) */
-    get: (guildId: string) => Promise<StoredQueue | string>;
+    get: (guildId: string) => Awaitable<StoredQueue | string>;
     /** @async Set a value inside a guildId (MUST BE UNPARSED) */
-    set: (guildId: string, value: StoredQueue | string) => Promise<void | boolean>;
+    set: (guildId: string, value: StoredQueue | string) => Awaitable<void | boolean>;
     /** @async Delete a Database Value based of it's guildId */
-    delete: (guildId: string) => Promise<void | boolean>;
+    delete: (guildId: string) => Awaitable<void | boolean>;
     /** @async Transform the value(s) inside of the QueueStoreManager (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
-    stringify: (value: StoredQueue | string) => Promise<StoredQueue | string>;
+    stringify: (value: StoredQueue | string) => Awaitable<StoredQueue | string>;
     /** @async Parse the saved value back to the Queue (IF YOU DON'T NEED PARSING/STRINGIFY, then just return the value) */
-    parse: (value: StoredQueue | string) => Promise<Partial<StoredQueue>>;
+    parse: (value: StoredQueue | string) => Awaitable<Partial<StoredQueue>>;
 }
 export interface ManagerQueueOptions {
     /** Maximum Amount of tracks for the queue.previous array. Set to 0 to not save previous songs. Defaults to 25 Tracks */

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

@@ -74,6 +74,8 @@ export interface Exception {
     message: string;
     /** Cause by lavalink */
     cause: string;
+    /** causeStackTrace by lavalink */
+    causeStackTrace: string;
 }
 export interface PlayerEvent {
     op: "event";
@@ -438,3 +440,4 @@ export type LavaSearchQuery = {
     /** The Types to filter the search to */
     types?: LavaSearchType[];
 };
+export type Awaitable<T> = Promise<T> | T;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "lavalink-client",
-  "version": "2.5.5",
+  "version": "2.5.7",
   "description": "Easy, flexible and feature-rich lavalink@v4 Client. Both for Beginners and Proficients.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
-  "types": "dist/types/index.d.js",
+  "types": "dist/types/index.d.ts",
   "scripts": {
     "build": "npm run tool:clean && npm run build:all && npm run tool:fixbuild",
     "build:bun": "bun run tool:clean && bun run build:all:bun && bun run tool:fixbuild",
@@ -60,7 +60,7 @@
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.27.0",
-    "@types/node": "^22.15.18",
+    "@types/node": "^24.0.11",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.32.1",
     "@typescript-eslint/parser": "^8.32.1",
@@ -70,7 +70,7 @@
   },
   "dependencies": {
     "tslib": "^2.8.1",
-    "ws": "^8.18.2"
+    "ws": "^8.18.3"
   },
   "engines": {
     "node": ">=18.0.0",