lavacord 2.2.0 → 3.0.0

package/dist/cjs/lib/Manager.cjs

@@ -0,0 +1,405 @@
+'use strict';
+
+var events = require('events');
+var LavalinkNode_cjs = require('./LavalinkNode.cjs');
+var Player_cjs = require('./Player.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var Manager = class extends events.EventEmitter {
+  static {
+    __name(this, "Manager");
+  }
+  /**
+   * A Map of Lavalink Nodes indexed by their IDs.
+   */
+  nodes = /* @__PURE__ */ new Map();
+  /**
+   * A Map of all active players indexed by guild ID.
+   */
+  players = /* @__PURE__ */ new Map();
+  /**
+   * A Map of voice server update states indexed by guild ID.
+   */
+  voiceServers = /* @__PURE__ */ new Map();
+  /**
+   * A Map of voice state update states indexed by guild ID.
+   */
+  voiceStates = /* @__PURE__ */ new Map();
+  /**
+   * The user ID of the bot this Manager is managing.
+   */
+  userId = null;
+  /**
+   * Function to send voice state update packets to Discord.
+   *
+   * @remarks
+   * This can be implemented by the user in two ways:
+   * 1. Via constructor options: `new Manager(nodes, { send: fn })`
+   * 2. Via class extension: `class MyManager extends Manager { send(packet) { ... } }`
+   */
+  _send;
+  /**
+   * The Player class constructor used when creating new players.
+   *
+   * @remarks
+   * Can be overridden in the manager options to use a custom Player implementation.
+   */
+  Player = Player_cjs.Player;
+  /**
+   * A Set of guild IDs that are waiting for a connection.
+   *
+   * @internal
+   */
+  expecting = /* @__PURE__ */ new Set();
+  /**
+   * Creates a new Manager instance.
+   *
+   * @param nodes - An array of Lavalink node options to connect to.
+   * @param options - Configuration options for the Manager.
+   *
+   * @example
+   * ```typescript
+   * // Method 1: Define send function via options
+   * const manager = new Manager([
+   *   {
+   *     id: "main",
+   *     host: "localhost",
+   *     port: 2333,
+   *     password: "youshallnotpass"
+   *   }
+   * ], {
+   *   userId: "bot_user_id",
+   *   send: (packet) => {
+   *     const guild = client.guilds.cache.get(packet.d.guild_id);
+   *     if (guild) guild.shard.send(packet);
+   *   }
+   * });
+   *
+   * // Method 2: Extend Manager class
+   * class MyManager extends Manager {
+   *   send(packet) {
+   *     const guild = this.client.guilds.cache.get(packet.d.guild_id);
+   *     if (guild) guild.shard.send(packet);
+   *   }
+   * }
+   * const manager = new MyManager(nodes, { userId: "bot_user_id" });
+   * ```
+   */
+  constructor(nodes, options) {
+    super();
+    options ??= {};
+    if (options.userId) this.userId = options.userId;
+    if (options.player) this.Player = options.player;
+    if (options.send && !this._send) this._send = options.send;
+    for (const node of nodes) this.createNode(node);
+  }
+  /**
+   * Connects all Lavalink nodes to their respective Lavalink servers.
+   *
+   * @returns A promise that resolves when all connections are established.
+   *
+   * @example
+   * ```typescript
+   * // Connect all nodes
+   * manager.connect()
+   *   .then(() => console.log('All nodes connected!'))
+   *   .catch(error => console.error('Failed to connect nodes:', error));
+   * ```
+   */
+  async connect() {
+    if (!this.userId)
+      throw new Error(
+        "Lavacord requires a client user ID before connecting. \nSet the user ID when constructing the Manager or after your Discord client is ready."
+      );
+    return Promise.all(this.nodes.values().map((node) => node.connect().then(() => node)));
+  }
+  /**
+   * Disconnects all players and nodes, effectively cleaning up all resources.
+   *
+   * @returns A promise that resolves when all disconnections are complete.
+   *
+   * @example
+   * ```typescript
+   * // Disconnect everything
+   * manager.disconnect()
+   *   .then(() => console.log('All players and nodes cleaned up'))
+   *   .catch(error => console.error('Error during disconnection:', error));
+   * ```
+   */
+  async disconnect() {
+    for await (const player of this.players.keys()) await this.leave(player);
+    for (const node of this.nodes.values()) node.destroy();
+  }
+  /**
+   * Creates a new Lavalink node and adds it to the nodes map.
+   *
+   * @param options - Configuration options for the node.
+   * @returns The newly created LavalinkNode instance.
+   *
+   * @example
+   * ```typescript
+   * // Add a new node
+   * const newNode = manager.createNode({
+   *   id: "node2",
+   *   host: "example.com",
+   *   port: 2333,
+   *   password: "securepassword",
+   *   resuming: true
+   * });
+   * ```
+   */
+  createNode(options) {
+    const node = new LavalinkNode_cjs.LavalinkNode(this, options);
+    this.nodes.set(options.id, node);
+    return node;
+  }
+  /**
+   * Disconnects and removes a node from the manager.
+   *
+   * @param id - The ID of the node to remove.
+   * @returns Whether the node was successfully removed.
+   *
+   * @example
+   * ```typescript
+   * // Remove a node
+   * const removed = manager.removeNode("node1");
+   * if (removed) {
+   *   console.log("Node successfully removed");
+   * } else {
+   *   console.log("Node not found");
+   * }
+   * ```
+   */
+  removeNode(id) {
+    const node = this.nodes.get(id);
+    if (!node) return false;
+    node.destroy();
+    return this.nodes.delete(id);
+  }
+  /**
+   * Joins a voice channel and creates a player for the guild.
+   *
+   * @param data - The data needed to join a voice channel.
+   * @param joinOptions - Options for joining the channel (selfmute, selfdeaf).
+   * @returns A promise resolving to the Player instance.
+   *
+   * @example
+   * ```typescript
+   * // Join a voice channel
+   * const player = await manager.join({
+   *   guild: "123456789012345678", // Guild ID
+   *   channel: "123456789012345679", // Voice Channel ID
+   *   node: "main" // Node ID
+   * }, {
+   *   selfdeaf: true // Join deafened
+   * });
+   *
+   * // Now you can use the player to play music
+   * const result = await Rest.load(player.node, "https://www.youtube.com/watch?v=dQw4w9WgXcQ");
+   * await player.play(result.tracks[0].track);
+   * ```
+   */
+  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 a voice channel and cleans up the player.
+   *
+   * @param guild - The ID of the guild to leave.
+   * @returns A promise resolving to whether the operation was successful.
+   *
+   * @example
+   * ```typescript
+   * // Leave a voice channel
+   * const success = await manager.leave("123456789012345678");
+   * if (success) {
+   *   console.log("Successfully left the voice channel");
+   * } else {
+   *   console.log("Not in a voice channel in this guild");
+   * }
+   * ```
+   */
+  async leave(guild) {
+    await this.sendWS(guild, null);
+    const player = this.players.get(guild);
+    if (!player) return false;
+    await player.destroy();
+    return this.players.delete(guild);
+  }
+  /**
+   * Switches a player from one node to another, implementing fallback capability.
+   *
+   * @param player - The player to move to another node.
+   * @param node - The destination node.
+   * @returns A promise resolving to the updated player.
+   *
+   * @example
+   * ```typescript
+   * // Switch a player to another node (e.g. if current node is failing)
+   * const player = manager.players.get("123456789012345678");
+   * const newNode = manager.nodes.get("backup-node");
+   *
+   * if (player && newNode) {
+   *   await manager.switch(player, newNode);
+   *   console.log("Player switched to backup node");
+   * }
+   * ```
+   */
+  async switch(player, node) {
+    player.node = node;
+    if (!player.voice) return player;
+    await player.destroy();
+    if (!player.track) return player;
+    await player.play(player.track.encoded, {
+      position: player.state.position,
+      volume: player.volume,
+      filters: player.filters,
+      voice: player.voice,
+      paused: player.paused,
+      userData: player.track.userData
+    });
+    return player;
+  }
+  /**
+   * Processes voice server update events from Discord.
+   *
+   * @param data - The voice server update data from Discord.
+   * @returns A promise resolving to whether a connection was established.
+   *
+   * @example
+   * ```typescript
+   * // In your Discord.js client events
+   * client.ws.on(GatewayDispatchEvents.VoiceServerUpdate, (data) => {
+   *   manager.voiceServerUpdate(data);
+   * });
+   * ```
+   */
+  voiceServerUpdate(data) {
+    this.voiceServers.set(data.guild_id, data);
+    this.expecting.add(data.guild_id);
+    return this._attemptConnection(data.guild_id);
+  }
+  /**
+   * Processes voice state update events from Discord.
+   *
+   * @param data - The voice state update data from Discord.
+   * @returns A promise resolving to whether a connection was established.
+   *
+   * @example
+   * ```typescript
+   * // In your Discord.js client events
+   * client.ws.on(GatewayDispatchEvents.VoiceStateUpdate, (data) => {
+   *   manager.voiceStateUpdate(data);
+   * });
+   * ```
+   */
+  async voiceStateUpdate(data) {
+    if (data.user_id !== this.userId) return false;
+    if (!data.guild_id) return 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 false;
+  }
+  /**
+   * Sends a voice state update packet to Discord.
+   *
+   * @param guild - The ID of the guild.
+   * @param channel - The ID of the voice channel to join, or null to leave.
+   * @param options - Options for joining (selfmute, selfdeaf).
+   * @returns The result from the send function.
+   *
+   * @example
+   * ```typescript
+   * // Join a voice channel
+   * manager.sendWS("123456789012345678", "123456789012345679", { selfdeaf: true });
+   *
+   * // Leave a voice channel
+   * manager.sendWS("123456789012345678", null);
+   * ```
+   */
+  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, sorted by CPU load.
+   *
+   * @returns An array of connected nodes sorted by CPU load (least to most).
+   *
+   * @example
+   * ```typescript
+   * // Get the node with the least CPU load
+   * const bestNode = manager.idealNodes[0];
+   * if (bestNode) {
+   *   console.log(`Best node for new connections: ${bestNode.id}`);
+   * }
+   * ```
+   */
+  get idealNodes() {
+    return Array.from(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;
+    });
+  }
+  /**
+   * Attempts to establish a connection for a guild using available voice data.
+   *
+   * @internal
+   * @param guildID - The ID of the guild to attempt connecting.
+   * @returns A promise resolving to whether a connection was established.
+   */
+  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;
+  }
+  /**
+   * Creates a new player instance.
+   *
+   * @internal
+   * @param data - The data needed to create a player.
+   * @returns The created Player instance.
+   */
+  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;
+  }
+  send(packet) {
+    if (typeof this._send !== "function") {
+      throw new Error(
+        "Lavacord requires a send function to be defined in the Manager options.				This function should send voice state updates to Discord."
+      );
+    }
+    return this._send(packet);
+  }
+};
+
+exports.Manager = Manager;
+//# sourceMappingURL=Manager.cjs.map
+//# sourceMappingURL=Manager.cjs.map

package/dist/cjs/lib/Manager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/Manager.ts"],"names":["EventEmitter","Player","LavalinkNode"],"mappings":"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","file":"Manager.cjs","sourcesContent":["import { EventEmitter } from \"events\";\nimport { LavalinkNode } from \"./LavalinkNode\";\nimport { Player } from \"./Player\";\nimport type { JoinData, ManagerOptions, JoinOptions, LavalinkNodeOptions, ManagerEvents } from \"./Types\";\nimport { GatewayVoiceServerUpdateDispatchData, GatewayVoiceStateUpdate, GatewayVoiceStateUpdateDispatchData } from \"discord-api-types/v10\";\n\n/**\n * Main class that handles Lavalink node connections and player management.\n *\n * @remarks\n * The Manager acts as the central hub for Lavacord, managing connections to Lavalink nodes,\n * handling voice state updates, and providing a unified interface for player operations.\n */\nexport class Manager extends EventEmitter<ManagerEvents> {\n\t/**\n\t * A Map of Lavalink Nodes indexed by their IDs.\n\t */\n\tpublic nodes = new Map<string, LavalinkNode>();\n\n\t/**\n\t * A Map of all active players indexed by guild ID.\n\t */\n\tpublic players = new Map<string, Player>();\n\n\t/**\n\t * A Map of voice server update states indexed by guild ID.\n\t */\n\tpublic voiceServers = new Map<string, GatewayVoiceServerUpdateDispatchData>();\n\n\t/**\n\t * A Map of voice state update states indexed by guild ID.\n\t */\n\tpublic voiceStates = new Map<string, GatewayVoiceStateUpdateDispatchData>();\n\n\t/**\n\t * The user ID of the bot this Manager is managing.\n\t */\n\tpublic userId: string | null = null;\n\n\t/**\n\t * Function to send voice state update packets to Discord.\n\t *\n\t * @remarks\n\t * This can be implemented by the user in two ways:\n\t * 1. Via constructor options: `new Manager(nodes, { send: fn })`\n\t * 2. Via class extension: `class MyManager extends Manager { send(packet) { ... } }`\n\t */\n\tprivate _send?: (packet: GatewayVoiceStateUpdate) => unknown;\n\n\t/**\n\t * The Player class constructor used when creating new players.\n\t *\n\t * @remarks\n\t * Can be overridden in the manager options to use a custom Player implementation.\n\t */\n\tprivate readonly Player: typeof Player = Player;\n\n\t/**\n\t * A Set of guild IDs that are waiting for a connection.\n\t *\n\t * @internal\n\t */\n\tprivate readonly expecting = new Set<string>();\n\n\t/**\n\t * Creates a new Manager instance.\n\t *\n\t * @param nodes - An array of Lavalink node options to connect to.\n\t * @param options - Configuration options for the Manager.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Method 1: Define send function via options\n\t * const manager = new Manager([\n\t *   {\n\t *     id: \"main\",\n\t *     host: \"localhost\",\n\t *     port: 2333,\n\t *     password: \"youshallnotpass\"\n\t *   }\n\t * ], {\n\t *   userId: \"bot_user_id\",\n\t *   send: (packet) => {\n\t *     const guild = client.guilds.cache.get(packet.d.guild_id);\n\t *     if (guild) guild.shard.send(packet);\n\t *   }\n\t * });\n\t *\n\t * // Method 2: Extend Manager class\n\t * class MyManager extends Manager {\n\t *   send(packet) {\n\t *     const guild = this.client.guilds.cache.get(packet.d.guild_id);\n\t *     if (guild) guild.shard.send(packet);\n\t *   }\n\t * }\n\t * const manager = new MyManager(nodes, { userId: \"bot_user_id\" });\n\t * ```\n\t */\n\tpublic constructor(nodes: LavalinkNodeOptions[], options?: ManagerOptions) {\n\t\tsuper();\n\t\toptions ??= {};\n\n\t\tif (options.userId) this.userId = options.userId;\n\t\tif (options.player) this.Player = options.player;\n\t\tif (options.send && !this._send) this._send = options.send;\n\n\t\tfor (const node of nodes) this.createNode(node);\n\t}\n\n\t/**\n\t * Connects all Lavalink nodes to their respective Lavalink servers.\n\t *\n\t * @returns A promise that resolves when all connections are established.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Connect all nodes\n\t * manager.connect()\n\t *   .then(() => console.log('All nodes connected!'))\n\t *   .catch(error => console.error('Failed to connect nodes:', error));\n\t * ```\n\t */\n\tpublic async connect(): Promise<LavalinkNode[]> {\n\t\tif (!this.userId)\n\t\t\tthrow new Error(\n\t\t\t\t\"Lavacord requires a client user ID before connecting. \\n\" +\n\t\t\t\t\t\"Set the user ID when constructing the Manager or after your Discord client is ready.\"\n\t\t\t);\n\t\treturn Promise.all(this.nodes.values().map((node) => node.connect().then(() => node)));\n\t}\n\n\t/**\n\t * Disconnects all players and nodes, effectively cleaning up all resources.\n\t *\n\t * @returns A promise that resolves when all disconnections are complete.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Disconnect everything\n\t * manager.disconnect()\n\t *   .then(() => console.log('All players and nodes cleaned up'))\n\t *   .catch(error => console.error('Error during disconnection:', error));\n\t * ```\n\t */\n\tpublic async disconnect(): Promise<void> {\n\t\tfor await (const player of this.players.keys()) await this.leave(player);\n\t\tfor (const node of this.nodes.values()) node.destroy();\n\t}\n\n\t/**\n\t * Creates a new Lavalink node and adds it to the nodes map.\n\t *\n\t * @param options - Configuration options for the node.\n\t * @returns The newly created LavalinkNode instance.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Add a new node\n\t * const newNode = manager.createNode({\n\t *   id: \"node2\",\n\t *   host: \"example.com\",\n\t *   port: 2333,\n\t *   password: \"securepassword\",\n\t *   resuming: true\n\t * });\n\t * ```\n\t */\n\tpublic createNode(options: LavalinkNodeOptions): LavalinkNode {\n\t\tconst node = new LavalinkNode(this, options);\n\t\tthis.nodes.set(options.id, node);\n\t\treturn node;\n\t}\n\n\t/**\n\t * Disconnects and removes a node from the manager.\n\t *\n\t * @param id - The ID of the node to remove.\n\t * @returns Whether the node was successfully removed.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Remove a node\n\t * const removed = manager.removeNode(\"node1\");\n\t * if (removed) {\n\t *   console.log(\"Node successfully removed\");\n\t * } else {\n\t *   console.log(\"Node not found\");\n\t * }\n\t * ```\n\t */\n\tpublic removeNode(id: string): boolean {\n\t\tconst node = this.nodes.get(id);\n\t\tif (!node) return false;\n\t\tnode.destroy();\n\t\treturn this.nodes.delete(id);\n\t}\n\n\t/**\n\t * Joins a voice channel and creates a player for the guild.\n\t *\n\t * @param data - The data needed to join a voice channel.\n\t * @param joinOptions - Options for joining the channel (selfmute, selfdeaf).\n\t * @returns A promise resolving to the Player instance.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Join a voice channel\n\t * const player = await manager.join({\n\t *   guild: \"123456789012345678\", // Guild ID\n\t *   channel: \"123456789012345679\", // Voice Channel ID\n\t *   node: \"main\" // Node ID\n\t * }, {\n\t *   selfdeaf: true // Join deafened\n\t * });\n\t *\n\t * // Now you can use the player to play music\n\t * const result = await Rest.load(player.node, \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\");\n\t * await player.play(result.tracks[0].track);\n\t * ```\n\t */\n\tpublic async join(data: JoinData, joinOptions: JoinOptions = {}): Promise<Player> {\n\t\tconst player = this.players.get(data.guild);\n\t\tif (player) return player;\n\t\tawait this.sendWS(data.guild, data.channel, joinOptions);\n\t\treturn this.spawnPlayer(data);\n\t}\n\n\t/**\n\t * Leaves a voice channel and cleans up the player.\n\t *\n\t * @param guild - The ID of the guild to leave.\n\t * @returns A promise resolving to whether the operation was successful.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Leave a voice channel\n\t * const success = await manager.leave(\"123456789012345678\");\n\t * if (success) {\n\t *   console.log(\"Successfully left the voice channel\");\n\t * } else {\n\t *   console.log(\"Not in a voice channel in this guild\");\n\t * }\n\t * ```\n\t */\n\tpublic async leave(guild: string): Promise<boolean> {\n\t\tawait this.sendWS(guild, null);\n\t\tconst player = this.players.get(guild);\n\t\tif (!player) return false;\n\n\t\tawait player.destroy();\n\t\treturn this.players.delete(guild);\n\t}\n\n\t/**\n\t * Switches a player from one node to another, implementing fallback capability.\n\t *\n\t * @param player - The player to move to another node.\n\t * @param node - The destination node.\n\t * @returns A promise resolving to the updated player.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Switch a player to another node (e.g. if current node is failing)\n\t * const player = manager.players.get(\"123456789012345678\");\n\t * const newNode = manager.nodes.get(\"backup-node\");\n\t *\n\t * if (player && newNode) {\n\t *   await manager.switch(player, newNode);\n\t *   console.log(\"Player switched to backup node\");\n\t * }\n\t * ```\n\t */\n\tpublic async switch(player: Player, node: LavalinkNode): Promise<Player> {\n\t\tplayer.node = node;\n\n\t\tif (!player.voice) return player;\n\t\tawait player.destroy();\n\t\tif (!player.track) return player;\n\n\t\tawait player.play(player.track.encoded, {\n\t\t\tposition: player.state.position,\n\t\t\tvolume: player.volume,\n\t\t\tfilters: player.filters,\n\t\t\tvoice: player.voice,\n\t\t\tpaused: player.paused,\n\t\t\tuserData: player.track.userData\n\t\t});\n\n\t\treturn player;\n\t}\n\n\t/**\n\t * Processes voice server update events from Discord.\n\t *\n\t * @param data - The voice server update data from Discord.\n\t * @returns A promise resolving to whether a connection was established.\n\t *\n\t * @example\n\t * ```typescript\n\t * // In your Discord.js client events\n\t * client.ws.on(GatewayDispatchEvents.VoiceServerUpdate, (data) => {\n\t *   manager.voiceServerUpdate(data);\n\t * });\n\t * ```\n\t */\n\tpublic voiceServerUpdate(data: GatewayVoiceServerUpdateDispatchData): Promise<boolean> {\n\t\tthis.voiceServers.set(data.guild_id, data);\n\t\tthis.expecting.add(data.guild_id);\n\t\treturn this._attemptConnection(data.guild_id);\n\t}\n\n\t/**\n\t * Processes voice state update events from Discord.\n\t *\n\t * @param data - The voice state update data from Discord.\n\t * @returns A promise resolving to whether a connection was established.\n\t *\n\t * @example\n\t * ```typescript\n\t * // In your Discord.js client events\n\t * client.ws.on(GatewayDispatchEvents.VoiceStateUpdate, (data) => {\n\t *   manager.voiceStateUpdate(data);\n\t * });\n\t * ```\n\t */\n\tpublic async voiceStateUpdate(data: GatewayVoiceStateUpdateDispatchData): Promise<boolean> {\n\t\tif (data.user_id !== this.userId) return false;\n\t\tif (!data.guild_id) return false;\n\n\t\tif (data.channel_id) {\n\t\t\tthis.voiceStates.set(data.guild_id, data);\n\t\t\treturn this._attemptConnection(data.guild_id);\n\t\t}\n\n\t\tthis.voiceServers.delete(data.guild_id);\n\t\tthis.voiceStates.delete(data.guild_id);\n\n\t\treturn false;\n\t}\n\n\t/**\n\t * Sends a voice state update packet to Discord.\n\t *\n\t * @param guild - The ID of the guild.\n\t * @param channel - The ID of the voice channel to join, or null to leave.\n\t * @param options - Options for joining (selfmute, selfdeaf).\n\t * @returns The result from the send function.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Join a voice channel\n\t * manager.sendWS(\"123456789012345678\", \"123456789012345679\", { selfdeaf: true });\n\t *\n\t * // Leave a voice channel\n\t * manager.sendWS(\"123456789012345678\", null);\n\t * ```\n\t */\n\tpublic sendWS(guild: string, channel: string | null, { selfmute = false, selfdeaf = false }: JoinOptions = {}): unknown {\n\t\treturn this.send({\n\t\t\top: 4,\n\t\t\td: {\n\t\t\t\tguild_id: guild,\n\t\t\t\tchannel_id: channel,\n\t\t\t\tself_mute: selfmute,\n\t\t\t\tself_deaf: selfdeaf\n\t\t\t}\n\t\t});\n\t}\n\n\t/**\n\t * Gets all connected nodes, sorted by CPU load.\n\t *\n\t * @returns An array of connected nodes sorted by CPU load (least to most).\n\t *\n\t * @example\n\t * ```typescript\n\t * // Get the node with the least CPU load\n\t * const bestNode = manager.idealNodes[0];\n\t * if (bestNode) {\n\t *   console.log(`Best node for new connections: ${bestNode.id}`);\n\t * }\n\t * ```\n\t */\n\tpublic get idealNodes(): LavalinkNode[] {\n\t\treturn Array.from(this.nodes.values())\n\t\t\t.filter((node) => node.connected)\n\t\t\t.sort((a, b) => {\n\t\t\t\tconst aload = a.stats.cpu ? (a.stats.cpu.systemLoad / a.stats.cpu.cores) * 100 : 0;\n\t\t\t\tconst bload = b.stats.cpu ? (b.stats.cpu.systemLoad / b.stats.cpu.cores) * 100 : 0;\n\t\t\t\treturn aload - bload;\n\t\t\t});\n\t}\n\n\t/**\n\t * Attempts to establish a connection for a guild using available voice data.\n\t *\n\t * @internal\n\t * @param guildID - The ID of the guild to attempt connecting.\n\t * @returns A promise resolving to whether a connection was established.\n\t */\n\tprivate async _attemptConnection(guildID: string): Promise<boolean> {\n\t\tconst server = this.voiceServers.get(guildID);\n\t\tconst state = this.voiceStates.get(guildID);\n\n\t\tif (!server || !state || !this.expecting.has(guildID)) return false;\n\n\t\tconst player = this.players.get(guildID);\n\t\tif (!player) return false;\n\n\t\tawait player.connect({ sessionId: state.session_id, event: server });\n\t\tthis.expecting.delete(guildID);\n\n\t\treturn true;\n\t}\n\n\t/**\n\t * Creates a new player instance.\n\t *\n\t * @internal\n\t * @param data - The data needed to create a player.\n\t * @returns The created Player instance.\n\t */\n\tprivate spawnPlayer(data: JoinData): Player {\n\t\tconst exists = this.players.get(data.guild);\n\t\tif (exists) return exists;\n\t\tconst node = this.nodes.get(data.node);\n\t\tif (!node) throw new Error(`INVALID_HOST: No available node with ${data.node}`);\n\t\tconst player = new this.Player(node, data.guild);\n\t\tthis.players.set(data.guild, player);\n\t\treturn player;\n\t}\n\n\tprotected send(packet: GatewayVoiceStateUpdate): unknown {\n\t\tif (typeof this._send !== \"function\") {\n\t\t\tthrow new Error(\n\t\t\t\t\"Lavacord requires a send function to be defined in the Manager options.\\\n\t\t\t\tThis function should send voice state updates to Discord.\"\n\t\t\t);\n\t\t}\n\t\treturn this._send(packet);\n\t}\n}\n"]}

package/dist/cjs/lib/Player.cjs

@@ -0,0 +1,220 @@
+'use strict';
+
+var events = require('events');
+var Rest_cjs = require('./Rest.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var Player = class extends events.EventEmitter {
+  /**
+   * Creates a new player instance.
+   *
+   * @param node - The Lavalink node this player is connected to.
+   * @param guildId - The guild ID that this player is associated with.
+   */
+  constructor(node, guildId) {
+    super();
+    this.node = node;
+    this.guildId = guildId;
+  }
+  static {
+    __name(this, "Player");
+  }
+  /**
+   * The current state of this Player
+   *
+   * @remarks
+   * Contains information about the player state from Lavalink, including position, filters, etc.
+   */
+  state = {
+    time: 0,
+    position: 0,
+    connected: false,
+    ping: 0
+  };
+  /**
+   * The timestamp when the current track started playing
+   *
+   * @remarks
+   * This is a client-side timestamp, not synchronized with Lavalink.
+   * Can be used to calculate approximate playback position.
+   */
+  timestamp = null;
+  /**
+   * Whether the audio playback is currently paused
+   */
+  paused = false;
+  /**
+   * The current volume level (0-1000)
+   */
+  volume = 100;
+  /**
+   * The current track in Lavalink's base64 string form
+   *
+   * @remarks
+   * This is null when no track is loaded or when playback has ended.
+   */
+  track = null;
+  /**
+   * The voice connection state from Lavalink API
+   */
+  voice = null;
+  /**
+   * The current audio filters applied to this player
+   *
+   * @remarks
+   * This includes effects like equalizer, karaoke, etc.
+   */
+  filters = {};
+  /**
+   * Updates the current player on the Lavalink node.
+   * @see {@link https://lavalink.dev/api/rest#update-player}
+   *
+   * @param options - The update options to apply to the player.
+   * @param noReplace - If true, the event will be dropped if there's a currently playing track.
+   * @returns {Promise<APIPlayer>} The updated player information from Lavalink.
+   */
+  async update(options, noReplace = false) {
+    const d = await Rest_cjs.Rest.updatePlayer(this.node, this.guildId, options, noReplace);
+    if ("track" in d) this.track = d.track;
+    if ("volume" in d) this.volume = d.volume;
+    if ("paused" in d) this.paused = d.paused;
+    if ("state" in d) this.state = d.state;
+    if ("filters" in d) this.filters = d.filters;
+    if ("voice" in d) this.voice = d.voice;
+    return d;
+  }
+  /**
+   * Plays a track using its base64 encoded string.
+   *
+   * @param track - The base64 encoded track string from Lavalink.
+   * @param options - Additional options for playback.
+   * @returns A promise resolving to the updated player information.
+   */
+  async play(track, options) {
+    const { userData, noReplace, ...opts } = options || {};
+    const d = await this.update({ track: { encoded: track, userData }, ...opts }, noReplace ?? false);
+    this.timestamp = Date.now();
+    return d;
+  }
+  /**
+   * Stops the currently playing track.
+   *
+   * @remarks
+   * This will trigger a "TrackEndEvent" with reason "STOPPED".
+   *
+   * @returns A promise resolving to the updated player information.
+   */
+  stop() {
+    return this.update({ track: { encoded: null } });
+  }
+  /**
+   * Pauses or resumes the current track.
+   *
+   * @param pause - Whether to pause (true) or resume (false) playback.
+   * @returns A promise resolving to the updated player information.
+   */
+  async pause(pause) {
+    const d = await this.update({ paused: pause });
+    if (this.listenerCount("pause")) this.emit("pause", pause);
+    if (this.manager.listenerCount("playerPause")) this.manager.emit("playerPause", this, pause);
+    return d;
+  }
+  /**
+   * Changes the volume of the current playback.
+   *
+   * @param volume - The volume level as a number between 0 and 1000
+   * @returns A promise resolving to the updated player information.
+   */
+  async setVolume(volume) {
+    const d = await this.update({ volume });
+    if (this.listenerCount("volume")) this.emit("volume", volume);
+    if (this.manager.listenerCount("playerVolume")) this.manager.emit("playerVolume", this, volume);
+    return d;
+  }
+  /**
+   * Seeks to a specific position in the current track.
+   *
+   * @param position - The position to seek to in milliseconds.
+   * @returns A promise resolving to the updated player information.
+   */
+  async seek(position) {
+    const d = await this.update({ position });
+    if (this.listenerCount("seek")) this.emit("seek", position);
+    if (this.manager.listenerCount("playerSeek")) this.manager.emit("playerSeek", this, position);
+    return d;
+  }
+  /**
+   * Applies audio filters to the current playback.
+   *
+   * @param options - The filter options to apply.
+   * @returns A promise resolving to the updated player information.
+   */
+  async setFilters(options) {
+    const d = await this.update({ filters: options });
+    if (this.listenerCount("filters")) this.emit("filters", options);
+    if (this.manager.listenerCount("playerFilters")) this.manager.emit("playerFilters", this, options);
+    return d;
+  }
+  /**
+   * Sets the equalizer effect for the current playback.
+   *
+   * @param bands - An array of equalizer bands to adjust.
+   * @returns A promise resolving to the updated player information.
+   *
+   * @remarks
+   * Each band is an object with 'band' (0-14) and 'gain' (-0.25 to 1.0) properties.
+   */
+  async setEqualizer(bands) {
+    return this.setFilters({ equalizer: bands });
+  }
+  /**
+   * Destroys the player on the Lavalink node.
+   *
+   * @remarks
+   * This sends a destroy signal to Lavalink to clean up resources for this guild ID.
+   * It doesn't affect the Discord voice connection - use {@link Manager.leave} for that.
+   *
+   * @returns {Promise<DestroyPlayerResult>} A promise resolving to the destroy result.
+   */
+  async destroy() {
+    return Rest_cjs.Rest.destroyPlayer(this.node, this.guildId);
+  }
+  /**
+   * Provides voice server update information to Lavalink to establish a connection.
+   *
+   * @param data - The voice update state containing session ID and voice server information.
+   * @returns A promise resolving to the updated player information.
+   */
+  connect(data) {
+    return this.update({
+      voice: {
+        token: data.event.token,
+        endpoint: data.event.endpoint,
+        sessionId: data.sessionId
+      }
+    });
+  }
+  /**
+   * Switches the player to a different voice channel.
+   *
+   * @param channel - The ID of the voice channel to switch to.
+   * @param options - Options for joining the channel (selfMute, selfDeaf).
+   * @returns Does not return anything, but sends a WebSocket message to the Lavalink node.
+   */
+  switchChannel(channel, options = {}) {
+    return this.manager.sendWS(this.guildId, channel, options);
+  }
+  /**
+   * Gets the manager instance that created this player.
+   *
+   * @returns {Manager} The manager instance.
+   */
+  get manager() {
+    return this.node.manager;
+  }
+};
+
+exports.Player = Player;
+//# sourceMappingURL=Player.cjs.map
+//# sourceMappingURL=Player.cjs.map