@stoatx/voice-node 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Stoatx
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,24 @@
1
- # Temporary Holding Version
1
+ # @stoatx/voice-node
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Voice for [`@stoatx/client`](https://www.npmjs.com/package/@stoatx/client) in Node.js: join voice channels and play audio files or streams. Needs `ffmpeg` on your `PATH`.
4
+
5
+ ```bash
6
+ npm install @stoatx/voice-node
7
+ ```
8
+
9
+ ```ts
10
+ import { VoiceManager, AudioPlayer, AudioResource } from "@stoatx/voice-node";
11
+
12
+ const voice = new VoiceManager(client);
13
+ const connection = await voice.join(channel);
14
+
15
+ const player = new AudioPlayer();
16
+ connection.subscribe(player);
17
+ player.play(AudioResource.from("./song.mp3"));
18
+ ```
19
+
20
+ For browsers, use [`@stoatx/voice-browser`](https://www.npmjs.com/package/@stoatx/voice-browser). Guides and API reference: **[Stoatx Documentation](https://stoatx-ts.github.io/stoatx/)**.
21
+
22
+ ## License
23
+
24
+ MIT © [Stoatx / Stoatx Team]
package/dist/index.cjs ADDED
@@ -0,0 +1,331 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/index.ts
21
+ var index_exports = {};
22
+ __export(index_exports, {
23
+ AudioPlayer: () => AudioPlayer,
24
+ AudioResource: () => AudioResource,
25
+ VoiceConnection: () => VoiceConnection,
26
+ VoiceManager: () => VoiceManager
27
+ });
28
+ module.exports = __toCommonJS(index_exports);
29
+
30
+ // src/VoiceManager.ts
31
+ var import_voice2 = require("@stoatx/voice");
32
+
33
+ // src/VoiceConnection.ts
34
+ var import_rtc_node = require("@livekit/rtc-node");
35
+ var import_voice = require("@stoatx/voice");
36
+ var SAMPLE_RATE = 48e3;
37
+ var CHANNELS = 2;
38
+ var SAMPLES_PER_FRAME = 960;
39
+ var BYTES_PER_FRAME = SAMPLES_PER_FRAME * CHANNELS * 2;
40
+ var VoiceConnection = class extends import_voice.BaseVoiceConnection {
41
+ room;
42
+ _player = null;
43
+ _audioTrack = null;
44
+ _audioSource = null;
45
+ _publishing = null;
46
+ _leftover = Buffer.alloc(0);
47
+ /**
48
+ * @param channelId The voice channel's ID.
49
+ * @param serverId The ID of the server the channel is in, or `null` for DMs and groups.
50
+ */
51
+ constructor(channelId, serverId) {
52
+ super(channelId, serverId);
53
+ this.room = new import_rtc_node.Room();
54
+ this.room.on(import_rtc_node.RoomEvent.Disconnected, () => {
55
+ this._status = "disconnected";
56
+ this._player?.removeSubscriber(this);
57
+ this.emitBase("disconnect");
58
+ });
59
+ }
60
+ /** The player this connection plays audio from, if it's subscribed to one. */
61
+ get player() {
62
+ return this._player;
63
+ }
64
+ /** @internal */
65
+ async connect(url, token) {
66
+ await this.room.connect(url, token);
67
+ this._status = "ready";
68
+ this.emitBase("ready");
69
+ }
70
+ /**
71
+ * Plays audio from a player in this call. A connection plays from one player at a time;
72
+ * a player can play into several connections.
73
+ * @param player The player.
74
+ */
75
+ subscribe(player) {
76
+ if (this._player) this._player.removeSubscriber(this);
77
+ this._player = player;
78
+ player.addSubscriber(this);
79
+ }
80
+ /**
81
+ * Keeps playing the old connection's player after the server moves the user to another call.
82
+ * @param previous The connection being replaced.
83
+ * @internal
84
+ */
85
+ async _takeOver(previous) {
86
+ if (previous.player) this.subscribe(previous.player);
87
+ }
88
+ /** Stops playing audio from the current player. */
89
+ unsubscribe() {
90
+ this._player?.removeSubscriber(this);
91
+ this._player = null;
92
+ }
93
+ /**
94
+ * Drops any partial frame left over from a previous stream.
95
+ * @internal
96
+ */
97
+ _resetStream() {
98
+ this._leftover = Buffer.alloc(0);
99
+ }
100
+ /**
101
+ * Converts a chunk of s16le PCM into frames and sends them to the room.
102
+ * Never rejects: failures are emitted as `error` events.
103
+ * @internal
104
+ */
105
+ async _writeChunk(chunk) {
106
+ try {
107
+ if (this._status !== "ready") return;
108
+ const source = await this.ensureTrack();
109
+ const buf = Buffer.concat([this._leftover, chunk]);
110
+ let offset = 0;
111
+ while (offset + BYTES_PER_FRAME <= buf.length) {
112
+ if (this._status !== "ready" || !this._player) return;
113
+ const slice = buf.subarray(offset, offset + BYTES_PER_FRAME);
114
+ const tmp = slice.buffer.slice(slice.byteOffset, slice.byteOffset + slice.byteLength);
115
+ const pcm = new Int16Array(tmp);
116
+ await source.captureFrame(new import_rtc_node.AudioFrame(pcm, SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME));
117
+ offset += BYTES_PER_FRAME;
118
+ }
119
+ this._leftover = buf.subarray(offset);
120
+ } catch (error) {
121
+ this.reportError(error);
122
+ }
123
+ }
124
+ ensureTrack() {
125
+ if (!this._publishing) {
126
+ this._publishing = (async () => {
127
+ if (!this.room.localParticipant) {
128
+ throw new Error("Not connected to a room");
129
+ }
130
+ const source = new import_rtc_node.AudioSource(SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME);
131
+ const track = import_rtc_node.LocalAudioTrack.createAudioTrack("audio", source);
132
+ const options = new import_rtc_node.TrackPublishOptions();
133
+ options.source = import_rtc_node.TrackSource.SOURCE_MICROPHONE;
134
+ await this.room.localParticipant.publishTrack(track, options);
135
+ this._audioTrack = track;
136
+ this._audioSource = source;
137
+ return source;
138
+ })();
139
+ this._publishing.catch(() => {
140
+ this._publishing = null;
141
+ });
142
+ }
143
+ return this._publishing;
144
+ }
145
+ /** Leaves the call and stops sending audio. */
146
+ async disconnect() {
147
+ this._status = "disconnecting";
148
+ this.unsubscribe();
149
+ if (this._audioTrack) {
150
+ await this._audioTrack.close();
151
+ this._audioTrack = null;
152
+ }
153
+ if (this._audioSource) {
154
+ await this._audioSource.close();
155
+ this._audioSource = null;
156
+ }
157
+ this._publishing = null;
158
+ this._leftover = Buffer.alloc(0);
159
+ await this.room.disconnect();
160
+ }
161
+ };
162
+
163
+ // src/VoiceManager.ts
164
+ var VoiceManager = class extends import_voice2.BaseVoiceManager {
165
+ /**
166
+ * @param client The client to join calls with.
167
+ */
168
+ constructor(client) {
169
+ super(client, (channelId, serverId) => new VoiceConnection(channelId, serverId));
170
+ }
171
+ };
172
+
173
+ // src/AudioPlayer.ts
174
+ var import_node_events = require("events");
175
+ var AudioPlayer = class extends import_node_events.EventEmitter {
176
+ _status = "idle";
177
+ _resource = null;
178
+ _detach = null;
179
+ /** Registered VoiceConnections subscribed to this player */
180
+ subscribers = /* @__PURE__ */ new Set();
181
+ get status() {
182
+ return this._status;
183
+ }
184
+ get resource() {
185
+ return this._resource;
186
+ }
187
+ play(resource) {
188
+ this.releaseResource();
189
+ this._resource = resource;
190
+ this.transition("buffering");
191
+ for (const conn of this.subscribers) conn._resetStream();
192
+ const stream = resource.stream;
193
+ const onData = (chunk) => {
194
+ if (this._status === "buffering") this.transition("playing");
195
+ stream.pause();
196
+ const writes = [...this.subscribers].map((conn) => conn._writeChunk(chunk));
197
+ void Promise.allSettled(writes).then(() => {
198
+ if (this._resource === resource && this._status === "playing") stream.resume();
199
+ });
200
+ };
201
+ const onEnd = () => {
202
+ this.releaseResource();
203
+ this.transition("idle");
204
+ this.emit("idle");
205
+ };
206
+ const onError = (err) => {
207
+ this.releaseResource();
208
+ this.transition("idle");
209
+ if (this.listenerCount("error") > 0) this.emit("error", err);
210
+ };
211
+ stream.on("data", onData);
212
+ stream.once("end", onEnd);
213
+ stream.once("error", onError);
214
+ this._detach = () => {
215
+ stream.off("data", onData);
216
+ stream.off("end", onEnd);
217
+ stream.off("error", onError);
218
+ stream.on("error", () => {
219
+ });
220
+ };
221
+ }
222
+ pause() {
223
+ if (this._status !== "playing") return;
224
+ this._resource?.stream.pause();
225
+ this.transition("paused");
226
+ }
227
+ resume() {
228
+ if (this._status !== "paused") return;
229
+ this.transition("playing");
230
+ this._resource?.stream.resume();
231
+ }
232
+ stop() {
233
+ this.releaseResource();
234
+ this.transition("stopped");
235
+ this.transition("idle");
236
+ this.emit("idle");
237
+ }
238
+ /** @internal */
239
+ addSubscriber(conn) {
240
+ this.subscribers.add(conn);
241
+ }
242
+ /** @internal */
243
+ removeSubscriber(conn) {
244
+ this.subscribers.delete(conn);
245
+ }
246
+ releaseResource() {
247
+ this._detach?.();
248
+ this._detach = null;
249
+ this._resource?.destroy();
250
+ this._resource = null;
251
+ }
252
+ transition(next) {
253
+ const prev = this._status;
254
+ this._status = next;
255
+ this.emit("stateChange", prev, next);
256
+ }
257
+ };
258
+
259
+ // src/AudioResource.ts
260
+ var import_node_stream = require("stream");
261
+ var import_node_child_process = require("child_process");
262
+ var import_node_stream2 = require("stream");
263
+ var import_node_fs = require("fs");
264
+ var AudioResource = class _AudioResource {
265
+ stream;
266
+ process;
267
+ source;
268
+ constructor(stream, process, source) {
269
+ this.stream = stream;
270
+ this.process = process;
271
+ this.source = source;
272
+ }
273
+ /**
274
+ * Stops decoding: destroys the output stream and kills the ffmpeg process.
275
+ * Safe to call more than once.
276
+ */
277
+ destroy() {
278
+ if (this.source && this.process?.stdin) this.source.unpipe(this.process.stdin);
279
+ if (!this.stream.destroyed) this.stream.destroy();
280
+ if (this.process && this.process.exitCode === null && this.process.signalCode === null) {
281
+ this.process.kill();
282
+ }
283
+ this.process = null;
284
+ }
285
+ static from(source, options = {}) {
286
+ if (typeof source === "string" && !source.startsWith("http") && !(0, import_node_fs.existsSync)(source)) {
287
+ throw new Error(`Audio file not found: ${source}`);
288
+ }
289
+ const { volume = 1, inputType } = options;
290
+ const args = [
291
+ ...inputType ? ["-f", inputType] : [],
292
+ "-i",
293
+ typeof source === "string" ? source : "pipe:0",
294
+ "-af",
295
+ `volume=${volume}`,
296
+ "-ar",
297
+ "48000",
298
+ "-ac",
299
+ "2",
300
+ "-f",
301
+ "s16le",
302
+ "-acodec",
303
+ "pcm_s16le",
304
+ "pipe:1"
305
+ ];
306
+ const ffmpeg = (0, import_node_child_process.spawn)("ffmpeg", args, { stdio: ["pipe", "pipe", "ignore"] });
307
+ if (source instanceof import_node_stream.Readable) {
308
+ source.pipe(ffmpeg.stdin);
309
+ source.once("error", () => ffmpeg.kill());
310
+ }
311
+ ffmpeg.stdin?.on("error", () => {
312
+ });
313
+ const pass = new import_node_stream2.PassThrough();
314
+ ffmpeg.stdout.pipe(pass);
315
+ ffmpeg.once("error", (err) => pass.destroy(err));
316
+ ffmpeg.once("close", (code) => {
317
+ if (code !== 0 && code !== null) {
318
+ pass.destroy(new Error(`ffmpeg exited with code ${code}`));
319
+ }
320
+ });
321
+ return new _AudioResource(pass, ffmpeg, source instanceof import_node_stream.Readable ? source : null);
322
+ }
323
+ };
324
+ // Annotate the CommonJS export names for ESM import in node:
325
+ 0 && (module.exports = {
326
+ AudioPlayer,
327
+ AudioResource,
328
+ VoiceConnection,
329
+ VoiceManager
330
+ });
331
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts","../src/VoiceManager.ts","../src/VoiceConnection.ts","../src/AudioPlayer.ts","../src/AudioResource.ts"],"sourcesContent":["export { VoiceManager } from \"./VoiceManager\";\nexport { VoiceConnection } from \"./VoiceConnection\";\nexport { AudioPlayer } from \"./AudioPlayer\";\nexport { AudioResource } from \"./AudioResource\";\nexport type { AudioPlayerStatus, AudioPlayerEvents } from \"./AudioPlayer\";\nexport type { AudioSource, AudioResourceOptions } from \"./AudioResource\";\nexport type {\n VoiceChannelResolvable,\n VoiceConnectionEvents,\n VoiceConnectionStatus,\n VoiceJoinOptions,\n VoiceNode,\n} from \"@stoatx/voice\";\n","import type { Client } from \"@stoatx/client\";\nimport { BaseVoiceManager } from \"@stoatx/voice\";\nimport { VoiceConnection } from \"./VoiceConnection\";\n\n/**\n * Joins voice calls from Node.js, e.g. for a music bot. Play audio into a call with an\n * `AudioPlayer`.\n *\n * @example\n * import { VoiceManager, AudioPlayer, AudioResource } from \"@stoatx/voice-node\";\n *\n * const voice = new VoiceManager(client);\n * const connection = await voice.join(channel);\n *\n * const player = new AudioPlayer();\n * connection.subscribe(player);\n * player.play(AudioResource.from(\"./song.mp3\"));\n */\nexport class VoiceManager extends BaseVoiceManager<VoiceConnection> {\n /**\n * @param client The client to join calls with.\n */\n constructor(client: Client) {\n super(client, (channelId, serverId) => new VoiceConnection(channelId, serverId));\n }\n}\n","import {\n Room,\n RoomEvent,\n TrackSource,\n LocalAudioTrack,\n TrackPublishOptions,\n AudioFrame,\n AudioSource,\n} from \"@livekit/rtc-node\";\nimport { BaseVoiceConnection } from \"@stoatx/voice\";\nimport type { AudioPlayer } from \"./AudioPlayer\";\n\nconst SAMPLE_RATE = 48000;\nconst CHANNELS = 2;\nconst SAMPLES_PER_FRAME = 960;\nconst BYTES_PER_FRAME = SAMPLES_PER_FRAME * CHANNELS * 2;\n\n/**\n * A connection to a voice channel's call in Node.js. Plays audio from an {@link AudioPlayer}.\n * Get one from `VoiceManager.join()`.\n */\nexport class VoiceConnection extends BaseVoiceConnection {\n private readonly room: Room;\n private _player: AudioPlayer | null = null;\n private _audioTrack: LocalAudioTrack | null = null;\n private _audioSource: AudioSource | null = null;\n private _publishing: Promise<AudioSource> | null = null;\n private _leftover: Buffer = Buffer.alloc(0);\n\n /**\n * @param channelId The voice channel's ID.\n * @param serverId The ID of the server the channel is in, or `null` for DMs and groups.\n */\n constructor(channelId: string, serverId: string | null) {\n super(channelId, serverId);\n this.room = new Room();\n this.room.on(RoomEvent.Disconnected, () => {\n this._status = \"disconnected\";\n this._player?.removeSubscriber(this);\n this.emitBase(\"disconnect\");\n });\n }\n\n /** The player this connection plays audio from, if it's subscribed to one. */\n get player(): AudioPlayer | null {\n return this._player;\n }\n\n /** @internal */\n async connect(url: string, token: string): Promise<void> {\n await this.room.connect(url, token);\n this._status = \"ready\";\n this.emitBase(\"ready\");\n }\n\n /**\n * Plays audio from a player in this call. A connection plays from one player at a time;\n * a player can play into several connections.\n * @param player The player.\n */\n subscribe(player: AudioPlayer): void {\n if (this._player) this._player.removeSubscriber(this);\n this._player = player;\n player.addSubscriber(this);\n }\n\n /**\n * Keeps playing the old connection's player after the server moves the user to another call.\n * @param previous The connection being replaced.\n * @internal\n */\n override async _takeOver(previous: VoiceConnection): Promise<void> {\n if (previous.player) this.subscribe(previous.player);\n }\n\n /** Stops playing audio from the current player. */\n unsubscribe(): void {\n this._player?.removeSubscriber(this);\n this._player = null;\n }\n\n /**\n * Drops any partial frame left over from a previous stream.\n * @internal\n */\n _resetStream(): void {\n this._leftover = Buffer.alloc(0);\n }\n\n /**\n * Converts a chunk of s16le PCM into frames and sends them to the room.\n * Never rejects: failures are emitted as `error` events.\n * @internal\n */\n async _writeChunk(chunk: Buffer): Promise<void> {\n try {\n if (this._status !== \"ready\") return;\n const source = await this.ensureTrack();\n\n const buf = Buffer.concat([this._leftover, chunk]);\n let offset = 0;\n\n while (offset + BYTES_PER_FRAME <= buf.length) {\n // Stop sending as soon as we are detached or disconnected.\n if (this._status !== \"ready\" || !this._player) return;\n\n const slice = buf.subarray(offset, offset + BYTES_PER_FRAME);\n const tmp = slice.buffer.slice(slice.byteOffset, slice.byteOffset + slice.byteLength);\n const pcm = new Int16Array(tmp);\n await source.captureFrame(new AudioFrame(pcm, SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME));\n offset += BYTES_PER_FRAME;\n }\n\n this._leftover = buf.subarray(offset);\n } catch (error) {\n this.reportError(error);\n }\n }\n\n private ensureTrack(): Promise<AudioSource> {\n if (!this._publishing) {\n this._publishing = (async () => {\n if (!this.room.localParticipant) {\n throw new Error(\"Not connected to a room\");\n }\n const source = new AudioSource(SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME);\n const track = LocalAudioTrack.createAudioTrack(\"audio\", source);\n\n const options = new TrackPublishOptions();\n options.source = TrackSource.SOURCE_MICROPHONE;\n await this.room.localParticipant.publishTrack(track, options);\n\n this._audioTrack = track;\n this._audioSource = source;\n return source;\n })();\n this._publishing.catch(() => {\n this._publishing = null;\n });\n }\n return this._publishing;\n }\n\n /** Leaves the call and stops sending audio. */\n async disconnect(): Promise<void> {\n this._status = \"disconnecting\";\n this.unsubscribe();\n if (this._audioTrack) {\n await this._audioTrack.close();\n this._audioTrack = null;\n }\n // The source holds a native handle; close it so a disconnect doesn't leak it.\n if (this._audioSource) {\n await this._audioSource.close();\n this._audioSource = null;\n }\n this._publishing = null;\n this._leftover = Buffer.alloc(0);\n await this.room.disconnect();\n }\n}\n","import { EventEmitter } from \"node:events\";\nimport { AudioResource } from \"./AudioResource\";\nimport type { VoiceConnection } from \"./VoiceConnection\";\n\nexport type AudioPlayerStatus = \"idle\" | \"buffering\" | \"playing\" | \"paused\" | \"stopped\";\n\nexport interface AudioPlayerEvents {\n stateChange: [oldStatus: AudioPlayerStatus, newStatus: AudioPlayerStatus];\n idle: [];\n error: [error: Error];\n}\n\nexport class AudioPlayer extends EventEmitter<AudioPlayerEvents> {\n private _status: AudioPlayerStatus = \"idle\";\n private _resource: AudioResource | null = null;\n private _detach: (() => void) | null = null;\n\n /** Registered VoiceConnections subscribed to this player */\n private readonly subscribers: Set<VoiceConnection> = new Set();\n\n get status(): AudioPlayerStatus {\n return this._status;\n }\n\n get resource(): AudioResource | null {\n return this._resource;\n }\n\n play(resource: AudioResource): void {\n // Tear down whatever was playing before so its ffmpeg process does not leak.\n this.releaseResource();\n\n this._resource = resource;\n this.transition(\"buffering\");\n\n for (const conn of this.subscribers) conn._resetStream();\n\n const stream = resource.stream;\n\n // The player reads the stream once and fans each chunk out to every\n // subscriber. The stream stays paused until all subscribers have consumed\n // the chunk, which keeps decoding at playback speed.\n const onData = (chunk: Buffer) => {\n if (this._status === \"buffering\") this.transition(\"playing\");\n stream.pause();\n\n const writes = [...this.subscribers].map((conn) => conn._writeChunk(chunk));\n void Promise.allSettled(writes).then(() => {\n if (this._resource === resource && this._status === \"playing\") stream.resume();\n });\n };\n\n const onEnd = () => {\n this.releaseResource();\n this.transition(\"idle\");\n this.emit(\"idle\");\n };\n\n const onError = (err: Error) => {\n this.releaseResource();\n this.transition(\"idle\");\n if (this.listenerCount(\"error\") > 0) this.emit(\"error\", err);\n };\n\n stream.on(\"data\", onData);\n stream.once(\"end\", onEnd);\n stream.once(\"error\", onError);\n\n this._detach = () => {\n stream.off(\"data\", onData);\n stream.off(\"end\", onEnd);\n stream.off(\"error\", onError);\n // Keep a no-op error handler so destroying the stream cannot throw.\n stream.on(\"error\", () => {});\n };\n }\n\n pause(): void {\n if (this._status !== \"playing\") return;\n this._resource?.stream.pause();\n this.transition(\"paused\");\n }\n\n resume(): void {\n if (this._status !== \"paused\") return;\n this.transition(\"playing\");\n this._resource?.stream.resume();\n }\n\n stop(): void {\n this.releaseResource();\n this.transition(\"stopped\");\n this.transition(\"idle\");\n this.emit(\"idle\");\n }\n\n /** @internal */\n addSubscriber(conn: VoiceConnection): void {\n this.subscribers.add(conn);\n }\n\n /** @internal */\n removeSubscriber(conn: VoiceConnection): void {\n this.subscribers.delete(conn);\n }\n\n private releaseResource(): void {\n this._detach?.();\n this._detach = null;\n this._resource?.destroy();\n this._resource = null;\n }\n\n private transition(next: AudioPlayerStatus): void {\n const prev = this._status;\n this._status = next;\n this.emit(\"stateChange\", prev, next);\n }\n}\n","import { Readable } from \"node:stream\";\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { PassThrough } from \"node:stream\";\nimport { existsSync } from \"node:fs\";\n\nexport interface AudioResourceOptions {\n volume?: number;\n inputType?: string;\n}\n\nexport type AudioSource = string | Readable;\n\nexport class AudioResource {\n readonly stream: Readable;\n private process: ChildProcess | null;\n private readonly source: Readable | null;\n\n private constructor(stream: Readable, process: ChildProcess, source: Readable | null) {\n this.stream = stream;\n this.process = process;\n this.source = source;\n }\n\n /**\n * Stops decoding: destroys the output stream and kills the ffmpeg process.\n * Safe to call more than once.\n */\n destroy(): void {\n if (this.source && this.process?.stdin) this.source.unpipe(this.process.stdin);\n if (!this.stream.destroyed) this.stream.destroy();\n if (this.process && this.process.exitCode === null && this.process.signalCode === null) {\n this.process.kill();\n }\n this.process = null;\n }\n\n static from(source: AudioSource, options: AudioResourceOptions = {}): AudioResource {\n if (typeof source === \"string\" && !source.startsWith(\"http\") && !existsSync(source)) {\n throw new Error(`Audio file not found: ${source}`);\n }\n const { volume = 1.0, inputType } = options;\n\n const args = [\n ...(inputType ? [\"-f\", inputType] : []),\n \"-i\",\n typeof source === \"string\" ? source : \"pipe:0\",\n \"-af\",\n `volume=${volume}`,\n \"-ar\",\n \"48000\",\n \"-ac\",\n \"2\",\n \"-f\",\n \"s16le\",\n \"-acodec\",\n \"pcm_s16le\",\n \"pipe:1\",\n ];\n\n const ffmpeg = spawn(\"ffmpeg\", args, { stdio: [\"pipe\", \"pipe\", \"ignore\"] });\n\n if (source instanceof Readable) {\n source.pipe(ffmpeg.stdin!);\n source.once(\"error\", () => ffmpeg.kill());\n }\n\n ffmpeg.stdin?.on(\"error\", () => {}); // suppress EPIPE on early kill\n\n const pass = new PassThrough();\n ffmpeg.stdout.pipe(pass);\n ffmpeg.once(\"error\", (err) => pass.destroy(err));\n ffmpeg.once(\"close\", (code) => {\n if (code !== 0 && code !== null) {\n pass.destroy(new Error(`ffmpeg exited with code ${code}`));\n }\n });\n\n return new AudioResource(pass, ffmpeg, source instanceof Readable ? source : null);\n }\n}\n"],"mappings":"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","names":["import_voice","import_node_stream"]}
@@ -0,0 +1,122 @@
1
+ import { Client } from '@stoatx/client';
2
+ import { BaseVoiceConnection, BaseVoiceManager } from '@stoatx/voice';
3
+ export { VoiceChannelResolvable, VoiceConnectionEvents, VoiceConnectionStatus, VoiceJoinOptions, VoiceNode } from '@stoatx/voice';
4
+ import { EventEmitter } from 'node:events';
5
+ import { Readable } from 'node:stream';
6
+
7
+ interface AudioResourceOptions {
8
+ volume?: number;
9
+ inputType?: string;
10
+ }
11
+ type AudioSource = string | Readable;
12
+ declare class AudioResource {
13
+ readonly stream: Readable;
14
+ private process;
15
+ private readonly source;
16
+ private constructor();
17
+ /**
18
+ * Stops decoding: destroys the output stream and kills the ffmpeg process.
19
+ * Safe to call more than once.
20
+ */
21
+ destroy(): void;
22
+ static from(source: AudioSource, options?: AudioResourceOptions): AudioResource;
23
+ }
24
+
25
+ type AudioPlayerStatus = "idle" | "buffering" | "playing" | "paused" | "stopped";
26
+ interface AudioPlayerEvents {
27
+ stateChange: [oldStatus: AudioPlayerStatus, newStatus: AudioPlayerStatus];
28
+ idle: [];
29
+ error: [error: Error];
30
+ }
31
+ declare class AudioPlayer extends EventEmitter<AudioPlayerEvents> {
32
+ private _status;
33
+ private _resource;
34
+ private _detach;
35
+ /** Registered VoiceConnections subscribed to this player */
36
+ private readonly subscribers;
37
+ get status(): AudioPlayerStatus;
38
+ get resource(): AudioResource | null;
39
+ play(resource: AudioResource): void;
40
+ pause(): void;
41
+ resume(): void;
42
+ stop(): void;
43
+ /** @internal */
44
+ addSubscriber(conn: VoiceConnection): void;
45
+ /** @internal */
46
+ removeSubscriber(conn: VoiceConnection): void;
47
+ private releaseResource;
48
+ private transition;
49
+ }
50
+
51
+ /**
52
+ * A connection to a voice channel's call in Node.js. Plays audio from an {@link AudioPlayer}.
53
+ * Get one from `VoiceManager.join()`.
54
+ */
55
+ declare class VoiceConnection extends BaseVoiceConnection {
56
+ private readonly room;
57
+ private _player;
58
+ private _audioTrack;
59
+ private _audioSource;
60
+ private _publishing;
61
+ private _leftover;
62
+ /**
63
+ * @param channelId The voice channel's ID.
64
+ * @param serverId The ID of the server the channel is in, or `null` for DMs and groups.
65
+ */
66
+ constructor(channelId: string, serverId: string | null);
67
+ /** The player this connection plays audio from, if it's subscribed to one. */
68
+ get player(): AudioPlayer | null;
69
+ /** @internal */
70
+ connect(url: string, token: string): Promise<void>;
71
+ /**
72
+ * Plays audio from a player in this call. A connection plays from one player at a time;
73
+ * a player can play into several connections.
74
+ * @param player The player.
75
+ */
76
+ subscribe(player: AudioPlayer): void;
77
+ /**
78
+ * Keeps playing the old connection's player after the server moves the user to another call.
79
+ * @param previous The connection being replaced.
80
+ * @internal
81
+ */
82
+ _takeOver(previous: VoiceConnection): Promise<void>;
83
+ /** Stops playing audio from the current player. */
84
+ unsubscribe(): void;
85
+ /**
86
+ * Drops any partial frame left over from a previous stream.
87
+ * @internal
88
+ */
89
+ _resetStream(): void;
90
+ /**
91
+ * Converts a chunk of s16le PCM into frames and sends them to the room.
92
+ * Never rejects: failures are emitted as `error` events.
93
+ * @internal
94
+ */
95
+ _writeChunk(chunk: Buffer): Promise<void>;
96
+ private ensureTrack;
97
+ /** Leaves the call and stops sending audio. */
98
+ disconnect(): Promise<void>;
99
+ }
100
+
101
+ /**
102
+ * Joins voice calls from Node.js, e.g. for a music bot. Play audio into a call with an
103
+ * `AudioPlayer`.
104
+ *
105
+ * @example
106
+ * import { VoiceManager, AudioPlayer, AudioResource } from "@stoatx/voice-node";
107
+ *
108
+ * const voice = new VoiceManager(client);
109
+ * const connection = await voice.join(channel);
110
+ *
111
+ * const player = new AudioPlayer();
112
+ * connection.subscribe(player);
113
+ * player.play(AudioResource.from("./song.mp3"));
114
+ */
115
+ declare class VoiceManager extends BaseVoiceManager<VoiceConnection> {
116
+ /**
117
+ * @param client The client to join calls with.
118
+ */
119
+ constructor(client: Client);
120
+ }
121
+
122
+ export { AudioPlayer, type AudioPlayerEvents, type AudioPlayerStatus, AudioResource, type AudioResourceOptions, type AudioSource, VoiceConnection, VoiceManager };
@@ -0,0 +1,122 @@
1
+ import { Client } from '@stoatx/client';
2
+ import { BaseVoiceConnection, BaseVoiceManager } from '@stoatx/voice';
3
+ export { VoiceChannelResolvable, VoiceConnectionEvents, VoiceConnectionStatus, VoiceJoinOptions, VoiceNode } from '@stoatx/voice';
4
+ import { EventEmitter } from 'node:events';
5
+ import { Readable } from 'node:stream';
6
+
7
+ interface AudioResourceOptions {
8
+ volume?: number;
9
+ inputType?: string;
10
+ }
11
+ type AudioSource = string | Readable;
12
+ declare class AudioResource {
13
+ readonly stream: Readable;
14
+ private process;
15
+ private readonly source;
16
+ private constructor();
17
+ /**
18
+ * Stops decoding: destroys the output stream and kills the ffmpeg process.
19
+ * Safe to call more than once.
20
+ */
21
+ destroy(): void;
22
+ static from(source: AudioSource, options?: AudioResourceOptions): AudioResource;
23
+ }
24
+
25
+ type AudioPlayerStatus = "idle" | "buffering" | "playing" | "paused" | "stopped";
26
+ interface AudioPlayerEvents {
27
+ stateChange: [oldStatus: AudioPlayerStatus, newStatus: AudioPlayerStatus];
28
+ idle: [];
29
+ error: [error: Error];
30
+ }
31
+ declare class AudioPlayer extends EventEmitter<AudioPlayerEvents> {
32
+ private _status;
33
+ private _resource;
34
+ private _detach;
35
+ /** Registered VoiceConnections subscribed to this player */
36
+ private readonly subscribers;
37
+ get status(): AudioPlayerStatus;
38
+ get resource(): AudioResource | null;
39
+ play(resource: AudioResource): void;
40
+ pause(): void;
41
+ resume(): void;
42
+ stop(): void;
43
+ /** @internal */
44
+ addSubscriber(conn: VoiceConnection): void;
45
+ /** @internal */
46
+ removeSubscriber(conn: VoiceConnection): void;
47
+ private releaseResource;
48
+ private transition;
49
+ }
50
+
51
+ /**
52
+ * A connection to a voice channel's call in Node.js. Plays audio from an {@link AudioPlayer}.
53
+ * Get one from `VoiceManager.join()`.
54
+ */
55
+ declare class VoiceConnection extends BaseVoiceConnection {
56
+ private readonly room;
57
+ private _player;
58
+ private _audioTrack;
59
+ private _audioSource;
60
+ private _publishing;
61
+ private _leftover;
62
+ /**
63
+ * @param channelId The voice channel's ID.
64
+ * @param serverId The ID of the server the channel is in, or `null` for DMs and groups.
65
+ */
66
+ constructor(channelId: string, serverId: string | null);
67
+ /** The player this connection plays audio from, if it's subscribed to one. */
68
+ get player(): AudioPlayer | null;
69
+ /** @internal */
70
+ connect(url: string, token: string): Promise<void>;
71
+ /**
72
+ * Plays audio from a player in this call. A connection plays from one player at a time;
73
+ * a player can play into several connections.
74
+ * @param player The player.
75
+ */
76
+ subscribe(player: AudioPlayer): void;
77
+ /**
78
+ * Keeps playing the old connection's player after the server moves the user to another call.
79
+ * @param previous The connection being replaced.
80
+ * @internal
81
+ */
82
+ _takeOver(previous: VoiceConnection): Promise<void>;
83
+ /** Stops playing audio from the current player. */
84
+ unsubscribe(): void;
85
+ /**
86
+ * Drops any partial frame left over from a previous stream.
87
+ * @internal
88
+ */
89
+ _resetStream(): void;
90
+ /**
91
+ * Converts a chunk of s16le PCM into frames and sends them to the room.
92
+ * Never rejects: failures are emitted as `error` events.
93
+ * @internal
94
+ */
95
+ _writeChunk(chunk: Buffer): Promise<void>;
96
+ private ensureTrack;
97
+ /** Leaves the call and stops sending audio. */
98
+ disconnect(): Promise<void>;
99
+ }
100
+
101
+ /**
102
+ * Joins voice calls from Node.js, e.g. for a music bot. Play audio into a call with an
103
+ * `AudioPlayer`.
104
+ *
105
+ * @example
106
+ * import { VoiceManager, AudioPlayer, AudioResource } from "@stoatx/voice-node";
107
+ *
108
+ * const voice = new VoiceManager(client);
109
+ * const connection = await voice.join(channel);
110
+ *
111
+ * const player = new AudioPlayer();
112
+ * connection.subscribe(player);
113
+ * player.play(AudioResource.from("./song.mp3"));
114
+ */
115
+ declare class VoiceManager extends BaseVoiceManager<VoiceConnection> {
116
+ /**
117
+ * @param client The client to join calls with.
118
+ */
119
+ constructor(client: Client);
120
+ }
121
+
122
+ export { AudioPlayer, type AudioPlayerEvents, type AudioPlayerStatus, AudioResource, type AudioResourceOptions, type AudioSource, VoiceConnection, VoiceManager };
package/dist/index.js ADDED
@@ -0,0 +1,309 @@
1
+ // src/VoiceManager.ts
2
+ import { BaseVoiceManager } from "@stoatx/voice";
3
+
4
+ // src/VoiceConnection.ts
5
+ import {
6
+ Room,
7
+ RoomEvent,
8
+ TrackSource,
9
+ LocalAudioTrack,
10
+ TrackPublishOptions,
11
+ AudioFrame,
12
+ AudioSource
13
+ } from "@livekit/rtc-node";
14
+ import { BaseVoiceConnection } from "@stoatx/voice";
15
+ var SAMPLE_RATE = 48e3;
16
+ var CHANNELS = 2;
17
+ var SAMPLES_PER_FRAME = 960;
18
+ var BYTES_PER_FRAME = SAMPLES_PER_FRAME * CHANNELS * 2;
19
+ var VoiceConnection = class extends BaseVoiceConnection {
20
+ room;
21
+ _player = null;
22
+ _audioTrack = null;
23
+ _audioSource = null;
24
+ _publishing = null;
25
+ _leftover = Buffer.alloc(0);
26
+ /**
27
+ * @param channelId The voice channel's ID.
28
+ * @param serverId The ID of the server the channel is in, or `null` for DMs and groups.
29
+ */
30
+ constructor(channelId, serverId) {
31
+ super(channelId, serverId);
32
+ this.room = new Room();
33
+ this.room.on(RoomEvent.Disconnected, () => {
34
+ this._status = "disconnected";
35
+ this._player?.removeSubscriber(this);
36
+ this.emitBase("disconnect");
37
+ });
38
+ }
39
+ /** The player this connection plays audio from, if it's subscribed to one. */
40
+ get player() {
41
+ return this._player;
42
+ }
43
+ /** @internal */
44
+ async connect(url, token) {
45
+ await this.room.connect(url, token);
46
+ this._status = "ready";
47
+ this.emitBase("ready");
48
+ }
49
+ /**
50
+ * Plays audio from a player in this call. A connection plays from one player at a time;
51
+ * a player can play into several connections.
52
+ * @param player The player.
53
+ */
54
+ subscribe(player) {
55
+ if (this._player) this._player.removeSubscriber(this);
56
+ this._player = player;
57
+ player.addSubscriber(this);
58
+ }
59
+ /**
60
+ * Keeps playing the old connection's player after the server moves the user to another call.
61
+ * @param previous The connection being replaced.
62
+ * @internal
63
+ */
64
+ async _takeOver(previous) {
65
+ if (previous.player) this.subscribe(previous.player);
66
+ }
67
+ /** Stops playing audio from the current player. */
68
+ unsubscribe() {
69
+ this._player?.removeSubscriber(this);
70
+ this._player = null;
71
+ }
72
+ /**
73
+ * Drops any partial frame left over from a previous stream.
74
+ * @internal
75
+ */
76
+ _resetStream() {
77
+ this._leftover = Buffer.alloc(0);
78
+ }
79
+ /**
80
+ * Converts a chunk of s16le PCM into frames and sends them to the room.
81
+ * Never rejects: failures are emitted as `error` events.
82
+ * @internal
83
+ */
84
+ async _writeChunk(chunk) {
85
+ try {
86
+ if (this._status !== "ready") return;
87
+ const source = await this.ensureTrack();
88
+ const buf = Buffer.concat([this._leftover, chunk]);
89
+ let offset = 0;
90
+ while (offset + BYTES_PER_FRAME <= buf.length) {
91
+ if (this._status !== "ready" || !this._player) return;
92
+ const slice = buf.subarray(offset, offset + BYTES_PER_FRAME);
93
+ const tmp = slice.buffer.slice(slice.byteOffset, slice.byteOffset + slice.byteLength);
94
+ const pcm = new Int16Array(tmp);
95
+ await source.captureFrame(new AudioFrame(pcm, SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME));
96
+ offset += BYTES_PER_FRAME;
97
+ }
98
+ this._leftover = buf.subarray(offset);
99
+ } catch (error) {
100
+ this.reportError(error);
101
+ }
102
+ }
103
+ ensureTrack() {
104
+ if (!this._publishing) {
105
+ this._publishing = (async () => {
106
+ if (!this.room.localParticipant) {
107
+ throw new Error("Not connected to a room");
108
+ }
109
+ const source = new AudioSource(SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME);
110
+ const track = LocalAudioTrack.createAudioTrack("audio", source);
111
+ const options = new TrackPublishOptions();
112
+ options.source = TrackSource.SOURCE_MICROPHONE;
113
+ await this.room.localParticipant.publishTrack(track, options);
114
+ this._audioTrack = track;
115
+ this._audioSource = source;
116
+ return source;
117
+ })();
118
+ this._publishing.catch(() => {
119
+ this._publishing = null;
120
+ });
121
+ }
122
+ return this._publishing;
123
+ }
124
+ /** Leaves the call and stops sending audio. */
125
+ async disconnect() {
126
+ this._status = "disconnecting";
127
+ this.unsubscribe();
128
+ if (this._audioTrack) {
129
+ await this._audioTrack.close();
130
+ this._audioTrack = null;
131
+ }
132
+ if (this._audioSource) {
133
+ await this._audioSource.close();
134
+ this._audioSource = null;
135
+ }
136
+ this._publishing = null;
137
+ this._leftover = Buffer.alloc(0);
138
+ await this.room.disconnect();
139
+ }
140
+ };
141
+
142
+ // src/VoiceManager.ts
143
+ var VoiceManager = class extends BaseVoiceManager {
144
+ /**
145
+ * @param client The client to join calls with.
146
+ */
147
+ constructor(client) {
148
+ super(client, (channelId, serverId) => new VoiceConnection(channelId, serverId));
149
+ }
150
+ };
151
+
152
+ // src/AudioPlayer.ts
153
+ import { EventEmitter } from "events";
154
+ var AudioPlayer = class extends EventEmitter {
155
+ _status = "idle";
156
+ _resource = null;
157
+ _detach = null;
158
+ /** Registered VoiceConnections subscribed to this player */
159
+ subscribers = /* @__PURE__ */ new Set();
160
+ get status() {
161
+ return this._status;
162
+ }
163
+ get resource() {
164
+ return this._resource;
165
+ }
166
+ play(resource) {
167
+ this.releaseResource();
168
+ this._resource = resource;
169
+ this.transition("buffering");
170
+ for (const conn of this.subscribers) conn._resetStream();
171
+ const stream = resource.stream;
172
+ const onData = (chunk) => {
173
+ if (this._status === "buffering") this.transition("playing");
174
+ stream.pause();
175
+ const writes = [...this.subscribers].map((conn) => conn._writeChunk(chunk));
176
+ void Promise.allSettled(writes).then(() => {
177
+ if (this._resource === resource && this._status === "playing") stream.resume();
178
+ });
179
+ };
180
+ const onEnd = () => {
181
+ this.releaseResource();
182
+ this.transition("idle");
183
+ this.emit("idle");
184
+ };
185
+ const onError = (err) => {
186
+ this.releaseResource();
187
+ this.transition("idle");
188
+ if (this.listenerCount("error") > 0) this.emit("error", err);
189
+ };
190
+ stream.on("data", onData);
191
+ stream.once("end", onEnd);
192
+ stream.once("error", onError);
193
+ this._detach = () => {
194
+ stream.off("data", onData);
195
+ stream.off("end", onEnd);
196
+ stream.off("error", onError);
197
+ stream.on("error", () => {
198
+ });
199
+ };
200
+ }
201
+ pause() {
202
+ if (this._status !== "playing") return;
203
+ this._resource?.stream.pause();
204
+ this.transition("paused");
205
+ }
206
+ resume() {
207
+ if (this._status !== "paused") return;
208
+ this.transition("playing");
209
+ this._resource?.stream.resume();
210
+ }
211
+ stop() {
212
+ this.releaseResource();
213
+ this.transition("stopped");
214
+ this.transition("idle");
215
+ this.emit("idle");
216
+ }
217
+ /** @internal */
218
+ addSubscriber(conn) {
219
+ this.subscribers.add(conn);
220
+ }
221
+ /** @internal */
222
+ removeSubscriber(conn) {
223
+ this.subscribers.delete(conn);
224
+ }
225
+ releaseResource() {
226
+ this._detach?.();
227
+ this._detach = null;
228
+ this._resource?.destroy();
229
+ this._resource = null;
230
+ }
231
+ transition(next) {
232
+ const prev = this._status;
233
+ this._status = next;
234
+ this.emit("stateChange", prev, next);
235
+ }
236
+ };
237
+
238
+ // src/AudioResource.ts
239
+ import { Readable } from "stream";
240
+ import { spawn } from "child_process";
241
+ import { PassThrough } from "stream";
242
+ import { existsSync } from "fs";
243
+ var AudioResource = class _AudioResource {
244
+ stream;
245
+ process;
246
+ source;
247
+ constructor(stream, process, source) {
248
+ this.stream = stream;
249
+ this.process = process;
250
+ this.source = source;
251
+ }
252
+ /**
253
+ * Stops decoding: destroys the output stream and kills the ffmpeg process.
254
+ * Safe to call more than once.
255
+ */
256
+ destroy() {
257
+ if (this.source && this.process?.stdin) this.source.unpipe(this.process.stdin);
258
+ if (!this.stream.destroyed) this.stream.destroy();
259
+ if (this.process && this.process.exitCode === null && this.process.signalCode === null) {
260
+ this.process.kill();
261
+ }
262
+ this.process = null;
263
+ }
264
+ static from(source, options = {}) {
265
+ if (typeof source === "string" && !source.startsWith("http") && !existsSync(source)) {
266
+ throw new Error(`Audio file not found: ${source}`);
267
+ }
268
+ const { volume = 1, inputType } = options;
269
+ const args = [
270
+ ...inputType ? ["-f", inputType] : [],
271
+ "-i",
272
+ typeof source === "string" ? source : "pipe:0",
273
+ "-af",
274
+ `volume=${volume}`,
275
+ "-ar",
276
+ "48000",
277
+ "-ac",
278
+ "2",
279
+ "-f",
280
+ "s16le",
281
+ "-acodec",
282
+ "pcm_s16le",
283
+ "pipe:1"
284
+ ];
285
+ const ffmpeg = spawn("ffmpeg", args, { stdio: ["pipe", "pipe", "ignore"] });
286
+ if (source instanceof Readable) {
287
+ source.pipe(ffmpeg.stdin);
288
+ source.once("error", () => ffmpeg.kill());
289
+ }
290
+ ffmpeg.stdin?.on("error", () => {
291
+ });
292
+ const pass = new PassThrough();
293
+ ffmpeg.stdout.pipe(pass);
294
+ ffmpeg.once("error", (err) => pass.destroy(err));
295
+ ffmpeg.once("close", (code) => {
296
+ if (code !== 0 && code !== null) {
297
+ pass.destroy(new Error(`ffmpeg exited with code ${code}`));
298
+ }
299
+ });
300
+ return new _AudioResource(pass, ffmpeg, source instanceof Readable ? source : null);
301
+ }
302
+ };
303
+ export {
304
+ AudioPlayer,
305
+ AudioResource,
306
+ VoiceConnection,
307
+ VoiceManager
308
+ };
309
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/VoiceManager.ts","../src/VoiceConnection.ts","../src/AudioPlayer.ts","../src/AudioResource.ts"],"sourcesContent":["import type { Client } from \"@stoatx/client\";\nimport { BaseVoiceManager } from \"@stoatx/voice\";\nimport { VoiceConnection } from \"./VoiceConnection\";\n\n/**\n * Joins voice calls from Node.js, e.g. for a music bot. Play audio into a call with an\n * `AudioPlayer`.\n *\n * @example\n * import { VoiceManager, AudioPlayer, AudioResource } from \"@stoatx/voice-node\";\n *\n * const voice = new VoiceManager(client);\n * const connection = await voice.join(channel);\n *\n * const player = new AudioPlayer();\n * connection.subscribe(player);\n * player.play(AudioResource.from(\"./song.mp3\"));\n */\nexport class VoiceManager extends BaseVoiceManager<VoiceConnection> {\n /**\n * @param client The client to join calls with.\n */\n constructor(client: Client) {\n super(client, (channelId, serverId) => new VoiceConnection(channelId, serverId));\n }\n}\n","import {\n Room,\n RoomEvent,\n TrackSource,\n LocalAudioTrack,\n TrackPublishOptions,\n AudioFrame,\n AudioSource,\n} from \"@livekit/rtc-node\";\nimport { BaseVoiceConnection } from \"@stoatx/voice\";\nimport type { AudioPlayer } from \"./AudioPlayer\";\n\nconst SAMPLE_RATE = 48000;\nconst CHANNELS = 2;\nconst SAMPLES_PER_FRAME = 960;\nconst BYTES_PER_FRAME = SAMPLES_PER_FRAME * CHANNELS * 2;\n\n/**\n * A connection to a voice channel's call in Node.js. Plays audio from an {@link AudioPlayer}.\n * Get one from `VoiceManager.join()`.\n */\nexport class VoiceConnection extends BaseVoiceConnection {\n private readonly room: Room;\n private _player: AudioPlayer | null = null;\n private _audioTrack: LocalAudioTrack | null = null;\n private _audioSource: AudioSource | null = null;\n private _publishing: Promise<AudioSource> | null = null;\n private _leftover: Buffer = Buffer.alloc(0);\n\n /**\n * @param channelId The voice channel's ID.\n * @param serverId The ID of the server the channel is in, or `null` for DMs and groups.\n */\n constructor(channelId: string, serverId: string | null) {\n super(channelId, serverId);\n this.room = new Room();\n this.room.on(RoomEvent.Disconnected, () => {\n this._status = \"disconnected\";\n this._player?.removeSubscriber(this);\n this.emitBase(\"disconnect\");\n });\n }\n\n /** The player this connection plays audio from, if it's subscribed to one. */\n get player(): AudioPlayer | null {\n return this._player;\n }\n\n /** @internal */\n async connect(url: string, token: string): Promise<void> {\n await this.room.connect(url, token);\n this._status = \"ready\";\n this.emitBase(\"ready\");\n }\n\n /**\n * Plays audio from a player in this call. A connection plays from one player at a time;\n * a player can play into several connections.\n * @param player The player.\n */\n subscribe(player: AudioPlayer): void {\n if (this._player) this._player.removeSubscriber(this);\n this._player = player;\n player.addSubscriber(this);\n }\n\n /**\n * Keeps playing the old connection's player after the server moves the user to another call.\n * @param previous The connection being replaced.\n * @internal\n */\n override async _takeOver(previous: VoiceConnection): Promise<void> {\n if (previous.player) this.subscribe(previous.player);\n }\n\n /** Stops playing audio from the current player. */\n unsubscribe(): void {\n this._player?.removeSubscriber(this);\n this._player = null;\n }\n\n /**\n * Drops any partial frame left over from a previous stream.\n * @internal\n */\n _resetStream(): void {\n this._leftover = Buffer.alloc(0);\n }\n\n /**\n * Converts a chunk of s16le PCM into frames and sends them to the room.\n * Never rejects: failures are emitted as `error` events.\n * @internal\n */\n async _writeChunk(chunk: Buffer): Promise<void> {\n try {\n if (this._status !== \"ready\") return;\n const source = await this.ensureTrack();\n\n const buf = Buffer.concat([this._leftover, chunk]);\n let offset = 0;\n\n while (offset + BYTES_PER_FRAME <= buf.length) {\n // Stop sending as soon as we are detached or disconnected.\n if (this._status !== \"ready\" || !this._player) return;\n\n const slice = buf.subarray(offset, offset + BYTES_PER_FRAME);\n const tmp = slice.buffer.slice(slice.byteOffset, slice.byteOffset + slice.byteLength);\n const pcm = new Int16Array(tmp);\n await source.captureFrame(new AudioFrame(pcm, SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME));\n offset += BYTES_PER_FRAME;\n }\n\n this._leftover = buf.subarray(offset);\n } catch (error) {\n this.reportError(error);\n }\n }\n\n private ensureTrack(): Promise<AudioSource> {\n if (!this._publishing) {\n this._publishing = (async () => {\n if (!this.room.localParticipant) {\n throw new Error(\"Not connected to a room\");\n }\n const source = new AudioSource(SAMPLE_RATE, CHANNELS, SAMPLES_PER_FRAME);\n const track = LocalAudioTrack.createAudioTrack(\"audio\", source);\n\n const options = new TrackPublishOptions();\n options.source = TrackSource.SOURCE_MICROPHONE;\n await this.room.localParticipant.publishTrack(track, options);\n\n this._audioTrack = track;\n this._audioSource = source;\n return source;\n })();\n this._publishing.catch(() => {\n this._publishing = null;\n });\n }\n return this._publishing;\n }\n\n /** Leaves the call and stops sending audio. */\n async disconnect(): Promise<void> {\n this._status = \"disconnecting\";\n this.unsubscribe();\n if (this._audioTrack) {\n await this._audioTrack.close();\n this._audioTrack = null;\n }\n // The source holds a native handle; close it so a disconnect doesn't leak it.\n if (this._audioSource) {\n await this._audioSource.close();\n this._audioSource = null;\n }\n this._publishing = null;\n this._leftover = Buffer.alloc(0);\n await this.room.disconnect();\n }\n}\n","import { EventEmitter } from \"node:events\";\nimport { AudioResource } from \"./AudioResource\";\nimport type { VoiceConnection } from \"./VoiceConnection\";\n\nexport type AudioPlayerStatus = \"idle\" | \"buffering\" | \"playing\" | \"paused\" | \"stopped\";\n\nexport interface AudioPlayerEvents {\n stateChange: [oldStatus: AudioPlayerStatus, newStatus: AudioPlayerStatus];\n idle: [];\n error: [error: Error];\n}\n\nexport class AudioPlayer extends EventEmitter<AudioPlayerEvents> {\n private _status: AudioPlayerStatus = \"idle\";\n private _resource: AudioResource | null = null;\n private _detach: (() => void) | null = null;\n\n /** Registered VoiceConnections subscribed to this player */\n private readonly subscribers: Set<VoiceConnection> = new Set();\n\n get status(): AudioPlayerStatus {\n return this._status;\n }\n\n get resource(): AudioResource | null {\n return this._resource;\n }\n\n play(resource: AudioResource): void {\n // Tear down whatever was playing before so its ffmpeg process does not leak.\n this.releaseResource();\n\n this._resource = resource;\n this.transition(\"buffering\");\n\n for (const conn of this.subscribers) conn._resetStream();\n\n const stream = resource.stream;\n\n // The player reads the stream once and fans each chunk out to every\n // subscriber. The stream stays paused until all subscribers have consumed\n // the chunk, which keeps decoding at playback speed.\n const onData = (chunk: Buffer) => {\n if (this._status === \"buffering\") this.transition(\"playing\");\n stream.pause();\n\n const writes = [...this.subscribers].map((conn) => conn._writeChunk(chunk));\n void Promise.allSettled(writes).then(() => {\n if (this._resource === resource && this._status === \"playing\") stream.resume();\n });\n };\n\n const onEnd = () => {\n this.releaseResource();\n this.transition(\"idle\");\n this.emit(\"idle\");\n };\n\n const onError = (err: Error) => {\n this.releaseResource();\n this.transition(\"idle\");\n if (this.listenerCount(\"error\") > 0) this.emit(\"error\", err);\n };\n\n stream.on(\"data\", onData);\n stream.once(\"end\", onEnd);\n stream.once(\"error\", onError);\n\n this._detach = () => {\n stream.off(\"data\", onData);\n stream.off(\"end\", onEnd);\n stream.off(\"error\", onError);\n // Keep a no-op error handler so destroying the stream cannot throw.\n stream.on(\"error\", () => {});\n };\n }\n\n pause(): void {\n if (this._status !== \"playing\") return;\n this._resource?.stream.pause();\n this.transition(\"paused\");\n }\n\n resume(): void {\n if (this._status !== \"paused\") return;\n this.transition(\"playing\");\n this._resource?.stream.resume();\n }\n\n stop(): void {\n this.releaseResource();\n this.transition(\"stopped\");\n this.transition(\"idle\");\n this.emit(\"idle\");\n }\n\n /** @internal */\n addSubscriber(conn: VoiceConnection): void {\n this.subscribers.add(conn);\n }\n\n /** @internal */\n removeSubscriber(conn: VoiceConnection): void {\n this.subscribers.delete(conn);\n }\n\n private releaseResource(): void {\n this._detach?.();\n this._detach = null;\n this._resource?.destroy();\n this._resource = null;\n }\n\n private transition(next: AudioPlayerStatus): void {\n const prev = this._status;\n this._status = next;\n this.emit(\"stateChange\", prev, next);\n }\n}\n","import { Readable } from \"node:stream\";\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { PassThrough } from \"node:stream\";\nimport { existsSync } from \"node:fs\";\n\nexport interface AudioResourceOptions {\n volume?: number;\n inputType?: string;\n}\n\nexport type AudioSource = string | Readable;\n\nexport class AudioResource {\n readonly stream: Readable;\n private process: ChildProcess | null;\n private readonly source: Readable | null;\n\n private constructor(stream: Readable, process: ChildProcess, source: Readable | null) {\n this.stream = stream;\n this.process = process;\n this.source = source;\n }\n\n /**\n * Stops decoding: destroys the output stream and kills the ffmpeg process.\n * Safe to call more than once.\n */\n destroy(): void {\n if (this.source && this.process?.stdin) this.source.unpipe(this.process.stdin);\n if (!this.stream.destroyed) this.stream.destroy();\n if (this.process && this.process.exitCode === null && this.process.signalCode === null) {\n this.process.kill();\n }\n this.process = null;\n }\n\n static from(source: AudioSource, options: AudioResourceOptions = {}): AudioResource {\n if (typeof source === \"string\" && !source.startsWith(\"http\") && !existsSync(source)) {\n throw new Error(`Audio file not found: ${source}`);\n }\n const { volume = 1.0, inputType } = options;\n\n const args = [\n ...(inputType ? [\"-f\", inputType] : []),\n \"-i\",\n typeof source === \"string\" ? source : \"pipe:0\",\n \"-af\",\n `volume=${volume}`,\n \"-ar\",\n \"48000\",\n \"-ac\",\n \"2\",\n \"-f\",\n \"s16le\",\n \"-acodec\",\n \"pcm_s16le\",\n \"pipe:1\",\n ];\n\n const ffmpeg = spawn(\"ffmpeg\", args, { stdio: [\"pipe\", \"pipe\", \"ignore\"] });\n\n if (source instanceof Readable) {\n source.pipe(ffmpeg.stdin!);\n source.once(\"error\", () => ffmpeg.kill());\n }\n\n ffmpeg.stdin?.on(\"error\", () => {}); // suppress EPIPE on early kill\n\n const pass = new PassThrough();\n ffmpeg.stdout.pipe(pass);\n ffmpeg.once(\"error\", (err) => pass.destroy(err));\n ffmpeg.once(\"close\", (code) => {\n if (code !== 0 && code !== null) {\n pass.destroy(new Error(`ffmpeg exited with code ${code}`));\n }\n });\n\n return new AudioResource(pass, ffmpeg, source instanceof Readable ? source : null);\n }\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,49 @@
1
1
  {
2
2
  "name": "@stoatx/voice-node",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "1.0.0",
4
+ "type": "module",
5
+ "description": "Voice for @stoatx/client in Node.js: join voice channels and play audio with ffmpeg.",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/stoatx-ts/stoatx.git"
9
+ },
10
+ "bugs": {
11
+ "url": "https://github.com/stoatx-ts/stoatx/issues"
12
+ },
13
+ "homepage": "https://github.com/stoatx-ts/stoatx#readme",
14
+ "main": "./dist/index.cjs",
15
+ "module": "./dist/index.js",
16
+ "types": "./dist/index.d.ts",
17
+ "exports": {
18
+ ".": {
19
+ "types": "./dist/index.d.ts",
20
+ "import": "./dist/index.js",
21
+ "require": "./dist/index.cjs"
22
+ }
23
+ },
24
+ "files": [
25
+ "dist"
26
+ ],
27
+ "license": "MIT",
28
+ "engines": {
29
+ "node": ">=22.0.0"
30
+ },
31
+ "publishConfig": {
32
+ "access": "public"
33
+ },
34
+ "dependencies": {
35
+ "@livekit/rtc-node": "^1.2.1",
36
+ "@stoatx/voice": "1.0.0"
37
+ },
38
+ "peerDependencies": {
39
+ "@stoatx/client": "^1.0.0"
40
+ },
41
+ "devDependencies": {
42
+ "@stoatx/client": "1.0.0"
43
+ },
44
+ "scripts": {
45
+ "build": "tsup",
46
+ "dev": "tsup --watch",
47
+ "lint": "eslint src/**/*.ts"
48
+ }
6
49
  }