lavacord 2.0.0 → 2.0.2

package/dist/lib/Manager.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Manager = void 0;
+const events_1 = require("events");
+const LavalinkNode_1 = require("./LavalinkNode");
+const Player_1 = require("./Player");
+/**
+ * The class that handles everything to do with Lavalink. it is the hub of the library basically
+ */
+class Manager extends events_1.EventEmitter {
+    /**
+     * A [**Map**](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map) of Lavalink Nodes
+     */
+    nodes = new Map();
+    /**
+     * A [**Map**](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map) of all the players
+     */
+    players = new Map();
+    /**
+     * A [**Map**](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map) of all the VOICE_SERVER_UPDATE States
+     */
+    voiceServers = new Map();
+    /**
+     * A [**Map**](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map) of all the VOICE_STATE_UPDATE States
+     */
+    voiceStates = new Map();
+    /**
+     * The user id of the bot this Manager is managing
+     */
+    user;
+    /**
+     * The send function needs for the library to function
+     */
+    send;
+    /**
+     * The Player the manager will use when creating new Players
+     */
+    Player = Player_1.Player;
+    /**
+     * An Set of all the expecting connections guild id's
+     */
+    expecting = new Set();
+    /**
+     * The constructor of the Manager
+     * @param nodes A Array of {@link LavalinkNodeOptions} that the Manager will connect to
+     * @param options The options for the Manager {@link ManagerOptions}
+     */
+    constructor(nodes, options) {
+        super();
+        if (options.user)
+            this.user = options.user;
+        if (options.player)
+            this.Player = options.player;
+        if (options.send)
+            this.send = options.send;
+        for (const node of nodes)
+            this.createNode(node);
+        setImmediate(() => {
+            if (this.send)
+                this.send = () => undefined;
+        });
+    }
+    /**
+     * Connects all the {@link LavalinkNode} to the respective Lavalink instance
+     */
+    connect() {
+        return Promise.all([...this.nodes.values()].map(node => node.connect()));
+    }
+    /**
+     * Disconnects everything, basically destorying the manager.
+     * Stops all players, leaves all voice channels then disconnects all LavalinkNodes
+     */
+    disconnect() {
+        const promises = [];
+        for (const id of [...this.players.keys()])
+            promises.push(this.leave(id));
+        for (const node of [...this.nodes.values()])
+            node.destroy();
+        return Promise.all(promises);
+    }
+    /**
+     * Creating a {@link LavalinkNode} and adds it to the the nodes Map
+     * @param options The node options of the node you're creating
+     */
+    createNode(options) {
+        const node = new LavalinkNode_1.LavalinkNode(this, options);
+        this.nodes.set(options.id, node);
+        return node;
+    }
+    /**
+     * Disconnects and Deletes the specified node
+     * @param id The id of the node you want to remove
+     */
+    removeNode(id) {
+        const node = this.nodes.get(id);
+        if (!node)
+            return false;
+        return node.destroy() && this.nodes.delete(id);
+    }
+    /**
+     * Connects the bot to the selected voice channel
+     * @param data The Join Data
+     * @param joinOptions Selfmute and Selfdeaf options, if you want the bot to be deafen or muted upon joining
+     */
+    async join(data, joinOptions = {}) {
+        const player = this.players.get(data.guild);
+        if (player)
+            return player;
+        await this.sendWS(data.guild, data.channel, joinOptions);
+        return this.spawnPlayer(data);
+    }
+    /**
+     * Leaves the specified voice channel
+     * @param guild The guild you want the bot to leave the voice channel of
+     */
+    async leave(guild) {
+        await this.sendWS(guild, null);
+        const player = this.players.get(guild);
+        if (!player)
+            return false;
+        if (player.listenerCount("end") && player.playing)
+            player.emit("end", { encodedTrack: player.track, op: "event", type: "TrackEndEvent", reason: "CLEANUP", guildId: guild });
+        player.removeAllListeners();
+        await player.destroy();
+        return this.players.delete(guild);
+    }
+    /**
+     * Switch a player from one node to another, this is to implement fallback
+     * @param player The player you want to switch nodes with
+     * @param node The node you want to switch to
+     */
+    async switch(player, node) {
+        const { track, state, voiceUpdateState } = { ...player };
+        const position = state.position ? state.position + 2000 : 2000;
+        if (!voiceUpdateState) {
+            player.node = node;
+            return player;
+        }
+        await player.destroy();
+        player.node = node;
+        await player.play(track, {
+            position,
+            volume: state.filters.volume || 1.0,
+            filters: state.filters,
+            voice: {
+                token: voiceUpdateState.event.token,
+                endpoint: voiceUpdateState.event.endpoint,
+                sessionId: voiceUpdateState.sessionId
+            }
+        });
+        return player;
+    }
+    /**
+     * For handling voiceServerUpdate from the user's library of choice
+     * @param data The data directly from discord
+     */
+    voiceServerUpdate(data) {
+        this.voiceServers.set(data.guild_id, data);
+        this.expecting.add(data.guild_id);
+        return this._attemptConnection(data.guild_id);
+    }
+    /**
+     * For handling voiceStateUpdate from the user's library of choice
+     * @param data The data directly from discord
+     */
+    voiceStateUpdate(data) {
+        if (data.user_id !== this.user)
+            return Promise.resolve(false);
+        if (data.channel_id) {
+            this.voiceStates.set(data.guild_id, data);
+            return this._attemptConnection(data.guild_id);
+        }
+        this.voiceServers.delete(data.guild_id);
+        this.voiceStates.delete(data.guild_id);
+        return Promise.resolve(false);
+    }
+    /**
+     * Just a utility method to easily send OPCode 4 websocket events to discord
+     * @param guild The guild is
+     * @param channel Voice channel id, or null to leave a voice channel
+     * @param param2 Selfmute and Selfdeaf options, if you want the bot to be deafen or muted upon joining
+     */
+    sendWS(guild, channel, { selfmute = false, selfdeaf = false } = {}) {
+        return this.send({
+            op: 4,
+            d: {
+                guild_id: guild,
+                channel_id: channel,
+                self_mute: selfmute,
+                self_deaf: selfdeaf
+            }
+        });
+    }
+    /**
+     * Gets all connected nodes, sorts them by cou load of the node
+     */
+    get idealNodes() {
+        return [...this.nodes.values()]
+            .filter(node => node.connected)
+            .sort((a, b) => {
+            const aload = a.stats.cpu ? a.stats.cpu.systemLoad / a.stats.cpu.cores * 100 : 0;
+            const bload = b.stats.cpu ? b.stats.cpu.systemLoad / b.stats.cpu.cores * 100 : 0;
+            return aload - bload;
+        });
+    }
+    /**
+     * Handles the data of voiceServerUpdate & voiceStateUpdate to see if a connection is possible with the data we have and if it is then make the connection to lavalink
+     * @param guildId The guild id that we're trying to attempt to connect to
+     */
+    async _attemptConnection(guildID) {
+        const server = this.voiceServers.get(guildID);
+        const state = this.voiceStates.get(guildID);
+        if (!server || !state || !this.expecting.has(guildID))
+            return false;
+        const player = this.players.get(guildID);
+        if (!player)
+            return false;
+        await player.connect({ sessionId: state.session_id, event: server });
+        this.expecting.delete(guildID);
+        return true;
+    }
+    /**
+     * This creates the {@link Player}
+     * @param data The Join Data, this is called by {@link Manager.join}
+     */
+    spawnPlayer(data) {
+        const exists = this.players.get(data.guild);
+        if (exists)
+            return exists;
+        const node = this.nodes.get(data.node);
+        if (!node)
+            throw new Error(`INVALID_HOST: No available node with ${data.node}`);
+        const player = new this.Player(node, data.guild);
+        this.players.set(data.guild, player);
+        return player;
+    }
+}
+exports.Manager = Manager;
+//# sourceMappingURL=Manager.js.map

package/dist/lib/Manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manager.js","sourceRoot":"","sources":["../../src/lib/Manager.ts"],"names":[],"mappings":"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"}

package/dist/lib/Player.d.ts

@@ -0,0 +1,139 @@
+import { EventEmitter } from "events";
+import type { LavalinkNode } from "./LavalinkNode";
+import type { Manager } from "./Manager";
+import type { PlayerUpdateVoiceState, JoinOptions } from "./Types";
+import type { EventOP, PlayerState, Equalizer, Filters, PlayerUpdate, UpdatePlayerData, UpdatePlayerResult, DestroyPlayerResult } from "lavalink-types";
+/**
+ * The Player class, this handles everything to do with the guild sides of things, like playing, stoping, pausing, resuming etc
+ */
+export declare class Player extends EventEmitter {
+    node: LavalinkNode;
+    id: string;
+    /**
+     * The PlayerState of this Player
+     */
+    state: Partial<PlayerState> & {
+        filters: Filters;
+    };
+    /**
+     * Whether or not the player is actually playing anything
+     */
+    playing: boolean;
+    /**
+     * When the track started playing
+     */
+    timestamp: number | null;
+    /**
+     * Whether or not the song that is playing is paused or not
+     */
+    paused: boolean;
+    /**
+     * The current track in Lavalink's base64 string form
+     */
+    track: string | null;
+    /**
+     * The voiceUpdateState of the player, used for swtiching nodes
+     */
+    voiceUpdateState: PlayerUpdateVoiceState | null;
+    /**
+     * The constructor of the player
+     * @param node The Lavalink of the player
+     * @param id the id of the player, aka the guild id
+     */
+    constructor(node: LavalinkNode, id: string);
+    /**
+     * Updates the current player on lavalink
+     * @param options Update options
+     * @param noReplace If the event should be dropped if there's a currently playing track should encodedTrack or identifier be present in options
+     */
+    update(options: UpdatePlayerData, noReplace?: boolean): Promise<UpdatePlayerResult>;
+    /**
+     * Plays the specified song using the base64 string from lavalink
+     * @param track The base64 string of the song that you want to play
+     * @param options Play options
+     */
+    play(track: string, options?: Omit<UpdatePlayerData, "encodedTrack" | "identifier"> & {
+        noReplace?: boolean;
+    }): Promise<UpdatePlayerResult>;
+    /**
+     * Stops the music, depending on how the end event is handled this will either stop
+     */
+    stop(): Promise<UpdatePlayerData>;
+    /**
+     * Pauses/Resumes the song depending on what is specified
+     * @param pause Whether or not to pause whats currently playing
+     */
+    pause(pause: boolean): Promise<UpdatePlayerData>;
+    /**
+     * Resumes the current song
+     */
+    resume(): Promise<UpdatePlayerData>;
+    /**
+     * Changes the volume, only for the current song
+     * @param volume The volume as a float from 0.0 to 10.0. 1.0 is default.
+     */
+    volume(volume: number): Promise<UpdatePlayerData>;
+    /**
+     * Seeks the current song to a certain position
+     * @param position Seeks the song to the position specified in milliseconds, use the duration of the song from lavalink to get the duration
+     */
+    seek(position: number): Promise<UpdatePlayerData>;
+    filters(options: Filters): Promise<UpdatePlayerData>;
+    /**
+     * Sets the equalizer of the current song, if you wanted to do something like bassboost
+     * @param bands The bands that you want lavalink to modify read [IMPLEMENTATION.md](https://github.com/freyacodes/Lavalink/blob/master/IMPLEMENTATION.md#outgoing-messages) for more information
+     */
+    equalizer(bands: Equalizer[]): Promise<UpdatePlayerData>;
+    /**
+     * Sends a destroy signal to lavalink, basically just a cleanup op for lavalink to clean its shit up
+     */
+    destroy(): Promise<DestroyPlayerResult>;
+    /**
+     * Sends voiceUpdate information to lavalink so it can connect to discords voice servers properly
+     * @param data The data lavalink needs to connect and recieve data from discord
+     */
+    connect(data: PlayerUpdateVoiceState): Promise<UpdatePlayerData>;
+    /**
+     * Use this to switch channels
+     * @param channel The channel id of the channel you want to switch to
+     * @param options selfMute and selfDeaf options
+     */
+    switchChannel(channel: string, options?: JoinOptions): any;
+    /**
+     * The manager that created the player
+     */
+    get manager(): Manager;
+}
+export interface PlayerEvents {
+    event: [EventOP];
+    start: [Extract<EventOP, {
+        type: "TrackStartEvent";
+    }>];
+    end: [Extract<EventOP, {
+        type: "TrackEndEvent" | "TrackStuckEvent";
+    }>];
+    pause: [boolean];
+    seek: [number];
+    error: [Extract<EventOP, {
+        type: "TrackExceptionEvent" | "WebSocketClosedEvent";
+    }>];
+    warn: [string];
+    volume: [number];
+    playerUpdate: [PlayerUpdate];
+    filters: [Filters];
+}
+export interface Player {
+    addListener<E extends keyof PlayerEvents>(event: E, listener: (...args: PlayerEvents[E]) => any): this;
+    emit<E extends keyof PlayerEvents>(event: E, ...args: PlayerEvents[E]): boolean;
+    eventNames(): Array<keyof PlayerEvents>;
+    listenerCount(event: keyof PlayerEvents): number;
+    listeners(event: keyof PlayerEvents): Array<(...args: Array<any>) => any>;
+    off<E extends keyof PlayerEvents>(event: E, listener: (...args: PlayerEvents[E]) => any): this;
+    on<E extends keyof PlayerEvents>(event: E, listener: (...args: PlayerEvents[E]) => any): this;
+    once<E extends keyof PlayerEvents>(event: E, listener: (...args: PlayerEvents[E]) => any): this;
+    prependListener<E extends keyof PlayerEvents>(event: E, listener: (...args: PlayerEvents[E]) => any): this;
+    prependOnceListener<E extends keyof PlayerEvents>(event: E, listener: (...args: PlayerEvents[E]) => any): this;
+    rawListeners(event: keyof PlayerEvents): Array<(...args: Array<any>) => any>;
+    removeAllListeners(event?: keyof PlayerEvents): this;
+    removeListener<E extends keyof PlayerEvents>(event: E, listener: (...args: PlayerEvents[E]) => any): this;
+}

package/dist/lib/Player.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Player = void 0;
+const events_1 = require("events");
+const Rest_1 = require("./Rest");
+/**
+ * The Player class, this handles everything to do with the guild sides of things, like playing, stoping, pausing, resuming etc
+ */
+class Player extends events_1.EventEmitter {
+    node;
+    id;
+    /**
+     * The PlayerState of this Player
+     */
+    state = { filters: {} };
+    /**
+     * Whether or not the player is actually playing anything
+     */
+    playing = false;
+    /**
+     * When the track started playing
+     */
+    timestamp = null;
+    /**
+     * Whether or not the song that is playing is paused or not
+     */
+    paused = false;
+    /**
+     * The current track in Lavalink's base64 string form
+     */
+    track = null;
+    /**
+     * The voiceUpdateState of the player, used for swtiching nodes
+     */
+    voiceUpdateState = null;
+    /**
+     * The constructor of the player
+     * @param node The Lavalink of the player
+     * @param id the id of the player, aka the guild id
+     */
+    constructor(node, id) {
+        super();
+        this.node = node;
+        this.id = id;
+        this.on("event", data => {
+            switch (data.type) {
+                case "TrackStartEvent":
+                    if (this.listenerCount("start"))
+                        this.emit("start", data);
+                    break;
+                case "TrackEndEvent":
+                    if (data.reason !== "REPLACED")
+                        this.playing = false;
+                    this.track = null;
+                    this.timestamp = null;
+                    if (this.listenerCount("end"))
+                        this.emit("end", data);
+                    break;
+                case "TrackExceptionEvent":
+                    if (this.listenerCount("error"))
+                        this.emit("error", data);
+                    break;
+                case "TrackStuckEvent":
+                    this.stop();
+                    if (this.listenerCount("end"))
+                        this.emit("end", data);
+                    break;
+                case "WebSocketClosedEvent":
+                    if (this.listenerCount("error"))
+                        this.emit("error", data);
+                    break;
+                default:
+                    if (this.listenerCount("warn"))
+                        this.emit("warn", `Unexpected event type: ${data.type}`);
+                    break;
+            }
+        })
+            .on("playerUpdate", data => {
+            this.state = { filters: this.state.filters, ...data.state };
+        });
+    }
+    /**
+     * Updates the current player on lavalink
+     * @param options Update options
+     * @param noReplace If the event should be dropped if there's a currently playing track should encodedTrack or identifier be present in options
+     */
+    async update(options, noReplace = false) {
+        const d = await Rest_1.Rest.updatePlayer(this.node, this.id, options, noReplace);
+        if (d.track)
+            this.track = d.track.encoded;
+        return d;
+    }
+    /**
+     * Plays the specified song using the base64 string from lavalink
+     * @param track The base64 string of the song that you want to play
+     * @param options Play options
+     */
+    async play(track, options) {
+        const noReplace = options ? options.noReplace : false;
+        if (options)
+            delete options.noReplace;
+        const d = await this.update(Object.assign({ encodedTrack: track }, options), noReplace);
+        this.playing = true;
+        this.timestamp = Date.now();
+        return d;
+    }
+    /**
+     * Stops the music, depending on how the end event is handled this will either stop
+     */
+    async stop() {
+        const d = await this.update({ encodedTrack: null });
+        this.playing = false;
+        this.timestamp = null;
+        return d;
+    }
+    /**
+     * Pauses/Resumes the song depending on what is specified
+     * @param pause Whether or not to pause whats currently playing
+     */
+    async pause(pause) {
+        const d = await this.update({ paused: pause });
+        this.paused = pause;
+        if (this.listenerCount("pause"))
+            this.emit("pause", pause);
+        return d;
+    }
+    /**
+     * Resumes the current song
+     */
+    resume() {
+        return this.pause(false);
+    }
+    /**
+     * Changes the volume, only for the current song
+     * @param volume The volume as a float from 0.0 to 10.0. 1.0 is default.
+     */
+    async volume(volume) {
+        const d = await this.update({ volume: volume * 100 });
+        if (this.listenerCount("volume"))
+            this.emit("volume", volume);
+        return d;
+    }
+    /**
+     * Seeks the current song to a certain position
+     * @param position Seeks the song to the position specified in milliseconds, use the duration of the song from lavalink to get the duration
+     */
+    async seek(position) {
+        const d = await this.update({ position });
+        if (this.listenerCount("seek"))
+            this.emit("seek", position);
+        return d;
+    }
+    async filters(options) {
+        const d = await this.update({ filters: options });
+        this.state.filters = options;
+        if (this.listenerCount("filters"))
+            this.emit("filters", options);
+        return d;
+    }
+    /**
+     * Sets the equalizer of the current song, if you wanted to do something like bassboost
+     * @param bands The bands that you want lavalink to modify read [IMPLEMENTATION.md](https://github.com/freyacodes/Lavalink/blob/master/IMPLEMENTATION.md#outgoing-messages) for more information
+     */
+    async equalizer(bands) {
+        const newFilters = Object.assign(this.state.filters, { equalizer: bands });
+        const d = await this.filters(newFilters);
+        return d;
+    }
+    /**
+     * Sends a destroy signal to lavalink, basically just a cleanup op for lavalink to clean its shit up
+     */
+    async destroy() {
+        const d = await Rest_1.Rest.destroyPlayer(this.node, this.id);
+        if (d && d.error)
+            throw new Error(d.message);
+        return d;
+    }
+    /**
+     * Sends voiceUpdate information to lavalink so it can connect to discords voice servers properly
+     * @param data The data lavalink needs to connect and recieve data from discord
+     */
+    connect(data) {
+        this.voiceUpdateState = data;
+        return this.update({ voice: { token: data.event.token, endpoint: data.event.endpoint, sessionId: data.sessionId } });
+    }
+    /**
+     * Use this to switch channels
+     * @param channel The channel id of the channel you want to switch to
+     * @param options selfMute and selfDeaf options
+     */
+    switchChannel(channel, options = {}) {
+        return this.manager.sendWS(this.id, channel, options);
+    }
+    /**
+     * The manager that created the player
+     */
+    get manager() {
+        return this.node.manager;
+    }
+}
+exports.Player = Player;
+//# sourceMappingURL=Player.js.map

package/dist/lib/Player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Player.js","sourceRoot":"","sources":["../../src/lib/Player.ts"],"names":[],"mappings":"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"}

package/dist/lib/Rest.d.ts

@@ -0,0 +1,63 @@
+import type { LavalinkNode } from "./LavalinkNode";
+import type { TrackLoadingResult, DecodeTrackResult, DecodeTracksResult, GetLavalinkVersionResult, UpdateSessionResult, ErrorResponse, UpdatePlayerData, UpdatePlayerResult, DestroyPlayerResult } from "lavalink-types";
+export declare class RestError extends Error {
+    json: ErrorResponse;
+    constructor(data: ErrorResponse);
+}
+/**
+ * A Rest helper for Lavalink
+ */
+export declare class Rest {
+    /**
+     * Private base request function
+     * @param node The lavalink node
+     * @param path Route starting with /
+     * @param init Request init if any
+     * @param requires Properties of the lavalink node the route requires
+     * @throws {RestError} If lavalink encounters an error
+     */
+    private static baseRequest;
+    /**
+     * A helper for /v?/loadtracks endpoint
+     * @param node The LavalinkNode
+     * @param identifer The thing you want to load
+     * @throws {RestError} If lavalink encounters an error
+     */
+    static load(node: LavalinkNode, identifer: string): Promise<TrackLoadingResult>;
+    /**
+     * A helper for /v?/decodetrack & /v?/decodetracks
+     * @param node The lavalink node
+     * @param track The track(s) you want to decode
+     * @throws {RestError} If lavalink encounters an error
+     */
+    static decode(node: LavalinkNode, track: string): Promise<DecodeTrackResult>;
+    static decode(node: LavalinkNode, tracks: string[]): Promise<DecodeTracksResult>;
+    /**
+     * A helper for /version
+     * @param node The lavalink node
+     * @throws {RestError} If lavalink encounters an error
+     */
+    static version(node: LavalinkNode): Promise<GetLavalinkVersionResult>;
+    /**
+     * A helper for PATCH /v?/sessions/:sessionId
+     * @param node The lavalink node
+     * @throws {RestError} If lavalink encounters an error
+     */
+    static updateSession(node: LavalinkNode): Promise<UpdateSessionResult>;
+    /**
+     * A helper for PATCH /v?/sessions/:sessionId/players/:guildId
+     * @param node The lavalink node
+     * @param guildId The Id of the guild
+     * @param data The update data
+     * @param noReplace If the event should be dropped if there's a currently playing track
+     * @throws {RestError} If lavalink encounters an error
+     */
+    static updatePlayer(node: LavalinkNode, guildId: string, data: UpdatePlayerData, noReplace?: boolean): Promise<UpdatePlayerResult>;
+    /**
+     * A helper for DELETE /v?/sessions/:sessionId/players/:guildId
+     * @param node The lavalink node
+     * @param guildId The Id of the guild
+     * @throws {RestError} If lavalink encounters an error
+     */
+    static destroyPlayer(node: LavalinkNode, guildId: string): Promise<ErrorResponse | DestroyPlayerResult>;
+}