discord.js-selfv13 13.0.1

package/docs/topics/voice.md

@@ -0,0 +1,113 @@
+# Introduction to Voice
+Voice in discord.js can be used for many things, such as music bots, recording or relaying audio.
+
+In discord.js, you can use voice by connecting to a `VoiceChannel` to obtain a `VoiceConnection`, where you can start streaming and receiving audio.
+
+To get started, make sure you have:
+* FFmpeg - `npm install ffmpeg-binaries`
+* an opus encoder, choose one from below:
+  * `npm install opusscript`
+  * `npm install node-opus`
+* a good network connection
+
+The preferred opus engine is node-opus, as it performs significantly better than opusscript. When both are available, discord.js will automatically choose node-opus.
+Using opusscript is only recommended for development environments where node-opus is tough to get working.
+For production bots, using node-opus should be considered a necessity, especially if they're going to be running on multiple servers.
+
+## Joining a voice channel
+The example below reacts to a message and joins the sender's voice channel, catching any errors. This is important
+as it allows us to obtain a `VoiceConnection` that we can start to stream audio with.
+
+```js
+const Discord = require('discord.js');
+const client = new Discord.Client();
+
+client.login('token here');
+
+client.on('message', message => {
+  // Voice only works in guilds, if the message does not come from a guild,
+  // we ignore it
+  if (!message.guild) return;
+
+  if (message.content === '/join') {
+    // Only try to join the sender's voice channel if they are in one themselves
+    if (message.member.voiceChannel) {
+      message.member.voiceChannel.join()
+        .then(connection => { // Connection is an instance of VoiceConnection
+          message.reply('I have successfully connected to the channel!');
+        })
+        .catch(console.log);
+    } else {
+      message.reply('You need to join a voice channel first!');
+    }
+  }
+});
+```
+
+## Streaming to a Voice Channel
+In the previous example, we looked at how to join a voice channel in order to obtain a `VoiceConnection`. Now that we
+have obtained a voice connection, we can start streaming audio to it. The following example shows how to stream an mp3
+file:
+
+**Playing a file:**
+```js
+// To play a file, we need to give an absolute path to it
+const dispatcher = connection.playFile('C:/Users/Discord/Desktop/myfile.mp3');
+```
+
+Your file doesn't have to be just an mp3; ffmpeg can convert videos and audios of many formats.
+
+The `dispatcher` variable is an instance of a `StreamDispatcher`, which manages streaming a specific resource to a voice
+channel. We can do many things with the dispatcher, such as finding out when the stream ends or changing the volume:
+
+```js
+dispatcher.on('end', () => {
+  // The song has finished
+});
+
+dispatcher.on('error', e => {
+  // Catch any errors that may arise
+  console.log(e);
+});
+
+dispatcher.setVolume(0.5); // Set the volume to 50%
+dispatcher.setVolume(1); // Set the volume back to 100%
+
+console.log(dispatcher.time); // The time in milliseconds that the stream dispatcher has been playing for
+
+dispatcher.pause(); // Pause the stream
+dispatcher.resume(); // Carry on playing
+
+dispatcher.end(); // End the dispatcher, emits 'end' event
+```
+
+If you have an existing [ReadableStream](https://nodejs.org/api/stream.html#stream_readable_streams),
+this can also be used:
+
+**Playing a ReadableStream:**
+```js
+connection.playStream(myReadableStream);
+
+// If you don't want to use absolute paths, you can use
+// fs.createReadStream to circumvent it
+
+const fs = require('fs');
+const stream = fs.createReadStream('./test.mp3');
+connection.playStream(stream);
+```
+
+It's important to note that creating a readable stream to a file is less efficient than simply using `connection.playFile()`.
+
+**Playing anything else:**
+
+For anything else, such as a URL to a file, you can use `connection.playArbitraryInput()`. You should consult the [ffmpeg protocol documentation](https://ffmpeg.org/ffmpeg-protocols.html) to see what you can use this for.
+
+```js
+// Play an mp3 from a URL
+connection.playArbitraryInput('http://mysite.com/sound.mp3');
+```
+
+Again, playing a file from a URL like this is more performant than creating a ReadableStream to the file.
+
+## Advanced Topics
+soon:tm:

package/docs/topics/web.md

@@ -0,0 +1,38 @@
+# Web builds
+In addition to your usual Node applications, discord.js has special distributions available that are capable of running in web browsers.
+This is useful for client-side web apps that need to interact with the Discord API.
+[Webpack 3](https://webpack.js.org/) is used to build these.
+
+## Usage
+You can obtain your desired version of discord.js' web build from the [webpack branch](https://github.com/discordjs/discord.js/tree/webpack) of the GitHub repository.
+There is a file for each branch and version of the library, and the ones ending in `.min.js` are minified to substantially reduce the size of the source code.
+
+Include the file on the page just as you would any other JS library, like so:
+```html
+<script type="text/javascript" src="discord.VERSION.min.js"></script>
+```
+
+Rather than importing discord.js with `require('discord.js')`, the entire `Discord` object is available as a global (on the `window`) object.
+The usage of the API isn't any different from using it in Node.js.
+
+## Restrictions
+- Any voice-related functionality is unavailable, as there is currently no audio encoding/decoding capabilities without external native libraries,
+  which web browsers do not support.
+- The ShardingManager cannot be used, since it relies on being able to spawn child processes for shards.
+- None of the optional packages are usable, since they're native libraries.
+
+## Example
+```html
+<script type="text/javascript" src="discord.11.5.0.min.js"></script>
+<script type="text/javascript">
+  const client = new Discord.Client();
+
+  client.on('message', msg => {
+    const guildTag = msg.channel.type === 'text' ? `[${msg.guild.name}]` : '[DM]';
+    const channelTag = msg.channel.type === 'text' ? `[#${msg.channel.name}]` : '';
+    console.log(`${guildTag}${channelTag} ${msg.author.tag}: ${msg.content}`);
+  });
+
+  client.login('some crazy token');
+</script>
+```

package/package.json

@@ -0,0 +1,147 @@
+{
+  "_from": "discord.js-selfv13@^13.0.1",
+  "_id": "discord.js-selfv13@^13.0.1",
+  "_inBundle": false,
+  "_integrity": "sha512-KjeHn3N3PBJZhDZQUcs3riKinMLC7pJy0jiNxzSyF9cVPBZl6CfayUC0d8GQ0I5bf3uc+zKjZfRTjIdcb3zsMA==",
+  "_location": "/discord.js-selfv13",
+  "_phantomChildren": {},
+  "_requested": {
+    "type": "range",
+    "registry": true,
+    "raw": "discord.js-selfv13@^13.0.1",
+    "name": "discord.js-selfv13",
+    "escapedName": "discord.js-selfv13",
+    "rawSpec": "^13.0.1",
+    "saveSpec": null,
+    "fetchSpec": "^13.0.1"
+  },
+  "_requiredBy": [
+    "/"
+  ],
+  "_resolved": "https://registry.npmjs.org/discord.js-selfv13/-/discordjs-selfv13-13.0.1.tgz",
+  "_shasum": "ae0b20c3f560c1bdfb831fed89d40efafbdb96c7",
+  "_spec": "discord.js-selfv13@^13.0.1",
+  "author": {
+    "name": "evilkaue"
+  },
+  "browser": {
+    "ws": false,
+    "uws": false,
+    "@discordjs/uws": false,
+    "erlpack": false,
+    "prism-media": false,
+    "opusscript": false,
+    "node-opus": false,
+    "tweetnacl": false,
+    "sodium": false,
+    "src/sharding/Shard.js": false,
+    "src/sharding/ShardClientUtil.js": false,
+    "src/sharding/ShardingManager.js": false,
+    "src/client/voice/dispatcher/StreamDispatcher.js": false,
+    "src/client/voice/opus/BaseOpusEngine.js": false,
+    "src/client/voice/opus/NodeOpusEngine.js": false,
+    "src/client/voice/opus/OpusEngineList.js": false,
+    "src/client/voice/opus/OpusScriptEngine.js": false,
+    "src/client/voice/pcm/ConverterEngine.js": false,
+    "src/client/voice/pcm/ConverterEngineList.js": false,
+    "src/client/voice/pcm/FfmpegConverterEngine.js": false,
+    "src/client/voice/player/AudioPlayer.js": false,
+    "src/client/voice/receiver/VoiceReadable.js": false,
+    "src/client/voice/receiver/VoiceReceiver.js": false,
+    "src/client/voice/util/Secretbox.js": false,
+    "src/client/voice/util/SecretKey.js": false,
+    "src/client/voice/util/VolumeInterface.js": false,
+    "src/client/voice/ClientVoiceManager.js": false,
+    "src/client/voice/VoiceBroadcast.js": false,
+    "src/client/voice/VoiceConnection.js": false,
+    "src/client/voice/VoiceUDPClient.js": false,
+    "src/client/voice/VoiceWebSocket.js": false
+  },
+  "bugs": {
+    "url": "https://github.com/discordjs/discord.js/issues"
+  },
+  "bundleDependencies": false,
+  "dependencies": {
+    "long": "^4.0.0",
+    "prism-media": "^0.0.3",
+    "snekfetch": "^3.6.4",
+    "tweetnacl": "^1.0.0",
+    "ws": "^6.0.0"
+  },
+  "deprecated": false,
+  "description": "Discord.js module for selfbots (automated user accounts).",
+  "devDependencies": {
+    "@types/node": "^9.4.6",
+    "discord.js-docgen": "github:discordjs/docgen",
+    "eslint": "^5.4.0",
+    "parallel-webpack": "^2.3.0",
+    "tslint": "^3.15.1",
+    "tslint-config-typings": "^0.2.4",
+    "typescript": "^3.0.1",
+    "uglifyjs-webpack-plugin": "^1.3.0",
+    "webpack": "^4.17.0"
+  },
+  "directories": {
+    "doc": "docs",
+    "test": "test"
+  },
+  "engines": {
+    "node": ">=6.0.0"
+  },
+  "homepage": "https://github.com/discordjs/discord.js#readme",
+  "keywords": [
+    "discord",
+    "api",
+    "bot",
+    "client",
+    "node",
+    "discordapp"
+  ],
+  "license": "Apache-2.0",
+  "main": "./src/index",
+  "name": "discord.js-selfv13",
+  "peerDependencies": {
+    "@discordjs/uws": "^10.149.0",
+    "bufferutil": "^4.0.0",
+    "erlpack": "discordapp/erlpack",
+    "libsodium-wrappers": "^0.7.3",
+    "node-opus": "^0.2.7",
+    "opusscript": "^0.0.6",
+    "sodium": "^2.0.3"
+  },
+  "peerDependenciesMeta": {
+    "bufferutil": {
+      "optional": true
+    },
+    "erlpack": {
+      "optional": true
+    },
+    "node-opus": {
+      "optional": true
+    },
+    "opusscript": {
+      "optional": true
+    },
+    "sodium": {
+      "optional": true
+    },
+    "libsodium-wrappers": {
+      "optional": true
+    },
+    "uws": {
+      "optional": true
+    }
+  },
+  "runkitExampleFilename": "./docs/examples/ping.js",
+  "scripts": {
+    "docs": "docgen --source src --custom docs/index.yml --output docs/docs.json",
+    "docs:test": "docgen --source src --custom docs/index.yml",
+    "lint": "eslint src",
+    "lint:fix": "eslint --fix src",
+    "lint:typings": "tslint typings/index.d.ts typings/discord.js-test.ts",
+    "test": "npm run lint && npm run docs:test",
+    "webpack": "parallel-webpack"
+  },
+  "types": "./typings/index.d.ts",
+  "version": "13.0.1"
+}