magmastream 2.9.0-dev.34 → 2.9.0-dev.36

package/dist/index.d.ts

@@ -7,6 +7,7 @@ import { Redis } from 'ioredis';
 import { Client as Client$1 } from 'eris';
 import { ClusterClient, ShardClient } from 'detritus-client';
 import { Client as Client$2 } from 'oceanic.js';
+import { Client as Client$3 } from 'seyfert';
 
 /** Represents an equalizer band. */
 interface Band {
@@ -140,8 +141,9 @@ interface playOptions {
  * State Storage Enum
  */
 declare enum StateStorageType {
-    Collection = "collection",
-    Redis = "redis"
+    Memory = "memory",
+    Redis = "redis",
+    JSON = "json"
 }
 /**
  * AutoPlay Platform Enum
@@ -332,7 +334,7 @@ declare enum SponsorBlockSegment {
 /**
  * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
  */
-declare class Queue extends Array<Track> implements IQueue {
+declare class MemoryQueue extends Array<Track> implements IQueue {
     /** The current track */
     current: Track | null;
     /** The previous tracks */
@@ -347,12 +349,30 @@ declare class Queue extends Array<Track> implements IQueue {
      * @param manager The Manager instance.
      */
     constructor(guildId: string, manager: Manager);
+    /**
+     * @returns The current track.
+     */
     getCurrent(): Promise<Track | null>;
+    /**
+     * @param track The track to set.
+     */
     setCurrent(track: Track | null): Promise<void>;
+    /**
+     * @returns The previous tracks.
+     */
     getPrevious(): Promise<Track[]>;
     addPrevious(track: Track | Track[]): Promise<void>;
+    /**
+     * @param tracks The tracks to set.
+     */
     setPrevious(tracks: Track[]): Promise<void>;
+    /**
+     * @returns The newest track.
+     */
     popPrevious(): Promise<Track | null>;
+    /**
+     * Clears the previous tracks.
+     */
     clearPrevious(): Promise<void>;
     /**
      * The total duration of the queue in milliseconds.
@@ -404,15 +424,360 @@ declare class Queue extends Array<Track> implements IQueue {
      * Shuffles the queue to play tracks requested by each user one by one.
      */
     roundRobinShuffle(): Promise<void>;
+    /**
+     * Removes the first element from the queue.
+     */
     dequeue(): Promise<Track | undefined>;
+    /**
+     * Adds the specified track or tracks to the front of the queue.
+     * @param track The track or tracks to add.
+     */
     enqueueFront(track: Track | Track[]): Promise<void>;
+    /**
+     * @returns A shallow copy of the queue.
+     */
     getTracks(): Promise<Track[]>;
+    /**
+     * @returns A shallow copy of the queue.
+     */
     getSlice(start?: number, end?: number): Promise<Track[]>;
+    /**
+     * Modifies the queue at the specified index.
+     * @param start The index at which to start modifying the queue.
+     * @param deleteCount The number of elements to remove from the queue.
+     * @param items The elements to add to the queue.
+     * @returns The modified queue.
+     */
     modifyAt(start: number, deleteCount?: number, ...items: Track[]): Promise<Track[]>;
+    /**
+     * @returns A new array with the results of calling a provided function on every element in the queue.
+     */
     mapAsync<T>(callback: (track: Track, index: number, array: Track[]) => T): Promise<T[]>;
+    /**
+     * @returns A new array with all elements that pass the test implemented by the provided function.
+     */
     filterAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track[]>;
+    /**
+     * @returns The first element in the queue that satisfies the provided testing function.
+     */
     findAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track | undefined>;
+    /**
+     * @returns Whether at least one element in the queue satisfies the provided testing function.
+     */
     someAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
+    /**
+     * @returns Whether all elements in the queue satisfy the provided testing function.
+     */
+    everyAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
+}
+
+/**
+ * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
+ */
+declare class RedisQueue implements IQueue {
+    readonly guildId: string;
+    readonly manager: Manager;
+    /**
+     * The Redis instance.
+     */
+    private redis;
+    /**
+     * The prefix for the Redis keys.
+     */
+    redisPrefix: string;
+    /**
+     * Constructs a new RedisQueue.
+     * @param guildId The guild ID.
+     * @param manager The Manager instance.
+     */
+    constructor(guildId: string, manager: Manager);
+    /**
+     * @returns The queue key.
+     */
+    private get queueKey();
+    /**
+     * @returns The current key.
+     */
+    private get currentKey();
+    /**
+     * @returns The previous key.
+     */
+    private get previousKey();
+    /**
+     * Helper to serialize/deserialize Track
+     */
+    private serialize;
+    /**
+     * Helper to serialize/deserialize Track
+     */
+    private deserialize;
+    /**
+     * @returns The current track.
+     */
+    getCurrent(): Promise<Track | null>;
+    /**
+     * @param track The track to set.
+     */
+    setCurrent(track: Track | null): Promise<void>;
+    /**
+     * @returns The previous tracks.
+     */
+    getPrevious(): Promise<Track[]>;
+    /**
+     * @param track The track to add.
+     */
+    addPrevious(track: Track | Track[]): Promise<void>;
+    /**
+     * @param track The track to set.
+     */
+    setPrevious(track: Track | Track[]): Promise<void>;
+    /**
+     * @returns The newest track.
+     */
+    popPrevious(): Promise<Track | null>;
+    /**
+     * Clears the previous tracks.
+     */
+    clearPrevious(): Promise<void>;
+    /**
+     * @param track The track or tracks to add. Can be a single `Track` or an array of `Track`s.
+     * @param [offset=null] The position to add the track(s) at. If not provided, the track(s) will be added at the end of the queue.
+     */
+    add(track: Track | Track[], offset?: number): Promise<void>;
+    /**
+     * @param position The position to remove the track at.
+     * @param end The end position to remove the track at.
+     */
+    remove(position?: number): Promise<Track[]>;
+    remove(start: number, end: number): Promise<Track[]>;
+    /**
+     * Clears the queue.
+     */
+    clear(): Promise<void>;
+    /**
+     * @returns The size of the queue.
+     */
+    size(): Promise<number>;
+    /**
+     * @returns The total size of tracks in the queue including the current track.
+     */
+    totalSize(): Promise<number>;
+    /**
+     * @returns The total duration of the queue in milliseconds.
+     * This includes the duration of the currently playing track.
+     */
+    duration(): Promise<number>;
+    /**
+     * Shuffles the queue.
+     */
+    shuffle(): Promise<void>;
+    /**
+     * Shuffles the queue, but keeps the tracks of the same user together.
+     */
+    userBlockShuffle(): Promise<void>;
+    /**
+     * Shuffles the queue round-robin style.
+     */
+    roundRobinShuffle(): Promise<void>;
+    /**
+     * Removes the first track from the queue.
+     */
+    dequeue(): Promise<Track | undefined>;
+    /**
+     * Adds a track to the front of the queue.
+     */
+    enqueueFront(track: Track | Track[]): Promise<void>;
+    /**
+     * @returns The tracks in the queue.
+     */
+    getTracks(): Promise<Track[]>;
+    /**
+     * @returns The tracks in the queue from the start to the end.
+     */
+    getSlice(start?: number, end?: number): Promise<Track[]>;
+    /**
+     * Modifies the queue at the specified index.
+     */
+    modifyAt(start: number, deleteCount?: number, ...items: Track[]): Promise<Track[]>;
+    /**
+     * @returns The tracks in the queue after the specified index.
+     */
+    mapAsync<T>(callback: (track: Track, index: number, array: Track[]) => T): Promise<T[]>;
+    /**
+     * @returns The tracks in the queue that match the specified condition.
+     */
+    filterAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track[]>;
+    /**
+     * @returns The first track in the queue that matches the specified condition.
+     */
+    findAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track | undefined>;
+    /**
+     * @returns Whether any tracks in the queue match the specified condition.
+     */
+    someAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
+    /**
+     * @returns Whether all tracks in the queue match the specified condition.
+     */
+    everyAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
+}
+
+/**
+ * The player's queue, the `current` property is the currently playing track, think of the rest as the up-coming tracks.
+ */
+declare class JsonQueue implements IQueue {
+    readonly guildId: string;
+    readonly manager: Manager;
+    private basePath;
+    /**
+     * @param guildId The guild ID.
+     * @param manager The manager.
+     */
+    constructor(guildId: string, manager: Manager);
+    /**
+     * @returns The queue path.
+     */
+    private get queuePath();
+    /**
+     * @returns The current path.
+     */
+    private get currentPath();
+    /**
+     * @returns The previous path.
+     */
+    private get previousPath();
+    /**
+     * Ensures the directory exists.
+     */
+    private ensureDir;
+    /**
+     * @returns The queue.
+     */
+    private getQueue;
+    /**
+     * @param queue The queue.
+     */
+    private setQueue;
+    /**
+     * @param filePath The file path.
+     * @returns The JSON data.
+     */
+    private readJSON;
+    /**
+     * @param filePath The file path.
+     * @param data The data to write.
+     */
+    private writeJSON;
+    /**
+     * @param filePath The file path.
+     */
+    private deleteFile;
+    /**
+     * @returns The current track.
+     */
+    getCurrent(): Promise<Track | null>;
+    /**
+     * @param track The track to set.
+     */
+    setCurrent(track: Track | null): Promise<void>;
+    /**
+     * @returns The previous tracks.
+     */
+    getPrevious(): Promise<Track[]>;
+    /**
+     * @param track The track to add.
+     */
+    addPrevious(track: Track | Track[]): Promise<void>;
+    /**
+     * @param track The track to set.
+     */
+    setPrevious(track: Track | Track[]): Promise<void>;
+    /**
+     * @returns The newest track.
+     */
+    popPrevious(): Promise<Track | null>;
+    /**
+     * Clears the previous tracks.
+     */
+    clearPrevious(): Promise<void>;
+    /**
+     * @param track The track or tracks to add. Can be a single `Track` or an array of `Track`s.
+     * @param [offset=null] The position to add the track(s) at. If not provided, the track(s) will be added at the end of the queue.
+     */
+    add(track: Track | Track[], offset?: number): Promise<void>;
+    /**
+     * Removes a track from the queue.
+     * @param position The position to remove the track at.
+     * @param end The end position to remove the track at.
+     */
+    remove(position?: number): Promise<Track[]>;
+    remove(start: number, end: number): Promise<Track[]>;
+    /**
+     * Clears the queue.
+     */
+    clear(): Promise<void>;
+    /**
+     * @returns The size of the queue.
+     */
+    size(): Promise<number>;
+    /**
+     * @returns The total size of the queue.
+     */
+    totalSize(): Promise<number>;
+    /**
+     * @returns The total duration of the queue.
+     */
+    duration(): Promise<number>;
+    /**
+     * Shuffles the queue.
+     */
+    shuffle(): Promise<void>;
+    /**
+     * Shuffles the queue by user.
+     */
+    userBlockShuffle(): Promise<void>;
+    /**
+     * Shuffles the queue by round-robin.
+     */
+    roundRobinShuffle(): Promise<void>;
+    /**
+     * Removes the first track from the queue.
+     */
+    dequeue(): Promise<Track | undefined>;
+    /**
+     * Adds a track to the front of the queue.
+     */
+    enqueueFront(track: Track | Track[]): Promise<void>;
+    /**
+     * @returns The tracks in the queue.
+     */
+    getTracks(): Promise<Track[]>;
+    /**
+     * @returns The tracks in the queue from start to end.
+     */
+    getSlice(start?: number, end?: number): Promise<Track[]>;
+    /**
+     * Modifies the queue at the specified index.
+     */
+    modifyAt(start: number, deleteCount?: number, ...items: Track[]): Promise<Track[]>;
+    /**
+     * Maps the queue to a new array.
+     */
+    mapAsync<T>(callback: (track: Track, index: number, array: Track[]) => T): Promise<T[]>;
+    /**
+     * Filters the queue.
+     */
+    filterAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track[]>;
+    /**
+     * Finds the first track in the queue that satisfies the provided testing function.
+     */
+    findAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<Track | undefined>;
+    /**
+     * Tests whether at least one element in the queue passes the test implemented by the provided function.
+     */
+    someAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
+    /**
+     * Tests whether all elements in the queue pass the test implemented by the provided function.
+     */
     everyAsync(callback: (track: Track, index: number, array: Track[]) => boolean): Promise<boolean>;
 }
 
@@ -422,41 +787,57 @@ declare class Queue extends Array<Track> implements IQueue {
 interface ManagerOptions {
     /** The state storage options.
      *
-     * @default { type: StateStorageType.Collection }
+     * @default { type: StateStorageType.Collection, deleteInactivePlayers: true }
      */
     stateStorage?: StateStorageOptions;
-    /** Enable priority mode over least player count or load balancing? */
+    /** Enable priority mode over least player count or load balancing?
+     * @default false
+     */
     enablePriorityMode?: boolean;
-    /** Automatically play the next track when the current one ends. */
+    /** Automatically play the next track when the current one ends.
+     * @default true
+     */
     playNextOnEnd?: boolean;
     /** An array of search platforms to use for autoplay. First to last matters
      * Use enum `AutoPlayPlatform`.
+     * @default [AutoPlayPlatform.YouTube]
      */
     autoPlaySearchPlatforms?: AutoPlayPlatform[];
     /** The client ID to use. */
     clientId?: string;
     /** Value to use for the `Client-Name` header. */
     clientName?: string;
-    /** The array of shard IDs connected to this manager instance. */
+    /** The array of shard IDs connected to this manager instance.
+     * @default 0
+     */
     clusterId?: number;
     /** List of plugins to load. */
     enabledPlugins?: Plugin[];
     /** The default search platform to use.
-     * Use enum `SearchPlatform`. */
+     * Use enum `SearchPlatform`.
+     * @default SearchPlatform.YouTube
+     */
     defaultSearchPlatform?: SearchPlatform;
     /** The last.fm API key.
      * If you need to create one go here: https://www.last.fm/api/account/create.
      * If you already have one, get it from here: https://www.last.fm/api/accounts. */
     lastFmApiKey?: string;
-    /** The maximum number of previous tracks to store. */
+    /** The maximum number of previous tracks to store.
+     * @default 20
+     */
     maxPreviousTracks?: number;
     /** The array of nodes to connect to. */
     nodes?: NodeOptions[];
-    /** Whether the YouTube video titles should be replaced if the Author does not exactly match. */
+    /** Whether the YouTube video titles should be replaced if the Author does not exactly match.
+     * @default false
+     */
     normalizeYouTubeTitles?: boolean;
     /** An array of track properties to keep. `track` will always be present. */
     trackPartial?: TrackPartial[];
-    /** Use the least amount of players or least load? */
+    /** Use the least amount of players or least load?
+     * Use enum `UseNodeOptions`.
+     * @default UseNodeOptions.LeastPlayers
+     */
     useNode?: UseNodeOptions.LeastLoad | UseNodeOptions.LeastPlayers;
     /**
      * Function to send data to the websocket.
@@ -471,6 +852,8 @@ interface ManagerOptions {
 interface StateStorageOptions {
     type: StateStorageType;
     redisConfig?: RedisConfig;
+    jsonConfig?: JsonConfig;
+    deleteInactivePlayers?: boolean;
 }
 /**
  * Payload
@@ -485,6 +868,57 @@ interface Payload {
         self_deaf: boolean;
     };
 }
+/**
+ * Node Options
+ */
+interface NodeOptions {
+    /** The host for the node. */
+    host: string;
+    /** The port for the node.
+     * @default 2333
+     */
+    port?: number;
+    /** The password for the node.
+     * @default "youshallnotpass"
+     */
+    password?: string;
+    /** Whether the host uses SSL.
+     * @default false
+     */
+    useSSL?: boolean;
+    /** The identifier for the node.
+     * @default host
+     */
+    identifier?: string;
+    /** The maxRetryAttempts for the node.
+     * @default 30
+     */
+    maxRetryAttempts?: number;
+    /** The retryDelayMs for the node.
+     * @default 60000
+     */
+    retryDelayMs?: number;
+    /** Whether to resume the previous session.
+     * @default false
+     */
+    enableSessionResumeOption?: boolean;
+    /** The time the lavalink server will wait before it removes the player.
+     * @default 1000
+     */
+    sessionTimeoutMs?: number;
+    /** The timeout used for api calls.
+     * @default 10000
+     */
+    apiRequestTimeoutMs?: number;
+    /** Priority of the node.
+     * @default 0
+     */
+    nodePriority?: number;
+    /** Whether the node is a NodeLink.
+     * @default false
+     */
+    isNodeLink?: boolean;
+}
 /**
  * Discord Packet
  */
@@ -547,39 +981,76 @@ interface RedisConfig {
     prefix?: string;
 }
 /**
- * Player State Update Event
+ * JSON Configuration
  */
-interface PlayerStateUpdateEvent {
-    changeType: PlayerStateEventTypes;
-    details?: AutoplayChangeEvent | ConnectionChangeEvent | RepeatChangeEvent | PauseChangeEvent | QueueChangeEvent | TrackChangeEvent | VolumeChangeEvent | ChannelChangeEvent;
+interface JsonConfig {
+    path: string;
 }
+/**
+ * Player State Update Event
+ */
+type PlayerStateUpdateEvent = {
+    changeType: PlayerStateEventTypes.TrackChange;
+    details: TrackChangeEvent;
+} | {
+    changeType: PlayerStateEventTypes.PauseChange;
+    details: PauseChangeEvent;
+} | {
+    changeType: PlayerStateEventTypes.QueueChange;
+    details: QueueChangeEvent;
+} | {
+    changeType: PlayerStateEventTypes.ConnectionChange;
+    details: ConnectionChangeEvent;
+} | {
+    changeType: PlayerStateEventTypes.AutoPlayChange;
+    details: AutoplayChangeEvent;
+} | {
+    changeType: PlayerStateEventTypes.ChannelChange;
+    details: ChannelChangeEvent;
+} | {
+    changeType: PlayerStateEventTypes.VolumeChange;
+    details: VolumeChangeEvent;
+} | {
+    changeType: PlayerStateEventTypes.RepeatChange;
+    details: RepeatChangeEvent;
+};
+/**
+ * Player State Change Data
+ */
+type PlayerStateChangeData = AutoplayChangeEvent | ConnectionChangeEvent | RepeatChangeEvent | PauseChangeEvent | QueueChangeEvent | TrackChangeEvent | VolumeChangeEvent | ChannelChangeEvent;
 /**
  * Autoplay Change Event
  */
 interface AutoplayChangeEvent {
-    previousAutoplay: boolean;
-    currentAutoplay: boolean;
+    type: "autoplay";
+    action: "toggle";
+    previousAutoplay: boolean | null;
+    currentAutoplay: boolean | null;
 }
 /**
  * Connection Change Event
  */
 interface ConnectionChangeEvent {
-    changeType: "connect" | "disconnect";
-    previousConnection: boolean;
-    currentConnection: boolean;
+    type: "connection";
+    action: "connect" | "disconnect";
+    previousConnection: boolean | null;
+    currentConnection: boolean | null;
 }
 /**
  * Repeat Change Event
  */
 interface RepeatChangeEvent {
-    changeType: "dynamic" | "track" | "queue" | null;
-    previousRepeat: string | null;
-    currentRepeat: string | null;
+    type: "repeat";
+    action: "dynamic" | "track" | "queue" | "none";
+    previousRepeat: "dynamic" | "track" | "queue" | null;
+    currentRepeat: "dynamic" | "track" | "queue" | null;
 }
 /**
  * Pause Change Event
  */
 interface PauseChangeEvent {
+    type: "pause";
+    action: "pause" | "resume" | "toggle";
     previousPause: boolean | null;
     currentPause: boolean | null;
 }
@@ -587,14 +1058,18 @@ interface PauseChangeEvent {
  * Queue Change Event
  */
 interface QueueChangeEvent {
-    changeType: "add" | "remove" | "clear" | "shuffle" | "roundRobin" | "userBlock" | "autoPlayAdd";
+    type: "queue";
+    action: "add" | "remove" | "clear" | "shuffle" | "roundRobin" | "userBlock" | "autoPlayAdd";
+    previousQueueLength: number | null;
+    currentQueueLength: number | null;
     tracks?: Track[];
 }
 /**
  * Track Change Event
  */
 interface TrackChangeEvent {
-    changeType: "start" | "end" | "previous" | "timeUpdate" | "autoPlay";
+    type: "track";
+    action: "start" | "end" | "previous" | "timeUpdate" | "autoPlay";
     track: Track;
     previousTime?: number | null;
     currentTime?: number | null;
@@ -603,6 +1078,8 @@ interface TrackChangeEvent {
  * Volume Change Event
  */
 interface VolumeChangeEvent {
+    type: "volume";
+    action: "adjust";
     previousVolume: number | null;
     currentVolume: number | null;
 }
@@ -610,7 +1087,8 @@ interface VolumeChangeEvent {
  * Channel Change Event
  */
 interface ChannelChangeEvent {
-    changeType: "text" | "voice";
+    type: "channel";
+    action: "text" | "voice";
     previousChannel: string | null;
     currentChannel: string | null;
 }
@@ -862,7 +1340,7 @@ interface VoiceServer {
 }
 interface Extendable {
     Player: typeof Player;
-    Queue: typeof Queue;
+    Queue: typeof MemoryQueue | typeof RedisQueue | typeof JsonQueue;
     Node: typeof Node;
 }
 /**
@@ -1014,62 +1492,6 @@ interface PlayerUpdate {
         ping: number;
     };
 }
-/**
- * Node Options
- */
-interface NodeOptions {
-    /** The host for the node. */
-    host: string;
-    /** The port for the node. */
-    port?: number;
-    /** The password for the node. */
-    password?: string;
-    /** Whether the host uses SSL. */
-    useSSL?: boolean;
-    /** The identifier for the node. */
-    identifier?: string;
-    /** The maxRetryAttempts for the node. */
-    maxRetryAttempts?: number;
-    /** The retryDelayMs for the node. */
-    retryDelayMs?: number;
-    /** Whether to resume the previous session. */
-    enableSessionResumeOption?: boolean;
-    /** The time the lavalink server will wait before it removes the player. */
-    sessionTimeoutMs?: number;
-    /** The timeout used for api calls. */
-    apiRequestTimeoutMs?: number;
-    /** Priority of the node. */
-    nodePriority?: number;
-    /** Whether the node is a NodeLink. */
-    isNodeLink?: boolean;
-}
-/**
- * NodeOptions interface
- */
-interface NodeOptions {
-    /** The host for the node. */
-    host: string;
-    /** The port for the node. */
-    port?: number;
-    /** The password for the node. */
-    password?: string;
-    /** Whether the host uses SSL. */
-    useSSL?: boolean;
-    /** The identifier for the node. */
-    identifier?: string;
-    /** The maxRetryAttempts for the node. */
-    maxRetryAttempts?: number;
-    /** The retryDelayMs for the node. */
-    retryDelayMs?: number;
-    /** Whether to resume the previous session. */
-    enableSessionResumeOption?: boolean;
-    /** The time the lavalink server will wait before it removes the player. */
-    sessionTimeoutMs?: number;
-    /** The timeout used for api calls. */
-    apiRequestTimeoutMs?: number;
-    /** Priority of the node. */
-    nodePriority?: number;
-}
 /**
  * NodeStats interface
  */
@@ -1599,7 +2021,7 @@ declare class Node$1 {
      * @param {TrackEndEvent} payload - The payload of the event emitted by the node.
      * @private
      */
-    protected trackEnd(player: Player, track: Track, payload: TrackEndEvent): Promise<void>;
+    trackEnd(player: Player, track: Track, payload: TrackEndEvent): Promise<void>;
     /**
      * Handles autoplay logic for a player.
      * This method is responsible for selecting an appropriate method of autoplay
@@ -1816,7 +2238,7 @@ declare class Node$1 {
 }
 
 /**
- * The main hub for interacting with Lavalink and using Magmastream,
+ * The main hub for interacting with Lavalink and using Magmastream.
  */
 declare class Manager extends EventEmitter {
     /** The map of players. */
@@ -2018,17 +2440,23 @@ declare class Manager extends EventEmitter {
      * @param player The Player instance to serialize
      * @returns The serialized Player instance
      */
-    serializePlayer(player: Player): Record<string, unknown>;
+    serializePlayer(player: Player): Promise<Record<string, unknown>>;
+    /**
+     * Cleans up inactive players by removing their state files from the file system.
+     * This is done to prevent stale state files from accumulating on the file system.
+     */
+    cleanupInactivePlayers(): Promise<void>;
     /**
-     * Checks for players that are no longer active and deletes their saved state files.
+     * Cleans up an inactive player by removing its state files from the file system.
      * This is done to prevent stale state files from accumulating on the file system.
+     * @param guildId The guild ID of the player to clean up.
      */
-    private cleanupInactivePlayers;
+    cleanupInactivePlayer(guildId: string): Promise<void>;
     /**
      * Clears all player states from the file system.
      * This is done to prevent stale state files from accumulating on the file system.
      */
-    private clearAllPlayerStates;
+    private clearAllStoredPlayers;
     /**
      * Returns the nodes that has the least load.
      * The load is calculated by dividing the lavalink load by the number of cores.
@@ -2930,5 +3358,36 @@ declare class OceanicManager extends Manager {
     protected send(packet: GatewayVoiceStateUpdate): void;
 }
 
-export { AutoPlayPlatform, AutoPlayUtils, AvailableFilters, DetritusManager, DiscordJSManager, ErisManager, Filters, LoadTypes, Manager, ManagerEventTypes, Node$1 as Node, OceanicManager, Player, PlayerStateEventTypes, Plugin$1 as Plugin, Queue, Rest, SearchPlatform, SeverityTypes, SponsorBlockSegment, StateStorageType, StateTypes, Structure, TrackEndReasonTypes, TrackPartial, TrackSourceTypes, TrackUtils, UseNodeOptions };
-export type { CPUStats, DiscordPacket, EndSpeakingEventVoiceReceiver, EndSpeakingEventVoiceReceiverData, EqualizerBand, ErrorOrEmptySearchResult, Exception, Extendable, FrameStats, IQueue, LavaPlayer, LavalinkInfo, LavalinkResponse, LoadType, Lyrics, LyricsEvent, LyricsEventType, LyricsFoundEvent, LyricsLine, LyricsLineEvent, LyricsNotFoundEvent, ManagerEvents, ManagerInitOptions, ManagerOptions, MemoryStats, NodeLinkGetLyrics, NodeLinkGetLyricsEmpty, NodeLinkGetLyricsError, NodeLinkGetLyricsMultiple, NodeLinkGetLyricsSingle, NodeMessage, NodeOptions, NodeStats, Payload, PlayOptions, PlayerEvent, PlayerEventType, PlayerEvents, PlayerOptions, PlayerStateUpdateEvent, PlayerUpdate, PlayerUpdateVoiceState, PlaylistData, PlaylistInfoData, PlaylistRawData, PlaylistSearchResult, RedisConfig, SearchQuery, SearchResult, SearchSearchResult, Severity, Sizes, SponsorBlockChapterStarted, SponsorBlockChaptersLoaded, SponsorBlockSegmentEventType, SponsorBlockSegmentEvents, SponsorBlockSegmentSkipped, SponsorBlockSegmentsLoaded, StartSpeakingEventVoiceReceiver, StartSpeakingEventVoiceReceiverData, StateStorageOptions, Track, TrackData, TrackDataInfo, TrackEndEvent, TrackEndReason, TrackExceptionEvent, TrackPluginInfo, TrackSearchResult, TrackSourceName, TrackStartEvent, TrackStuckEvent, UseNodeOption, VoicePacket, VoiceReceiverEvent, VoiceServer, VoiceServerUpdate, VoiceState, WebSocketClosedEvent };
+/**
+ * Seyfert wrapper for Magmastream.
+ *
+ * @note This wrapper does require the manual implementation of the "raw" and "ready" events, to call the `updateVoiceState` and `init` methods respectively.
+ *
+ * @example
+ * ```typescript
+ * const client = new Client();
+ * const manager = new SeyfertManager(client, options);
+ *
+ * client.events.values.RAW = {
+ *     data: { name: "raw" },
+ *     run: async (data) => {
+ *         await manager.updateVoiceState(data);
+ *     }
+ * }
+ *
+ * client.events.values.READY = {
+ *     data: { name: "ready" },
+ *     run: async (user, client) => {
+ *         await manager.init({ clientId: client.botId });
+ *     }
+ * }
+ * ```
+ */
+declare class SeyfertManager extends Manager {
+    readonly client: Client$3;
+    constructor(client: Client$3, options?: ManagerOptions);
+    protected send(packet: GatewayVoiceStateUpdate): void;
+}
+
+export { AutoPlayPlatform, AutoPlayUtils, AvailableFilters, DetritusManager, DiscordJSManager, ErisManager, Filters, JsonQueue, LoadTypes, Manager, ManagerEventTypes, MemoryQueue, Node$1 as Node, OceanicManager, Player, PlayerStateEventTypes, Plugin$1 as Plugin, RedisQueue, Rest, SearchPlatform, SeverityTypes, SeyfertManager, SponsorBlockSegment, StateStorageType, StateTypes, Structure, TrackEndReasonTypes, TrackPartial, TrackSourceTypes, TrackUtils, UseNodeOptions };
+export type { CPUStats, DiscordPacket, EndSpeakingEventVoiceReceiver, EndSpeakingEventVoiceReceiverData, EqualizerBand, ErrorOrEmptySearchResult, Exception, Extendable, FrameStats, IQueue, JsonConfig, LavaPlayer, LavalinkInfo, LavalinkResponse, LoadType, Lyrics, LyricsEvent, LyricsEventType, LyricsFoundEvent, LyricsLine, LyricsLineEvent, LyricsNotFoundEvent, ManagerEvents, ManagerInitOptions, ManagerOptions, MemoryStats, NodeLinkGetLyrics, NodeLinkGetLyricsEmpty, NodeLinkGetLyricsError, NodeLinkGetLyricsMultiple, NodeLinkGetLyricsSingle, NodeMessage, NodeOptions, NodeStats, Payload, PlayOptions, PlayerEvent, PlayerEventType, PlayerEvents, PlayerOptions, PlayerStateChangeData, PlayerStateUpdateEvent, PlayerUpdate, PlayerUpdateVoiceState, PlaylistData, PlaylistInfoData, PlaylistRawData, PlaylistSearchResult, RedisConfig, SearchQuery, SearchResult, SearchSearchResult, Severity, Sizes, SponsorBlockChapterStarted, SponsorBlockChaptersLoaded, SponsorBlockSegmentEventType, SponsorBlockSegmentEvents, SponsorBlockSegmentSkipped, SponsorBlockSegmentsLoaded, StartSpeakingEventVoiceReceiver, StartSpeakingEventVoiceReceiverData, StateStorageOptions, Track, TrackData, TrackDataInfo, TrackEndEvent, TrackEndReason, TrackExceptionEvent, TrackPluginInfo, TrackSearchResult, TrackSourceName, TrackStartEvent, TrackStuckEvent, UseNodeOption, VoicePacket, VoiceReceiverEvent, VoiceServer, VoiceServerUpdate, VoiceState, WebSocketClosedEvent };