streamify-audio 2.3.0 → 2.3.2

package/docs/discord/events.md

@@ -1,206 +0,0 @@
-# Events
-
-## Manager Events
-
-```javascript
-manager.on('playerCreate', (player) => {
-    console.log(`Player created for guild ${player.guildId}`);
-});
-
-manager.on('playerDestroy', (player) => {
-    console.log(`Player destroyed for guild ${player.guildId}`);
-});
-```
-
-## Player Events
-
-### Track Events
-
-#### trackStart
-
-Fired when a track starts playing.
-
-```javascript
-player.on('trackStart', (track) => {
-    channel.send({
-        embeds: [{
-            title: 'Now Playing',
-            description: `**${track.title}**\nby ${track.author}`,
-            thumbnail: { url: track.thumbnail }
-        }]
-    });
-});
-```
-
-#### trackEnd
-
-Fired when a track finishes.
-
-```javascript
-player.on('trackEnd', (track, reason) => {
-    // reason: 'finished' | 'skipped' | 'stopped'
-    console.log(`Track ended: ${track.title} (${reason})`);
-});
-```
-
-#### trackError
-
-Fired when a track fails to play.
-
-```javascript
-player.on('trackError', (track, error) => {
-    channel.send(`Failed to play **${track.title}**: ${error.message}`);
-});
-```
-
-#### queueEnd
-
-Fired when the queue is empty and playback stops.
-
-```javascript
-player.on('queueEnd', () => {
-    channel.send('Queue finished. Add more songs or enable autoplay!');
-});
-```
-
-### Voice Events
-
-#### userJoin
-
-Fired when a user joins the voice channel.
-
-```javascript
-player.on('userJoin', (member, count) => {
-    console.log(`${member.user.tag} joined (${count} users now)`);
-});
-```
-
-#### userLeave
-
-Fired when a user leaves the voice channel.
-
-```javascript
-player.on('userLeave', (member, count) => {
-    console.log(`${member.user.tag} left (${count} users remaining)`);
-});
-```
-
-#### channelEmpty
-
-Fired when all users leave the voice channel.
-
-```javascript
-player.on('channelEmpty', () => {
-    channel.send('Everyone left. I\'ll leave in 30 seconds...');
-});
-```
-
-#### channelMove
-
-Fired when the bot is moved to a different voice channel.
-
-```javascript
-player.on('channelMove', (newChannelId) => {
-    console.log(`Moved to channel ${newChannelId}`);
-});
-```
-
-### Automation Events
-
-#### autoPause
-
-Fired when playback is automatically paused.
-
-```javascript
-player.on('autoPause', (userCount) => {
-    channel.send(`Paused (${userCount} users in channel)`);
-});
-```
-
-#### autoResume
-
-Fired when playback is automatically resumed.
-
-```javascript
-player.on('autoResume', (userCount) => {
-    channel.send(`Resumed (${userCount} users rejoined)`);
-});
-```
-
-#### autoplayStart
-
-Fired when autoplay starts fetching related tracks.
-
-```javascript
-player.on('autoplayStart', (lastTrack) => {
-    console.log(`Finding tracks related to: ${lastTrack.title}`);
-});
-```
-
-#### autoplayAdd
-
-Fired when autoplay adds tracks to the queue.
-
-```javascript
-player.on('autoplayAdd', (tracks) => {
-    channel.send(`Autoplay added ${tracks.length} tracks`);
-});
-```
-
-### Lifecycle Events
-
-#### destroy
-
-Fired when the player is destroyed.
-
-```javascript
-player.on('destroy', () => {
-    console.log('Player destroyed');
-});
-```
-
-## Example: Full Event Setup
-
-```javascript
-function setupPlayerEvents(player, textChannel) {
-    player.on('trackStart', (track) => {
-        const embed = {
-            color: 0x00ff00,
-            title: track.isAutoplay ? 'Autoplay' : 'Now Playing',
-            description: `**${track.title}**\nby ${track.author}`,
-            thumbnail: { url: track.thumbnail }
-        };
-        textChannel.send({ embeds: [embed] });
-    });
-
-    player.on('trackError', (track, error) => {
-        textChannel.send(`Failed to play **${track.title}**: ${error.message}`);
-    });
-
-    player.on('queueEnd', () => {
-        if (!player.autoplay.enabled) {
-            textChannel.send('Queue ended. Use `!autoplay` to keep the music going!');
-        }
-    });
-
-    player.on('channelEmpty', () => {
-        textChannel.send('Channel empty. Leaving in 30 seconds...');
-    });
-
-    player.on('autoPause', () => {
-        textChannel.send('Paused - everyone left the channel.');
-    });
-
-    player.on('autoResume', () => {
-        textChannel.send('Resumed - welcome back!');
-    });
-
-    player.on('destroy', () => {
-        textChannel.send('Disconnected.');
-    });
-}
-
-// Usage
-const player = await manager.create(guildId, vcId, tcId);
-setupPlayerEvents(player, textChannel);
-```

package/docs/discord/manager.md

@@ -1,195 +0,0 @@
-# Manager
-
-The Manager handles player creation, searching, and playlist loading.
-
-## Creating a Manager
-
-```javascript
-const Streamify = require('streamify-audio');
-
-const manager = new Streamify.Manager(client, {
-    ytdlpPath: '/usr/local/bin/yt-dlp',
-    ffmpegPath: '/usr/bin/ffmpeg',
-    cookiesPath: './cookies.txt',
-    spotify: {
-        clientId: process.env.SPOTIFY_CLIENT_ID,
-        clientSecret: process.env.SPOTIFY_CLIENT_SECRET
-    }
-});
-```
-
-See [Configuration](../configuration.md) for all options.
-
-## Methods
-
-### create(guildId, voiceChannelId, textChannelId)
-
-Creates or retrieves a player for a guild.
-
-```javascript
-const player = await manager.create(
-    message.guild.id,
-    voiceChannel.id,
-    message.channel.id
-);
-```
-
-If a player already exists for the guild, returns the existing player. If the voice channel differs, disconnects and reconnects.
-
-### get(guildId)
-
-Gets an existing player without creating one.
-
-```javascript
-const player = manager.get(message.guild.id);
-if (!player) {
-    return message.reply('No player in this server.');
-}
-```
-
-### destroy(guildId)
-
-Destroys a player and disconnects from voice.
-
-```javascript
-manager.destroy(message.guild.id);
-```
-
-### destroyAll()
-
-Destroys all players. Useful for graceful shutdown.
-
-```javascript
-process.on('SIGINT', () => {
-    manager.destroyAll();
-    process.exit();
-});
-```
-
-### search(query, options?)
-
-Searches for tracks.
-
-- `query` (string) - The search term or URL
-- `options` (object) - Search configuration
-    - `source` (string) - `youtube`, `spotify`, `soundcloud`, `twitch`, `mixcloud`, `bandcamp`, `local`, `http`
-    - `limit` (number) - Number of results (default: 10)
-    - `type` (string) - `video`, `live`, or `all` (YouTube only)
-    - `sort` (string) - `relevance`, `popularity`, `date`, or `rating` (YouTube only)
-    - `artist` (string) - Filter results to only include tracks by this artist
-
-**Example:**
-
-```javascript
-const result = await manager.search('lofi hip hop', {
-    source: 'youtube',
-    type: 'live',
-    sort: 'popularity'
-});
-
-// Artist search - filters results to tracks BY the artist
-const artistTracks = await manager.search('Drake', {
-    source: 'spotify',
-    artist: 'Drake',
-    limit: 5
-});
-```
-
-// Result
-{
-    loadType: 'search',  // search, empty, error
-    tracks: [{
-        id: 'dQw4w9WgXcQ',
-        title: 'Rick Astley - Never Gonna Give You Up',
-        author: 'Rick Astley',
-        duration: 213,
-        thumbnail: 'https://...',
-        uri: 'https://youtube.com/...',
-        source: 'youtube'
-    }]
-}
-```
-
-### resolve(query)
-
-Resolves a URL or falls back to search.
-
-```javascript
-// URL - loads directly
-const result = await manager.resolve('https://youtube.com/watch?v=dQw4w9WgXcQ');
-// { loadType: 'track', tracks: [track] }
-
-// Search query - searches
-const result = await manager.resolve('never gonna give you up');
-// { loadType: 'search', tracks: [...] }
-```
-
-### loadPlaylist(url)
-
-Loads a playlist or album.
-
-```javascript
-// YouTube playlist
-const result = await manager.loadPlaylist('https://youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf');
-
-// Spotify playlist
-const result = await manager.loadPlaylist('https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M');
-
-// Spotify album
-const result = await manager.loadPlaylist('https://open.spotify.com/album/4LH4d3cOWNNsVw41Gqt2kv');
-
-// Result
-{
-    loadType: 'playlist',
-    playlist: {
-        id: 'PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf',
-        title: 'My Playlist',
-        author: 'User',
-        thumbnail: 'https://...',
-        source: 'youtube'
-    },
-    tracks: [...]
-}
-```
-
-### getRelated(track, limit?)
-
-Gets related tracks for autoplay.
-
-```javascript
-const result = await manager.getRelated(currentTrack, 5);
-// { tracks: [...] }
-```
-
-### getStats()
-
-Gets manager statistics.
-
-```javascript
-const stats = manager.getStats();
-// {
-//     players: 5,
-//     playingPlayers: 3,
-//     memory: { heapUsed: 52428800, ... }
-// }
-```
-
-## Events
-
-```javascript
-manager.on('playerCreate', (player) => {
-    console.log(`Player created: ${player.guildId}`);
-});
-
-manager.on('playerDestroy', (player) => {
-    console.log(`Player destroyed: ${player.guildId}`);
-});
-```
-
-## Properties
-
-```javascript
-manager.players      // Map<guildId, Player>
-manager.client       // Discord.js client
-manager.config       // Resolved configuration
-```

package/docs/discord/player.md

@@ -1,263 +0,0 @@
-# Player
-
-The Player handles playback, filters, and voice connection for a single guild.
-
-## Getting a Player
-
-```javascript
-// Create new or get existing
-const player = await manager.create(guildId, voiceChannelId, textChannelId);
-
-// Get existing only
-const player = manager.get(guildId);
-```
-
-## Playback Methods
-
-### play(track, options?)
-
-Plays a track immediately. If something is playing, adds to queue and skips.
-
-```javascript
-const result = await manager.search('never gonna give you up');
-await player.play(result.tracks[0]);
-```
-
-**Options:**
-- `startPosition` - Start playback at a specific position in milliseconds
-- `volume` - Set volume before playing (0-200)
-- `filters` - Apply filters before playing
-- `replace` - Replace current track without adding to queue/history
-
-```javascript
-// Start playing at 30 seconds
-await player.play(track, { startPosition: 30000 });
-
-// Start with specific volume
-await player.play(track, { volume: 50 });
-
-// Start with filters applied
-await player.play(track, { filters: { bass: 10, nightcore: true } });
-
-// Replace current track without queueing
-await player.play(track, { replace: true });
-
-// Combine options
-await player.play(track, {
-    startPosition: savedPositionMs,
-    volume: savedVolume,
-    filters: savedFilters,
-    replace: true
-});
-```
-
-### pause()
-
-Pauses playback and destroys the stream to save resources.
-
-```javascript
-player.pause();
-```
-
-### resume()
-
-Resumes playback by recreating the stream and seeking to the saved position.
-
-```javascript
-await player.resume();
-```
-
-### skip()
-
-Skips to the next track in queue.
-
-```javascript
-await player.skip();
-```
-
-### previous()
-
-Goes back to the previous track.
-
-```javascript
-await player.previous();
-```
-
-### stop()
-
-Stops playback and clears the queue.
-
-```javascript
-player.stop();
-```
-
-### seek(positionMs)
-
-Seeks to a position in milliseconds.
-
-```javascript
-await player.seek(30000);  // Seek to 30 seconds
-```
-
-## Volume
-
-```javascript
-// Set volume (0-200)
-player.setVolume(80);
-
-// Get current volume
-console.log(player.volume);  // 80
-```
-
-## Filters
-
-```javascript
-// Set a filter
-await player.setFilter('bass', 10);
-await player.setFilter('nightcore', true);
-
-// Clear all filters
-await player.clearFilters();
-
-// Get current filters
-console.log(player.filters);  // { bass: 10, nightcore: true }
-```
-
-See [Filters](../filters.md) for all available filters.
-
-## Effect Presets
-
-Effect presets are pre-configured filter combinations that stack by default.
-
-```javascript
-// Apply a single preset
-await player.setEffectPresets(['bassboost']);
-
-// Apply multiple presets (they stack)
-await player.setEffectPresets(['nightcore', 'bassboost']);
-
-// Apply with custom intensity (0.1 - 1.0)
-await player.setEffectPresets([
-    { name: 'nightcore', intensity: 0.8 },
-    { name: 'bassboost', intensity: 0.5 }
-]);
-
-// Replace all presets instead of stacking
-await player.setEffectPresets(['8d'], { replace: true });
-
-// Get active presets
-const active = player.getActiveEffectPresets();
-// [{ name: 'nightcore', intensity: 0.8 }, { name: 'bassboost', intensity: 0.5 }]
-
-// Clear all effect presets
-await player.clearEffectPresets();
-
-// List available presets
-const presets = player.getEffectPresets();
-// ['bassboost', 'nightcore', 'vaporwave', '8d', 'karaoke', ...]
-```
-
-**Available Presets:**
-- `bassboost` - Boost bass frequencies
-- `nightcore` - Speed up with higher pitch
-- `vaporwave` - Slow down with lower pitch
-- `8d` - 8D rotating audio effect
-- `karaoke` - Reduce vocals
-- `reverb` - Add room acoustics / echo
-- `surround` - Virtual surround sound mapping
-- `boost` - General volume and clarity boost
-- `subboost` - Extreme sub-woofer boost
-- `trebleboost` - Boost treble frequencies
-- `deep` - Deep bass with lower pitch
-- `lofi` - Lo-fi aesthetic
-- `radio` - Radio/telephone effect
-- `telephone` - Old telephone effect
-- `soft` - Softer, quieter sound
-- `loud` - Louder, compressed sound
-- `chipmunk` - High-pitched voice
-- `darth` - Deep Darth Vader voice
-- `echo` - Echo/reverb effect
-- `vibrato` - Vibrato effect
-- `tremolo` - Tremolo effect
-
-## Loop Modes
-
-```javascript
-player.setLoop('off');     // No looping
-player.setLoop('track');   // Loop current track
-player.setLoop('queue');   // Loop entire queue
-```
-
-## Toggles
-
-```javascript
-// Autoplay (play related tracks when queue ends)
-player.setAutoplay(true);
-player.setAutoplay(false);
-
-// Auto-pause (pause when channel empty)
-player.setAutoPause(true);
-player.setAutoPause(false);
-```
-
-## Connection
-
-```javascript
-// Connect to voice
-await player.connect();
-
-// Disconnect (keeps player)
-player.disconnect();
-
-// Destroy player completely
-player.destroy();
-```
-
-## State Properties
-
-```javascript
-player.connected    // true if connected to voice
-player.playing      // true if playing (not paused)
-player.paused       // true if paused
-player.position     // Current position in ms
-player.volume       // Current volume (0-200)
-player.filters      // Current filters object
-
-player.guildId          // Guild ID
-player.voiceChannelId   // Voice channel ID
-player.textChannelId    // Text channel ID
-
-player.autoplay     // { enabled, maxTracks }
-player.autoPause    // { enabled, minUsers }
-player.autoLeave    // { enabled, emptyDelay, inactivityTimeout }
-```
-
-## Queue Access
-
-```javascript
-player.queue.current   // Currently playing track
-player.queue.tracks    // Upcoming tracks
-player.queue.previous  // Previously played tracks
-```
-
-See [Queue](./queue.md) for queue methods.
-
-## Serialization
-
-```javascript
-const json = player.toJSON();
-// {
-//     guildId: '...',
-//     voiceChannelId: '...',
-//     connected: true,
-//     playing: true,
-//     paused: false,
-//     volume: 80,
-//     position: 45000,
-//     filters: { bass: 10 },
-//     queue: { current: {...}, tracks: [...] },
-//     autoplay: { enabled: false },
-//     autoPause: { enabled: true },
-//     autoLeave: { enabled: true }
-// }
-```