@discordjs/voice 0.5.6 → 0.7.2

package/dist/audio/AudioResource.js

@@ -1,164 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAudioResource = exports.inferStreamType = exports.NO_CONSTRAINT = exports.VOLUME_CONSTRAINT = exports.AudioResource = void 0;
-const TransformerGraph_1 = require("./TransformerGraph");
-const stream_1 = require("stream");
-const util_1 = require("../util/util");
-const prism_media_1 = require("prism-media");
-const AudioPlayer_1 = require("./AudioPlayer");
-/**
- * Represents an audio resource that can be played by an audio player.
- *
- * @template T - the type for the metadata (if any) of the audio resource.
- */
-class AudioResource {
-    constructor(edges, streams, metadata, silencePaddingFrames) {
-        /**
-         * The playback duration of this audio resource, given in milliseconds.
-         */
-        this.playbackDuration = 0;
-        /**
-         * Whether or not the stream for this resource has started (data has become readable)
-         */
-        this.started = false;
-        /**
-         * The number of remaining silence frames to play. If -1, the frames have not yet started playing.
-         */
-        this.silenceRemaining = -1;
-        this.edges = edges;
-        this.playStream = streams.length > 1 ? stream_1.pipeline(streams, util_1.noop) : streams[0];
-        this.metadata = metadata;
-        this.silencePaddingFrames = silencePaddingFrames;
-        for (const stream of streams) {
-            if (stream instanceof prism_media_1.VolumeTransformer) {
-                this.volume = stream;
-            }
-            else if (stream instanceof prism_media_1.opus.Encoder) {
-                this.encoder = stream;
-            }
-        }
-        stream_1.once(this.playStream, 'readable')
-            .then(() => (this.started = true))
-            .catch(util_1.noop);
-    }
-    /**
-     * Whether this resource is readable. If the underlying resource is no longer readable, this will still return true
-     * while there are silence padding frames left to play.
-     */
-    get readable() {
-        if (this.silenceRemaining === 0)
-            return false;
-        const real = this.playStream.readable;
-        if (!real) {
-            if (this.silenceRemaining === -1)
-                this.silenceRemaining = this.silencePaddingFrames;
-            return this.silenceRemaining !== 0;
-        }
-        return real;
-    }
-    /**
-     * Whether this resource has ended or not.
-     */
-    get ended() {
-        return this.playStream.readableEnded || this.playStream.destroyed || this.silenceRemaining === 0;
-    }
-    /**
-     * Attempts to read an Opus packet from the audio resource. If a packet is available, the playbackDuration
-     * is incremented.
-     * @internal
-     * @remarks
-     * It is advisable to check that the playStream is readable before calling this method. While no runtime
-     * errors will be thrown, you should check that the resource is still available before attempting to
-     * read from it.
-     */
-    read() {
-        if (this.silenceRemaining === 0) {
-            return null;
-        }
-        else if (this.silenceRemaining > 0) {
-            this.silenceRemaining--;
-            return AudioPlayer_1.SILENCE_FRAME;
-        }
-        const packet = this.playStream.read();
-        if (packet) {
-            this.playbackDuration += 20;
-        }
-        return packet;
-    }
-}
-exports.AudioResource = AudioResource;
-/**
- * Ensures that a path contains at least one volume transforming component
- *
- * @param path - The path to validate constraints on
- */
-const VOLUME_CONSTRAINT = (path) => path.some((edge) => edge.type === TransformerGraph_1.TransformerType.InlineVolume);
-exports.VOLUME_CONSTRAINT = VOLUME_CONSTRAINT;
-const NO_CONSTRAINT = () => true;
-exports.NO_CONSTRAINT = NO_CONSTRAINT;
-/**
- * Tries to infer the type of a stream to aid with transcoder pipelining.
- *
- * @param stream - The stream to infer the type of
- */
-function inferStreamType(stream) {
-    if (stream instanceof prism_media_1.opus.Encoder) {
-        return { streamType: TransformerGraph_1.StreamType.Opus, hasVolume: false };
-    }
-    else if (stream instanceof prism_media_1.opus.Decoder) {
-        return { streamType: TransformerGraph_1.StreamType.Raw, hasVolume: false };
-    }
-    else if (stream instanceof prism_media_1.VolumeTransformer) {
-        return { streamType: TransformerGraph_1.StreamType.Raw, hasVolume: true };
-    }
-    else if (stream instanceof prism_media_1.opus.OggDemuxer) {
-        return { streamType: TransformerGraph_1.StreamType.Opus, hasVolume: false };
-    }
-    else if (stream instanceof prism_media_1.opus.WebmDemuxer) {
-        return { streamType: TransformerGraph_1.StreamType.Opus, hasVolume: false };
-    }
-    return { streamType: TransformerGraph_1.StreamType.Arbitrary, hasVolume: false };
-}
-exports.inferStreamType = inferStreamType;
-/**
- * Creates an audio resource that can be played be audio players.
- *
- * @remarks
- * If the input is given as a string, then the inputType option will be overridden and FFmpeg will be used.
- *
- * If the input is not in the correct format, then a pipeline of transcoders and transformers will be created
- * to ensure that the resultant stream is in the correct format for playback. This could involve using FFmpeg,
- * Opus transcoders, and Ogg/WebM demuxers.
- *
- * @param input - The resource to play.
- * @param options - Configurable options for creating the resource.
- *
- * @template T - the type for the metadata (if any) of the audio resource.
- */
-function createAudioResource(input, options = {}) {
-    var _a, _b, _c, _d;
-    let inputType = options.inputType;
-    let needsInlineVolume = Boolean(options.inlineVolume);
-    // string inputs can only be used with FFmpeg
-    if (typeof input === 'string') {
-        inputType = TransformerGraph_1.StreamType.Arbitrary;
-    }
-    else if (typeof inputType === 'undefined') {
-        const analysis = inferStreamType(input);
-        inputType = analysis.streamType;
-        needsInlineVolume = needsInlineVolume && !analysis.hasVolume;
-    }
-    const transformerPipeline = TransformerGraph_1.findPipeline(inputType, needsInlineVolume ? exports.VOLUME_CONSTRAINT : exports.NO_CONSTRAINT);
-    if (transformerPipeline.length === 0) {
-        if (typeof input === 'string')
-            throw new Error(`Invalid pipeline constructed for string resource '${input}'`);
-        // No adjustments required
-        return new AudioResource([], [input], ((_a = options.metadata) !== null && _a !== void 0 ? _a : null), (_b = options.silencePaddingFrames) !== null && _b !== void 0 ? _b : 5);
-    }
-    const streams = transformerPipeline.map((edge) => edge.transformer(input));
-    if (typeof input !== 'string')
-        streams.unshift(input);
-    return new AudioResource(transformerPipeline, streams, ((_c = options.metadata) !== null && _c !== void 0 ? _c : null), (_d = options.silencePaddingFrames) !== null && _d !== void 0 ? _d : 5);
-}
-exports.createAudioResource = createAudioResource;
-//# sourceMappingURL=AudioResource.js.map

package/dist/audio/AudioResource.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AudioResource.js","sourceRoot":"","sources":["../../src/audio/AudioResource.ts"],"names":[],"mappings":"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","sourcesContent":["import { Edge, findPipeline, StreamType, TransformerType } from './TransformerGraph';\nimport { once, pipeline, Readable } from 'stream';\nimport { noop } from '../util/util';\nimport { VolumeTransformer, opus } from 'prism-media';\nimport { AudioPlayer, SILENCE_FRAME } from './AudioPlayer';\n\n/**\n * Options that are set when creating a new audio resource.\n *\n * @template T - the type for the metadata (if any) of the audio resource.\n */\ninterface CreateAudioResourceOptions<T> {\n\t/**\n\t * The type of the input stream. Defaults to `StreamType.Arbitrary`.\n\t */\n\tinputType?: StreamType;\n\n\t/**\n\t * Optional metadata that can be attached to the resource (e.g. track title, random ID).\n\t * This is useful for identification purposes when the resource is passed around in events.\n\t * See {@link AudioResource.metadata}\n\t */\n\tmetadata?: T;\n\n\t/**\n\t * Whether or not inline volume should be enabled. If enabled, you will be able to change the volume\n\t * of the stream on-the-fly. However, this also increases the performance cost of playback. Defaults to `false`.\n\t */\n\tinlineVolume?: boolean;\n\n\t/**\n\t * The number of silence frames to append to the end of the resource's audio stream, to prevent interpolation glitches.\n\t * Defaults to 5.\n\t */\n\tsilencePaddingFrames?: number;\n}\n\n/**\n * Represents an audio resource that can be played by an audio player.\n *\n * @template T - the type for the metadata (if any) of the audio resource.\n */\nexport class AudioResource<T = unknown> {\n\t/**\n\t * An object-mode Readable stream that emits Opus packets. This is what is played by audio players.\n\t */\n\tpublic readonly playStream: Readable;\n\n\t/**\n\t * The pipeline used to convert the input stream into a playable format. For example, this may\n\t * contain an FFmpeg component for arbitrary inputs, and it may contain a VolumeTransformer component\n\t * for resources with inline volume transformation enabled.\n\t */\n\tpublic readonly edges: readonly Edge[];\n\n\t/**\n\t * Optional metadata that can be used to identify the resource.\n\t */\n\tpublic metadata: T;\n\n\t/**\n\t * If the resource was created with inline volume transformation enabled, then this will be a\n\t * prism-media VolumeTransformer. You can use this to alter the volume of the stream.\n\t */\n\tpublic readonly volume?: VolumeTransformer;\n\n\t/**\n\t * If using an Opus encoder to create this audio resource, then this will be a prism-media opus.Encoder.\n\t * You can use this to control settings such as bitrate, FEC, PLP.\n\t */\n\tpublic readonly encoder?: opus.Encoder;\n\n\t/**\n\t * The audio player that the resource is subscribed to, if any.\n\t */\n\tpublic audioPlayer?: AudioPlayer;\n\n\t/**\n\t * The playback duration of this audio resource, given in milliseconds.\n\t */\n\tpublic playbackDuration = 0;\n\n\t/**\n\t * Whether or not the stream for this resource has started (data has become readable)\n\t */\n\tpublic started = false;\n\n\t/**\n\t * The number of silence frames to append to the end of the resource's audio stream, to prevent interpolation glitches.\n\t */\n\tpublic readonly silencePaddingFrames: number;\n\n\t/**\n\t * The number of remaining silence frames to play. If -1, the frames have not yet started playing.\n\t */\n\tpublic silenceRemaining = -1;\n\n\tpublic constructor(edges: readonly Edge[], streams: readonly Readable[], metadata: T, silencePaddingFrames: number) {\n\t\tthis.edges = edges;\n\t\tthis.playStream = streams.length > 1 ? (pipeline(streams, noop) as any as Readable) : streams[0];\n\t\tthis.metadata = metadata;\n\t\tthis.silencePaddingFrames = silencePaddingFrames;\n\n\t\tfor (const stream of streams) {\n\t\t\tif (stream instanceof VolumeTransformer) {\n\t\t\t\tthis.volume = stream;\n\t\t\t} else if (stream instanceof opus.Encoder) {\n\t\t\t\tthis.encoder = stream;\n\t\t\t}\n\t\t}\n\n\t\tonce(this.playStream, 'readable')\n\t\t\t.then(() => (this.started = true))\n\t\t\t.catch(noop);\n\t}\n\n\t/**\n\t * Whether this resource is readable. If the underlying resource is no longer readable, this will still return true\n\t * while there are silence padding frames left to play.\n\t */\n\tpublic get readable() {\n\t\tif (this.silenceRemaining === 0) return false;\n\t\tconst real = this.playStream.readable;\n\t\tif (!real) {\n\t\t\tif (this.silenceRemaining === -1) this.silenceRemaining = this.silencePaddingFrames;\n\t\t\treturn this.silenceRemaining !== 0;\n\t\t}\n\t\treturn real;\n\t}\n\n\t/**\n\t * Whether this resource has ended or not.\n\t */\n\tpublic get ended() {\n\t\treturn this.playStream.readableEnded || this.playStream.destroyed || this.silenceRemaining === 0;\n\t}\n\n\t/**\n\t * Attempts to read an Opus packet from the audio resource. If a packet is available, the playbackDuration\n\t * is incremented.\n\t * @internal\n\t * @remarks\n\t * It is advisable to check that the playStream is readable before calling this method. While no runtime\n\t * errors will be thrown, you should check that the resource is still available before attempting to\n\t * read from it.\n\t */\n\tpublic read(): Buffer | null {\n\t\tif (this.silenceRemaining === 0) {\n\t\t\treturn null;\n\t\t} else if (this.silenceRemaining > 0) {\n\t\t\tthis.silenceRemaining--;\n\t\t\treturn SILENCE_FRAME;\n\t\t}\n\t\tconst packet: Buffer | null = this.playStream.read();\n\t\tif (packet) {\n\t\t\tthis.playbackDuration += 20;\n\t\t}\n\t\treturn packet;\n\t}\n}\n\n/**\n * Ensures that a path contains at least one volume transforming component\n *\n * @param path - The path to validate constraints on\n */\nexport const VOLUME_CONSTRAINT = (path: Edge[]) => path.some((edge) => edge.type === TransformerType.InlineVolume);\n\nexport const NO_CONSTRAINT = () => true;\n\n/**\n * Tries to infer the type of a stream to aid with transcoder pipelining.\n *\n * @param stream - The stream to infer the type of\n */\nexport function inferStreamType(stream: Readable): {\n\tstreamType: StreamType;\n\thasVolume: boolean;\n} {\n\tif (stream instanceof opus.Encoder) {\n\t\treturn { streamType: StreamType.Opus, hasVolume: false };\n\t} else if (stream instanceof opus.Decoder) {\n\t\treturn { streamType: StreamType.Raw, hasVolume: false };\n\t} else if (stream instanceof VolumeTransformer) {\n\t\treturn { streamType: StreamType.Raw, hasVolume: true };\n\t} else if (stream instanceof opus.OggDemuxer) {\n\t\treturn { streamType: StreamType.Opus, hasVolume: false };\n\t} else if (stream instanceof opus.WebmDemuxer) {\n\t\treturn { streamType: StreamType.Opus, hasVolume: false };\n\t}\n\treturn { streamType: StreamType.Arbitrary, hasVolume: false };\n}\n\nexport function createAudioResource<T>(\n\tinput: string | Readable,\n\toptions: CreateAudioResourceOptions<T> &\n\t\tPick<\n\t\t\tT extends null | undefined ? CreateAudioResourceOptions<T> : Required<CreateAudioResourceOptions<T>>,\n\t\t\t'metadata'\n\t\t>,\n): AudioResource<T extends null | undefined ? null : T>;\n\nexport function createAudioResource<T extends null | undefined>(\n\tinput: string | Readable,\n\toptions?: Omit<CreateAudioResourceOptions<T>, 'metadata'>,\n): AudioResource<null>;\n\n/**\n * Creates an audio resource that can be played be audio players.\n *\n * @remarks\n * If the input is given as a string, then the inputType option will be overridden and FFmpeg will be used.\n *\n * If the input is not in the correct format, then a pipeline of transcoders and transformers will be created\n * to ensure that the resultant stream is in the correct format for playback. This could involve using FFmpeg,\n * Opus transcoders, and Ogg/WebM demuxers.\n *\n * @param input - The resource to play.\n * @param options - Configurable options for creating the resource.\n *\n * @template T - the type for the metadata (if any) of the audio resource.\n */\nexport function createAudioResource<T>(\n\tinput: string | Readable,\n\toptions: CreateAudioResourceOptions<T> = {},\n): AudioResource<T> {\n\tlet inputType = options.inputType;\n\tlet needsInlineVolume = Boolean(options.inlineVolume);\n\n\t// string inputs can only be used with FFmpeg\n\tif (typeof input === 'string') {\n\t\tinputType = StreamType.Arbitrary;\n\t} else if (typeof inputType === 'undefined') {\n\t\tconst analysis = inferStreamType(input);\n\t\tinputType = analysis.streamType;\n\t\tneedsInlineVolume = needsInlineVolume && !analysis.hasVolume;\n\t}\n\n\tconst transformerPipeline = findPipeline(inputType, needsInlineVolume ? VOLUME_CONSTRAINT : NO_CONSTRAINT);\n\n\tif (transformerPipeline.length === 0) {\n\t\tif (typeof input === 'string') throw new Error(`Invalid pipeline constructed for string resource '${input}'`);\n\t\t// No adjustments required\n\t\treturn new AudioResource<T>([], [input], (options.metadata ?? null) as T, options.silencePaddingFrames ?? 5);\n\t}\n\tconst streams = transformerPipeline.map((edge) => edge.transformer(input));\n\tif (typeof input !== 'string') streams.unshift(input);\n\n\treturn new AudioResource<T>(\n\t\ttransformerPipeline,\n\t\tstreams,\n\t\t(options.metadata ?? null) as T,\n\t\toptions.silencePaddingFrames ?? 5,\n\t);\n}\n"]}

package/dist/audio/PlayerSubscription.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlayerSubscription = void 0;
-/**
- * Represents a subscription of a voice connection to an audio player, allowing
- * the audio player to play audio on the voice connection.
- */
-class PlayerSubscription {
-    constructor(connection, player) {
-        this.connection = connection;
-        this.player = player;
-    }
-    /**
-     * Unsubscribes the connection from the audio player, meaning that the
-     * audio player cannot stream audio to it until a new subscription is made.
-     */
-    unsubscribe() {
-        this.connection['onSubscriptionRemoved'](this);
-        this.player['unsubscribe'](this);
-    }
-}
-exports.PlayerSubscription = PlayerSubscription;
-//# sourceMappingURL=PlayerSubscription.js.map

package/dist/audio/PlayerSubscription.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PlayerSubscription.js","sourceRoot":"","sources":["../../src/audio/PlayerSubscription.ts"],"names":[],"mappings":";;;AAIA;;;GAGG;AACH,MAAa,kBAAkB;IAW9B,YAAmB,UAA2B,EAAE,MAAmB;QAClE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED;;;OAGG;IACI,WAAW;QACjB,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACD;AAxBD,gDAwBC","sourcesContent":["/* eslint-disable @typescript-eslint/dot-notation */\nimport { VoiceConnection } from '../VoiceConnection';\nimport { AudioPlayer } from './AudioPlayer';\n\n/**\n * Represents a subscription of a voice connection to an audio player, allowing\n * the audio player to play audio on the voice connection.\n */\nexport class PlayerSubscription {\n\t/**\n\t * The voice connection of this subscription\n\t */\n\tpublic readonly connection: VoiceConnection;\n\n\t/**\n\t * The audio player of this subscription\n\t */\n\tpublic readonly player: AudioPlayer;\n\n\tpublic constructor(connection: VoiceConnection, player: AudioPlayer) {\n\t\tthis.connection = connection;\n\t\tthis.player = player;\n\t}\n\n\t/**\n\t * Unsubscribes the connection from the audio player, meaning that the\n\t * audio player cannot stream audio to it until a new subscription is made.\n\t */\n\tpublic unsubscribe() {\n\t\tthis.connection['onSubscriptionRemoved'](this);\n\t\tthis.player['unsubscribe'](this);\n\t}\n}\n"]}

package/dist/audio/TransformerGraph.js

@@ -1,233 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.findPipeline = exports.getNode = exports.Node = exports.TransformerType = exports.StreamType = void 0;
-const prism = __importStar(require("prism-media"));
-/*
-    This module creates a Transformer Graph to figure out what the most efficient way
-    of transforming the input stream into something playable would be.
-*/
-const FFMPEG_PCM_ARGUMENTS = ['-analyzeduration', '0', '-loglevel', '0', '-f', 's16le', '-ar', '48000', '-ac', '2'];
-const FFMPEG_OPUS_ARGUMENTS = [
-    '-analyzeduration',
-    '0',
-    '-loglevel',
-    '0',
-    '-acodec',
-    'libopus',
-    '-f',
-    'opus',
-    '-ar',
-    '48000',
-    '-ac',
-    '2',
-];
-/**
- * The different types of stream that can exist within the pipeline
- *
- * @remarks
- * - `Arbitrary` - the type of the stream at this point is unknown.
- *
- * - `Raw` - the stream at this point is s16le PCM.
- *
- * - `OggOpus` - the stream at this point is Opus audio encoded in an Ogg wrapper.
- *
- * - `WebmOpus` - the stream at this point is Opus audio encoded in a WebM wrapper.
- *
- * - `Opus` - the stream at this point is Opus audio, and the stream is in object-mode. This is ready to play.
- */
-var StreamType;
-(function (StreamType) {
-    StreamType["Arbitrary"] = "arbitrary";
-    StreamType["Raw"] = "raw";
-    StreamType["OggOpus"] = "ogg/opus";
-    StreamType["WebmOpus"] = "webm/opus";
-    StreamType["Opus"] = "opus";
-})(StreamType = exports.StreamType || (exports.StreamType = {}));
-/**
- * The different types of transformers that can exist within the pipeline
- */
-var TransformerType;
-(function (TransformerType) {
-    TransformerType["FFmpegPCM"] = "ffmpeg pcm";
-    TransformerType["FFmpegOgg"] = "ffmpeg ogg";
-    TransformerType["OpusEncoder"] = "opus encoder";
-    TransformerType["OpusDecoder"] = "opus decoder";
-    TransformerType["OggOpusDemuxer"] = "ogg/opus demuxer";
-    TransformerType["WebmOpusDemuxer"] = "webm/opus demuxer";
-    TransformerType["InlineVolume"] = "volume transformer";
-})(TransformerType = exports.TransformerType || (exports.TransformerType = {}));
-/**
- * Represents a type of stream within the graph, e.g. an Opus stream, or a stream of raw audio.
- */
-class Node {
-    constructor(type) {
-        /**
-         * The outbound edges from this node
-         */
-        this.edges = [];
-        this.type = type;
-    }
-    /**
-     * Creates an outbound edge from this node
-     *
-     * @param edge - The edge to create
-     */
-    addEdge(edge) {
-        this.edges.push({ ...edge, from: this });
-    }
-}
-exports.Node = Node;
-// Create a node for each stream type
-const NODES = new Map();
-for (const streamType of Object.values(StreamType)) {
-    NODES.set(streamType, new Node(streamType));
-}
-/**
- * Gets a node from its stream type
- *
- * @param type - The stream type of the target node
- */
-function getNode(type) {
-    const node = NODES.get(type);
-    if (!node)
-        throw new Error(`Node type '${type}' does not exist!`);
-    return node;
-}
-exports.getNode = getNode;
-getNode(StreamType.Raw).addEdge({
-    type: TransformerType.OpusEncoder,
-    to: getNode(StreamType.Opus),
-    cost: 1.5,
-    transformer: () => new prism.opus.Encoder({ rate: 48000, channels: 2, frameSize: 960 }),
-});
-getNode(StreamType.Opus).addEdge({
-    type: TransformerType.OpusDecoder,
-    to: getNode(StreamType.Raw),
-    cost: 1.5,
-    transformer: () => new prism.opus.Decoder({ rate: 48000, channels: 2, frameSize: 960 }),
-});
-getNode(StreamType.OggOpus).addEdge({
-    type: TransformerType.OggOpusDemuxer,
-    to: getNode(StreamType.Opus),
-    cost: 1,
-    transformer: () => new prism.opus.OggDemuxer(),
-});
-getNode(StreamType.WebmOpus).addEdge({
-    type: TransformerType.WebmOpusDemuxer,
-    to: getNode(StreamType.Opus),
-    cost: 1,
-    transformer: () => new prism.opus.WebmDemuxer(),
-});
-const FFMPEG_PCM_EDGE = {
-    type: TransformerType.FFmpegPCM,
-    to: getNode(StreamType.Raw),
-    cost: 2,
-    transformer: (input) => new prism.FFmpeg({
-        args: typeof input === 'string' ? ['-i', input, ...FFMPEG_PCM_ARGUMENTS] : FFMPEG_PCM_ARGUMENTS,
-    }),
-};
-getNode(StreamType.Arbitrary).addEdge(FFMPEG_PCM_EDGE);
-getNode(StreamType.OggOpus).addEdge(FFMPEG_PCM_EDGE);
-getNode(StreamType.WebmOpus).addEdge(FFMPEG_PCM_EDGE);
-getNode(StreamType.Raw).addEdge({
-    type: TransformerType.InlineVolume,
-    to: getNode(StreamType.Raw),
-    cost: 0.5,
-    transformer: () => new prism.VolumeTransformer({ type: 's16le' }),
-});
-// Try to enable FFmpeg Ogg optimizations
-function canEnableFFmpegOptimizations() {
-    try {
-        return prism.FFmpeg.getInfo().output.includes('--enable-libopus');
-    }
-    catch { }
-    return false;
-}
-if (canEnableFFmpegOptimizations()) {
-    const FFMPEG_OGG_EDGE = {
-        type: TransformerType.FFmpegOgg,
-        to: getNode(StreamType.OggOpus),
-        cost: 2,
-        transformer: (input) => new prism.FFmpeg({
-            args: typeof input === 'string' ? ['-i', input, ...FFMPEG_OPUS_ARGUMENTS] : FFMPEG_OPUS_ARGUMENTS,
-        }),
-    };
-    getNode(StreamType.Arbitrary).addEdge(FFMPEG_OGG_EDGE);
-    // Include Ogg and WebM as well in case they have different sampling rates or are mono instead of stereo
-    // at the moment, this will not do anything. However, if/when detection for correct Opus headers is
-    // implemented, this will help inform the voice engine that it is able to transcode the audio.
-    getNode(StreamType.OggOpus).addEdge(FFMPEG_OGG_EDGE);
-    getNode(StreamType.WebmOpus).addEdge(FFMPEG_OGG_EDGE);
-}
-/**
- * Finds the shortest cost path from node A to node B.
- *
- * @param from - The start node
- * @param constraints - Extra validation for a potential solution. Takes a path, returns true if the path is valid.
- * @param goal - The target node
- * @param path - The running path
- * @param depth - The number of remaining recursions
- */
-function findPath(from, constraints, goal = getNode(StreamType.Opus), path = [], depth = 5) {
-    if (from === goal && constraints(path)) {
-        return { cost: 0 };
-    }
-    else if (depth === 0) {
-        return { cost: Infinity };
-    }
-    let currentBest = undefined;
-    for (const edge of from.edges) {
-        if (currentBest && edge.cost > currentBest.cost)
-            continue;
-        const next = findPath(edge.to, constraints, goal, [...path, edge], depth - 1);
-        const cost = edge.cost + next.cost;
-        if (!currentBest || cost < currentBest.cost) {
-            currentBest = { cost, edge, next };
-        }
-    }
-    return currentBest !== null && currentBest !== void 0 ? currentBest : { cost: Infinity };
-}
-/**
- * Takes the solution from findPath and assembles it into a list of edges
- *
- * @param step - The first step of the path
- */
-function constructPipeline(step) {
-    const edges = [];
-    let current = step;
-    while (current === null || current === void 0 ? void 0 : current.edge) {
-        edges.push(current.edge);
-        current = current.next;
-    }
-    return edges;
-}
-/**
- * Finds the lowest-cost pipeline to convert the input stream type into an Opus stream
- *
- * @param from - The stream type to start from
- * @param constraint - Extra constraints that may be imposed on potential solution
- */
-function findPipeline(from, constraint) {
-    return constructPipeline(findPath(getNode(from), constraint));
-}
-exports.findPipeline = findPipeline;
-//# sourceMappingURL=TransformerGraph.js.map

package/dist/audio/TransformerGraph.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TransformerGraph.js","sourceRoot":"","sources":["../../src/audio/TransformerGraph.ts"],"names":[],"mappings":"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","sourcesContent":["import { Readable } from 'stream';\nimport * as prism from 'prism-media';\n\n/*\n\tThis module creates a Transformer Graph to figure out what the most efficient way\n\tof transforming the input stream into something playable would be.\n*/\n\nconst FFMPEG_PCM_ARGUMENTS = ['-analyzeduration', '0', '-loglevel', '0', '-f', 's16le', '-ar', '48000', '-ac', '2'];\nconst FFMPEG_OPUS_ARGUMENTS = [\n\t'-analyzeduration',\n\t'0',\n\t'-loglevel',\n\t'0',\n\t'-acodec',\n\t'libopus',\n\t'-f',\n\t'opus',\n\t'-ar',\n\t'48000',\n\t'-ac',\n\t'2',\n];\n\n/**\n * The different types of stream that can exist within the pipeline\n *\n * @remarks\n * - `Arbitrary` - the type of the stream at this point is unknown.\n *\n * - `Raw` - the stream at this point is s16le PCM.\n *\n * - `OggOpus` - the stream at this point is Opus audio encoded in an Ogg wrapper.\n *\n * - `WebmOpus` - the stream at this point is Opus audio encoded in a WebM wrapper.\n *\n * - `Opus` - the stream at this point is Opus audio, and the stream is in object-mode. This is ready to play.\n */\nexport enum StreamType {\n\tArbitrary = 'arbitrary',\n\tRaw = 'raw',\n\tOggOpus = 'ogg/opus',\n\tWebmOpus = 'webm/opus',\n\tOpus = 'opus',\n}\n\n/**\n * The different types of transformers that can exist within the pipeline\n */\nexport enum TransformerType {\n\tFFmpegPCM = 'ffmpeg pcm',\n\tFFmpegOgg = 'ffmpeg ogg',\n\tOpusEncoder = 'opus encoder',\n\tOpusDecoder = 'opus decoder',\n\tOggOpusDemuxer = 'ogg/opus demuxer',\n\tWebmOpusDemuxer = 'webm/opus demuxer',\n\tInlineVolume = 'volume transformer',\n}\n\n/**\n * Represents a pathway from one stream type to another using a transformer\n */\nexport interface Edge {\n\tfrom: Node;\n\tto: Node;\n\tcost: number;\n\ttransformer: (input: string | Readable) => Readable;\n\ttype: TransformerType;\n}\n\n/**\n * Represents a type of stream within the graph, e.g. an Opus stream, or a stream of raw audio.\n */\nexport class Node {\n\t/**\n\t * The outbound edges from this node\n\t */\n\tpublic readonly edges: Edge[] = [];\n\n\t/**\n\t * The type of stream for this node\n\t */\n\tpublic readonly type: StreamType;\n\n\tpublic constructor(type: StreamType) {\n\t\tthis.type = type;\n\t}\n\n\t/**\n\t * Creates an outbound edge from this node\n\t *\n\t * @param edge - The edge to create\n\t */\n\tpublic addEdge(edge: Omit<Edge, 'from'>) {\n\t\tthis.edges.push({ ...edge, from: this });\n\t}\n}\n\n// Create a node for each stream type\nconst NODES = new Map<StreamType, Node>();\nfor (const streamType of Object.values(StreamType)) {\n\tNODES.set(streamType, new Node(streamType));\n}\n\n/**\n * Gets a node from its stream type\n *\n * @param type - The stream type of the target node\n */\nexport function getNode(type: StreamType) {\n\tconst node = NODES.get(type);\n\tif (!node) throw new Error(`Node type '${type}' does not exist!`);\n\treturn node;\n}\n\ngetNode(StreamType.Raw).addEdge({\n\ttype: TransformerType.OpusEncoder,\n\tto: getNode(StreamType.Opus),\n\tcost: 1.5,\n\ttransformer: () => new prism.opus.Encoder({ rate: 48000, channels: 2, frameSize: 960 }),\n});\n\ngetNode(StreamType.Opus).addEdge({\n\ttype: TransformerType.OpusDecoder,\n\tto: getNode(StreamType.Raw),\n\tcost: 1.5,\n\ttransformer: () => new prism.opus.Decoder({ rate: 48000, channels: 2, frameSize: 960 }),\n});\n\ngetNode(StreamType.OggOpus).addEdge({\n\ttype: TransformerType.OggOpusDemuxer,\n\tto: getNode(StreamType.Opus),\n\tcost: 1,\n\ttransformer: () => new prism.opus.OggDemuxer(),\n});\n\ngetNode(StreamType.WebmOpus).addEdge({\n\ttype: TransformerType.WebmOpusDemuxer,\n\tto: getNode(StreamType.Opus),\n\tcost: 1,\n\ttransformer: () => new prism.opus.WebmDemuxer(),\n});\n\nconst FFMPEG_PCM_EDGE: Omit<Edge, 'from'> = {\n\ttype: TransformerType.FFmpegPCM,\n\tto: getNode(StreamType.Raw),\n\tcost: 2,\n\ttransformer: (input) =>\n\t\tnew prism.FFmpeg({\n\t\t\targs: typeof input === 'string' ? ['-i', input, ...FFMPEG_PCM_ARGUMENTS] : FFMPEG_PCM_ARGUMENTS,\n\t\t}),\n};\n\ngetNode(StreamType.Arbitrary).addEdge(FFMPEG_PCM_EDGE);\ngetNode(StreamType.OggOpus).addEdge(FFMPEG_PCM_EDGE);\ngetNode(StreamType.WebmOpus).addEdge(FFMPEG_PCM_EDGE);\n\ngetNode(StreamType.Raw).addEdge({\n\ttype: TransformerType.InlineVolume,\n\tto: getNode(StreamType.Raw),\n\tcost: 0.5,\n\ttransformer: () => new prism.VolumeTransformer({ type: 's16le' }),\n});\n\n// Try to enable FFmpeg Ogg optimizations\nfunction canEnableFFmpegOptimizations(): boolean {\n\ttry {\n\t\treturn prism.FFmpeg.getInfo().output.includes('--enable-libopus');\n\t} catch {}\n\treturn false;\n}\n\nif (canEnableFFmpegOptimizations()) {\n\tconst FFMPEG_OGG_EDGE: Omit<Edge, 'from'> = {\n\t\ttype: TransformerType.FFmpegOgg,\n\t\tto: getNode(StreamType.OggOpus),\n\t\tcost: 2,\n\t\ttransformer: (input) =>\n\t\t\tnew prism.FFmpeg({\n\t\t\t\targs: typeof input === 'string' ? ['-i', input, ...FFMPEG_OPUS_ARGUMENTS] : FFMPEG_OPUS_ARGUMENTS,\n\t\t\t}),\n\t};\n\tgetNode(StreamType.Arbitrary).addEdge(FFMPEG_OGG_EDGE);\n\t// Include Ogg and WebM as well in case they have different sampling rates or are mono instead of stereo\n\t// at the moment, this will not do anything. However, if/when detection for correct Opus headers is\n\t// implemented, this will help inform the voice engine that it is able to transcode the audio.\n\tgetNode(StreamType.OggOpus).addEdge(FFMPEG_OGG_EDGE);\n\tgetNode(StreamType.WebmOpus).addEdge(FFMPEG_OGG_EDGE);\n}\n\n/**\n * Represents a step in the path from node A to node B.\n */\ninterface Step {\n\t/**\n\t * The next step\n\t */\n\tnext?: Step;\n\n\t/**\n\t * The cost of the steps after this step\n\t */\n\tcost: number;\n\n\t/**\n\t * The edge associated with this step\n\t */\n\tedge?: Edge;\n}\n\n/**\n * Finds the shortest cost path from node A to node B.\n *\n * @param from - The start node\n * @param constraints - Extra validation for a potential solution. Takes a path, returns true if the path is valid.\n * @param goal - The target node\n * @param path - The running path\n * @param depth - The number of remaining recursions\n */\nfunction findPath(\n\tfrom: Node,\n\tconstraints: (path: Edge[]) => boolean,\n\tgoal = getNode(StreamType.Opus),\n\tpath: Edge[] = [],\n\tdepth = 5,\n): Step {\n\tif (from === goal && constraints(path)) {\n\t\treturn { cost: 0 };\n\t} else if (depth === 0) {\n\t\treturn { cost: Infinity };\n\t}\n\n\tlet currentBest: Step | undefined = undefined;\n\tfor (const edge of from.edges) {\n\t\tif (currentBest && edge.cost > currentBest.cost) continue;\n\t\tconst next = findPath(edge.to, constraints, goal, [...path, edge], depth - 1);\n\t\tconst cost = edge.cost + next.cost;\n\t\tif (!currentBest || cost < currentBest.cost) {\n\t\t\tcurrentBest = { cost, edge, next };\n\t\t}\n\t}\n\treturn currentBest ?? { cost: Infinity };\n}\n\n/**\n * Takes the solution from findPath and assembles it into a list of edges\n *\n * @param step - The first step of the path\n */\nfunction constructPipeline(step: Step) {\n\tconst edges = [];\n\tlet current: Step | undefined = step;\n\twhile (current?.edge) {\n\t\tedges.push(current.edge);\n\t\tcurrent = current.next;\n\t}\n\treturn edges;\n}\n\n/**\n * Finds the lowest-cost pipeline to convert the input stream type into an Opus stream\n *\n * @param from - The stream type to start from\n * @param constraint - Extra constraints that may be imposed on potential solution\n */\nexport function findPipeline(from: StreamType, constraint: (path: Edge[]) => boolean) {\n\treturn constructPipeline(findPath(getNode(from), constraint));\n}\n"]}

package/dist/audio/index.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StreamType = exports.PlayerSubscription = exports.createAudioResource = exports.AudioResource = exports.AudioPlayerError = exports.createAudioPlayer = exports.NoSubscriberBehavior = exports.AudioPlayerStatus = exports.AudioPlayer = void 0;
-var AudioPlayer_1 = require("./AudioPlayer");
-Object.defineProperty(exports, "AudioPlayer", { enumerable: true, get: function () { return AudioPlayer_1.AudioPlayer; } });
-Object.defineProperty(exports, "AudioPlayerStatus", { enumerable: true, get: function () { return AudioPlayer_1.AudioPlayerStatus; } });
-Object.defineProperty(exports, "NoSubscriberBehavior", { enumerable: true, get: function () { return AudioPlayer_1.NoSubscriberBehavior; } });
-Object.defineProperty(exports, "createAudioPlayer", { enumerable: true, get: function () { return AudioPlayer_1.createAudioPlayer; } });
-var AudioPlayerError_1 = require("./AudioPlayerError");
-Object.defineProperty(exports, "AudioPlayerError", { enumerable: true, get: function () { return AudioPlayerError_1.AudioPlayerError; } });
-var AudioResource_1 = require("./AudioResource");
-Object.defineProperty(exports, "AudioResource", { enumerable: true, get: function () { return AudioResource_1.AudioResource; } });
-Object.defineProperty(exports, "createAudioResource", { enumerable: true, get: function () { return AudioResource_1.createAudioResource; } });
-var PlayerSubscription_1 = require("./PlayerSubscription");
-Object.defineProperty(exports, "PlayerSubscription", { enumerable: true, get: function () { return PlayerSubscription_1.PlayerSubscription; } });
-var TransformerGraph_1 = require("./TransformerGraph");
-Object.defineProperty(exports, "StreamType", { enumerable: true, get: function () { return TransformerGraph_1.StreamType; } });
-//# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":";;;AAAA,6CAYuB;AAXtB,0GAAA,WAAW,OAAA;AACX,gHAAA,iBAAiB,OAAA;AAEjB,mHAAA,oBAAoB,OAAA;AACpB,gHAAA,iBAAiB,OAAA;AASlB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,iDAAqE;AAA5D,8GAAA,aAAa,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAE3C,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAE3B,uDAAgD;AAAvC,8GAAA,UAAU,OAAA","sourcesContent":["export {\n\tAudioPlayer,\n\tAudioPlayerStatus,\n\tAudioPlayerState,\n\tNoSubscriberBehavior,\n\tcreateAudioPlayer,\n\tAudioPlayerBufferingState,\n\tAudioPlayerIdleState,\n\tAudioPlayerPausedState,\n\tAudioPlayerPlayingState,\n\tCreateAudioPlayerOptions,\n\tAudioPlayerEvents,\n} from './AudioPlayer';\n\nexport { AudioPlayerError } from './AudioPlayerError';\n\nexport { AudioResource, createAudioResource } from './AudioResource';\n\nexport { PlayerSubscription } from './PlayerSubscription';\n\nexport { StreamType } from './TransformerGraph';\n"]}

package/dist/joinVoiceChannel.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.joinVoiceChannel = void 0;
-const VoiceConnection_1 = require("./VoiceConnection");
-/**
- * Creates a VoiceConnection to a Discord voice channel.
- *
- * @param voiceChannel - the voice channel to connect to
- * @param options - the options for joining the voice channel
- */
-function joinVoiceChannel(options) {
-    const joinConfig = {
-        selfDeaf: true,
-        selfMute: false,
-        group: 'default',
-        ...options,
-    };
-    return VoiceConnection_1.createVoiceConnection(joinConfig, {
-        adapterCreator: options.adapterCreator,
-        debug: options.debug,
-    });
-}
-exports.joinVoiceChannel = joinVoiceChannel;
-//# sourceMappingURL=joinVoiceChannel.js.map

package/dist/joinVoiceChannel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"joinVoiceChannel.js","sourceRoot":"","sources":["../src/joinVoiceChannel.ts"],"names":[],"mappings":";;;AAAA,uDAA0D;AA0C1D;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,OAA+D;IAC/F,MAAM,UAAU,GAAe;QAC9B,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,OAAO;KACV,CAAC;IAEF,OAAO,uCAAqB,CAAC,UAAU,EAAE;QACxC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK;KACpB,CAAC,CAAC;AACJ,CAAC;AAZD,4CAYC","sourcesContent":["import { createVoiceConnection } from './VoiceConnection';\nimport { JoinConfig } from './DataStore';\nimport { DiscordGatewayAdapterCreator } from './util/adapter';\n\n/**\n * The options that can be given when creating a voice connection.\n */\nexport interface CreateVoiceConnectionOptions {\n\t/**\n\t * If true, debug messages will be enabled for the voice connection and its\n\t * related components. Defaults to false.\n\t */\n\tdebug?: boolean;\n\tadapterCreator: DiscordGatewayAdapterCreator;\n}\n\n/**\n * The options that can be given when joining a voice channel.\n */\nexport interface JoinVoiceChannelOptions {\n\t/**\n\t * The ID of the Discord voice channel to join\n\t */\n\tchannelId: string;\n\t/**\n\t * The ID of the guild that the voice channel belongs to\n\t */\n\tguildId: string;\n\t/**\n\t * Whether to join the channel deafened (defaults to true)\n\t */\n\tselfDeaf?: boolean;\n\t/**\n\t * Whether to join the channel muted (defaults to true)\n\t */\n\tselfMute?: boolean;\n\t/**\n\t * An optional group identifier for the voice connection\n\t */\n\tgroup?: string;\n}\n\n/**\n * Creates a VoiceConnection to a Discord voice channel.\n *\n * @param voiceChannel - the voice channel to connect to\n * @param options - the options for joining the voice channel\n */\nexport function joinVoiceChannel(options: JoinVoiceChannelOptions & CreateVoiceConnectionOptions) {\n\tconst joinConfig: JoinConfig = {\n\t\tselfDeaf: true,\n\t\tselfMute: false,\n\t\tgroup: 'default',\n\t\t...options,\n\t};\n\n\treturn createVoiceConnection(joinConfig, {\n\t\tadapterCreator: options.adapterCreator,\n\t\tdebug: options.debug,\n\t});\n}\n"]}