@fluxerjs/voice 1.3.0 → 1.3.1

package/dist/index.d.mts

@@ -42,12 +42,17 @@ declare class VoiceConnection extends EventEmitter {
     private setupUDP;
     /**
      * Play a stream of raw Opus packets
-     * Uses the same queue and 20ms pacing as play(). Use this for local files (MP3 → PCM → Opus) or other Opus sources.
+     * Uses the same queue and 20ms pacing as play(). Use this for raw Opus packet streams (e.g. MP3 → PCM → Opus pipelines) when you are not using WebM/Opus.
      */
     playOpus(stream: NodeJS.ReadableStream): void;
     /**
-     * Play a direct WebM/Opus URL or stream. Fetches the URL (if string), demuxes with prism-media WebmDemuxer,
-     * and sends Opus packets to the voice connection. No FFmpeg or encoding; input must be WebM with Opus.
+     * Play a direct WebM/Opus source. When `urlOrStream` is a string:
+     * - `http://` / `https://` — fetched over the network
+     * - `file://` — read from the local filesystem
+     * - any other string — treated as a filesystem path (e.g. `./music/track.webm`)
+     *
+     * You can also pass a Node.js Readable stream. Demuxes with prism-media WebmDemuxer; no FFmpeg;
+     * input must be WebM with Opus.
      */
     play(urlOrStream: string | NodeJS.ReadableStream): Promise<void>;
     private sendAudioFrame;
@@ -222,10 +227,13 @@ declare class LiveKitRtcConnection extends EventEmitter {
      */
     private playVideoFFmpeg;
     /**
-     * Play audio from a WebM/Opus URL or readable stream. Publishes to the LiveKit room as an audio track.
+     * Play audio from a WebM/Opus source. Publishes to the LiveKit room as an audio track.
+     *
+     * When `urlOrStream` is a string: `http(s)://` is fetched; `file://` or any other string is read
+     * from the local filesystem (path). Otherwise pass a Node.js ReadableStream.
      *
-     * @param urlOrStream - Audio source: HTTP(S) URL to a WebM/Opus file, or a Node.js ReadableStream
-     * @emits error - On fetch failure or decode errors
+     * @param urlOrStream - WebM/Opus HTTP(S) URL, `file://` URL, filesystem path, or ReadableStream
+     * @emits error - On fetch/read failure or decode errors
      */
     play(urlOrStream: string | NodeJS.ReadableStream): Promise<void>;
     /**

package/dist/index.d.ts

@@ -42,12 +42,17 @@ declare class VoiceConnection extends EventEmitter {
     private setupUDP;
     /**
      * Play a stream of raw Opus packets
-     * Uses the same queue and 20ms pacing as play(). Use this for local files (MP3 → PCM → Opus) or other Opus sources.
+     * Uses the same queue and 20ms pacing as play(). Use this for raw Opus packet streams (e.g. MP3 → PCM → Opus pipelines) when you are not using WebM/Opus.
      */
     playOpus(stream: NodeJS.ReadableStream): void;
     /**
-     * Play a direct WebM/Opus URL or stream. Fetches the URL (if string), demuxes with prism-media WebmDemuxer,
-     * and sends Opus packets to the voice connection. No FFmpeg or encoding; input must be WebM with Opus.
+     * Play a direct WebM/Opus source. When `urlOrStream` is a string:
+     * - `http://` / `https://` — fetched over the network
+     * - `file://` — read from the local filesystem
+     * - any other string — treated as a filesystem path (e.g. `./music/track.webm`)
+     *
+     * You can also pass a Node.js Readable stream. Demuxes with prism-media WebmDemuxer; no FFmpeg;
+     * input must be WebM with Opus.
      */
     play(urlOrStream: string | NodeJS.ReadableStream): Promise<void>;
     private sendAudioFrame;
@@ -222,10 +227,13 @@ declare class LiveKitRtcConnection extends EventEmitter {
      */
     private playVideoFFmpeg;
     /**
-     * Play audio from a WebM/Opus URL or readable stream. Publishes to the LiveKit room as an audio track.
+     * Play audio from a WebM/Opus source. Publishes to the LiveKit room as an audio track.
+     *
+     * When `urlOrStream` is a string: `http(s)://` is fetched; `file://` or any other string is read
+     * from the local filesystem (path). Otherwise pass a Node.js ReadableStream.
      *
-     * @param urlOrStream - Audio source: HTTP(S) URL to a WebM/Opus file, or a Node.js ReadableStream
-     * @emits error - On fetch failure or decode errors
+     * @param urlOrStream - WebM/Opus HTTP(S) URL, `file://` URL, filesystem path, or ReadableStream
+     * @emits error - On fetch/read failure or decode errors
      */
     play(urlOrStream: string | NodeJS.ReadableStream): Promise<void>;
     /**

package/dist/index.js

@@ -53,7 +53,9 @@ var import_util = require("@fluxerjs/util");
 var nacl = __toESM(require("tweetnacl"));
 var dgram = __toESM(require("dgram"));
 var ws = __toESM(require("ws"));
+var import_node_fs = require("fs");
 var import_node_stream = require("stream");
+var import_node_url = require("url");
 var import_prism_media = require("prism-media");
 var VOICE_WS_OPCODES = {
   Identify: 0,
@@ -257,7 +259,7 @@ var VoiceConnection = class extends import_events.EventEmitter {
   }
   /**
    * Play a stream of raw Opus packets
-   * Uses the same queue and 20ms pacing as play(). Use this for local files (MP3 → PCM → Opus) or other Opus sources.
+   * Uses the same queue and 20ms pacing as play(). Use this for raw Opus packet streams (e.g. MP3 → PCM → Opus pipelines) when you are not using WebM/Opus.
    */
   playOpus(stream) {
     this.stop();
@@ -293,22 +295,35 @@ var VoiceConnection = class extends import_events.EventEmitter {
     });
   }
   /**
-   * Play a direct WebM/Opus URL or stream. Fetches the URL (if string), demuxes with prism-media WebmDemuxer,
-   * and sends Opus packets to the voice connection. No FFmpeg or encoding; input must be WebM with Opus.
+   * Play a direct WebM/Opus source. When `urlOrStream` is a string:
+   * - `http://` / `https://` — fetched over the network
+   * - `file://` — read from the local filesystem
+   * - any other string — treated as a filesystem path (e.g. `./music/track.webm`)
+   *
+   * You can also pass a Node.js Readable stream. Demuxes with prism-media WebmDemuxer; no FFmpeg;
+   * input must be WebM with Opus.
    */
   async play(urlOrStream) {
     this.stop();
     let inputStream;
     if (typeof urlOrStream === "string") {
       try {
-        const response = await fetch(urlOrStream);
-        if (!response.ok) {
-          throw new import_util.FluxerError(`HTTP ${response.status}`, { code: import_util.ErrorCodes.VoiceHttpError });
-        }
-        if (!response.body) {
-          throw new import_util.FluxerError("No response body", { code: import_util.ErrorCodes.VoiceNoResponseBody });
+        const spec = urlOrStream.trim();
+        const lower = spec.toLowerCase();
+        if (lower.startsWith("http://") || lower.startsWith("https://")) {
+          const response = await fetch(spec);
+          if (!response.ok) {
+            throw new import_util.FluxerError(`HTTP ${response.status}`, { code: import_util.ErrorCodes.VoiceHttpError });
+          }
+          if (!response.body) {
+            throw new import_util.FluxerError("No response body", { code: import_util.ErrorCodes.VoiceNoResponseBody });
+          }
+          inputStream = import_node_stream.Readable.fromWeb(response.body);
+        } else if (lower.startsWith("file:")) {
+          inputStream = (0, import_node_fs.createReadStream)((0, import_node_url.fileURLToPath)(new URL(spec)));
+        } else {
+          inputStream = (0, import_node_fs.createReadStream)(spec);
         }
-        inputStream = import_node_stream.Readable.fromWeb(response.body);
       } catch (e) {
         const err = e instanceof import_util.FluxerError ? e : new import_util.FluxerError(e instanceof Error ? e.message : String(e), {
           code: import_util.ErrorCodes.FileFetchFailed,
@@ -504,7 +519,9 @@ function concatUint8Arrays(a, b) {
 }
 
 // src/LiveKitRtcConnection.ts
+var import_node_fs2 = require("fs");
 var import_node_stream2 = require("stream");
+var import_node_url2 = require("url");
 var import_opus_decoder = require("opus-decoder");
 var import_prism_media2 = require("prism-media");
 var import_node_util = require("util");
@@ -1698,10 +1715,13 @@ var LiveKitRtcConnection = class extends import_events2.EventEmitter {
     runFFmpeg().catch((e) => this.audioDebug("ffmpeg error", { error: String(e) }));
   }
   /**
-   * Play audio from a WebM/Opus URL or readable stream. Publishes to the LiveKit room as an audio track.
+   * Play audio from a WebM/Opus source. Publishes to the LiveKit room as an audio track.
+   *
+   * When `urlOrStream` is a string: `http(s)://` is fetched; `file://` or any other string is read
+   * from the local filesystem (path). Otherwise pass a Node.js ReadableStream.
    *
-   * @param urlOrStream - Audio source: HTTP(S) URL to a WebM/Opus file, or a Node.js ReadableStream
-   * @emits error - On fetch failure or decode errors
+   * @param urlOrStream - WebM/Opus HTTP(S) URL, `file://` URL, filesystem path, or ReadableStream
+   * @emits error - On fetch/read failure or decode errors
    */
   async play(urlOrStream) {
     this.stop();
@@ -1712,14 +1732,22 @@ var LiveKitRtcConnection = class extends import_events2.EventEmitter {
     let inputStream;
     if (typeof urlOrStream === "string") {
       try {
-        const response = await fetch(urlOrStream);
-        if (!response.ok) {
-          throw new import_util2.FluxerError(`HTTP ${response.status}`, { code: import_util2.ErrorCodes.VoiceHttpError });
-        }
-        if (!response.body) {
-          throw new import_util2.FluxerError("No response body", { code: import_util2.ErrorCodes.VoiceNoResponseBody });
+        const spec = urlOrStream.trim();
+        const lower = spec.toLowerCase();
+        if (lower.startsWith("http://") || lower.startsWith("https://")) {
+          const response = await fetch(spec);
+          if (!response.ok) {
+            throw new import_util2.FluxerError(`HTTP ${response.status}`, { code: import_util2.ErrorCodes.VoiceHttpError });
+          }
+          if (!response.body) {
+            throw new import_util2.FluxerError("No response body", { code: import_util2.ErrorCodes.VoiceNoResponseBody });
+          }
+          inputStream = import_node_stream2.Readable.fromWeb(response.body);
+        } else if (lower.startsWith("file:")) {
+          inputStream = (0, import_node_fs2.createReadStream)((0, import_node_url2.fileURLToPath)(new URL(spec)));
+        } else {
+          inputStream = (0, import_node_fs2.createReadStream)(spec);
         }
-        inputStream = import_node_stream2.Readable.fromWeb(response.body);
       } catch (e) {
         const err = e instanceof import_util2.FluxerError ? e : new import_util2.FluxerError(e instanceof Error ? e.message : String(e), {
           code: import_util2.ErrorCodes.FileFetchFailed,

package/dist/index.mjs

@@ -13,7 +13,9 @@ import { ErrorCodes, FluxerError } from "@fluxerjs/util";
 import * as nacl from "tweetnacl";
 import * as dgram from "dgram";
 import * as ws from "ws";
+import { createReadStream } from "fs";
 import { Readable } from "stream";
+import { fileURLToPath } from "url";
 import { opus } from "prism-media";
 var VOICE_WS_OPCODES = {
   Identify: 0,
@@ -217,7 +219,7 @@ var VoiceConnection = class extends EventEmitter {
   }
   /**
    * Play a stream of raw Opus packets
-   * Uses the same queue and 20ms pacing as play(). Use this for local files (MP3 → PCM → Opus) or other Opus sources.
+   * Uses the same queue and 20ms pacing as play(). Use this for raw Opus packet streams (e.g. MP3 → PCM → Opus pipelines) when you are not using WebM/Opus.
    */
   playOpus(stream) {
     this.stop();
@@ -253,22 +255,35 @@ var VoiceConnection = class extends EventEmitter {
     });
   }
   /**
-   * Play a direct WebM/Opus URL or stream. Fetches the URL (if string), demuxes with prism-media WebmDemuxer,
-   * and sends Opus packets to the voice connection. No FFmpeg or encoding; input must be WebM with Opus.
+   * Play a direct WebM/Opus source. When `urlOrStream` is a string:
+   * - `http://` / `https://` — fetched over the network
+   * - `file://` — read from the local filesystem
+   * - any other string — treated as a filesystem path (e.g. `./music/track.webm`)
+   *
+   * You can also pass a Node.js Readable stream. Demuxes with prism-media WebmDemuxer; no FFmpeg;
+   * input must be WebM with Opus.
    */
   async play(urlOrStream) {
     this.stop();
     let inputStream;
     if (typeof urlOrStream === "string") {
       try {
-        const response = await fetch(urlOrStream);
-        if (!response.ok) {
-          throw new FluxerError(`HTTP ${response.status}`, { code: ErrorCodes.VoiceHttpError });
-        }
-        if (!response.body) {
-          throw new FluxerError("No response body", { code: ErrorCodes.VoiceNoResponseBody });
+        const spec = urlOrStream.trim();
+        const lower = spec.toLowerCase();
+        if (lower.startsWith("http://") || lower.startsWith("https://")) {
+          const response = await fetch(spec);
+          if (!response.ok) {
+            throw new FluxerError(`HTTP ${response.status}`, { code: ErrorCodes.VoiceHttpError });
+          }
+          if (!response.body) {
+            throw new FluxerError("No response body", { code: ErrorCodes.VoiceNoResponseBody });
+          }
+          inputStream = Readable.fromWeb(response.body);
+        } else if (lower.startsWith("file:")) {
+          inputStream = createReadStream(fileURLToPath(new URL(spec)));
+        } else {
+          inputStream = createReadStream(spec);
         }
-        inputStream = Readable.fromWeb(response.body);
       } catch (e) {
         const err = e instanceof FluxerError ? e : new FluxerError(e instanceof Error ? e.message : String(e), {
           code: ErrorCodes.FileFetchFailed,
@@ -478,7 +493,9 @@ function concatUint8Arrays(a, b) {
 }
 
 // src/LiveKitRtcConnection.ts
+import { createReadStream as createReadStream2 } from "fs";
 import { Readable as Readable2 } from "stream";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { OpusDecoder } from "opus-decoder";
 import { opus as opus2 } from "prism-media";
 import { promisify } from "util";
@@ -1672,10 +1689,13 @@ var LiveKitRtcConnection = class extends EventEmitter2 {
     runFFmpeg().catch((e) => this.audioDebug("ffmpeg error", { error: String(e) }));
   }
   /**
-   * Play audio from a WebM/Opus URL or readable stream. Publishes to the LiveKit room as an audio track.
+   * Play audio from a WebM/Opus source. Publishes to the LiveKit room as an audio track.
+   *
+   * When `urlOrStream` is a string: `http(s)://` is fetched; `file://` or any other string is read
+   * from the local filesystem (path). Otherwise pass a Node.js ReadableStream.
    *
-   * @param urlOrStream - Audio source: HTTP(S) URL to a WebM/Opus file, or a Node.js ReadableStream
-   * @emits error - On fetch failure or decode errors
+   * @param urlOrStream - WebM/Opus HTTP(S) URL, `file://` URL, filesystem path, or ReadableStream
+   * @emits error - On fetch/read failure or decode errors
    */
   async play(urlOrStream) {
     this.stop();
@@ -1686,14 +1706,22 @@ var LiveKitRtcConnection = class extends EventEmitter2 {
     let inputStream;
     if (typeof urlOrStream === "string") {
       try {
-        const response = await fetch(urlOrStream);
-        if (!response.ok) {
-          throw new FluxerError2(`HTTP ${response.status}`, { code: ErrorCodes2.VoiceHttpError });
-        }
-        if (!response.body) {
-          throw new FluxerError2("No response body", { code: ErrorCodes2.VoiceNoResponseBody });
+        const spec = urlOrStream.trim();
+        const lower = spec.toLowerCase();
+        if (lower.startsWith("http://") || lower.startsWith("https://")) {
+          const response = await fetch(spec);
+          if (!response.ok) {
+            throw new FluxerError2(`HTTP ${response.status}`, { code: ErrorCodes2.VoiceHttpError });
+          }
+          if (!response.body) {
+            throw new FluxerError2("No response body", { code: ErrorCodes2.VoiceNoResponseBody });
+          }
+          inputStream = Readable2.fromWeb(response.body);
+        } else if (lower.startsWith("file:")) {
+          inputStream = createReadStream2(fileURLToPath2(new URL(spec)));
+        } else {
+          inputStream = createReadStream2(spec);
         }
-        inputStream = Readable2.fromWeb(response.body);
       } catch (e) {
         const err = e instanceof FluxerError2 ? e : new FluxerError2(e instanceof Error ? e.message : String(e), {
           code: ErrorCodes2.FileFetchFailed,

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Voice support for Fluxer bots",
   "repository": {
     "type": "git",
@@ -39,10 +39,10 @@
     "prism-media": "^1.3.5",
     "tweetnacl": "^1.0.3",
     "ws": "^8.18.0",
-    "@fluxerjs/collection": "1.3.0",
-    "@fluxerjs/core": "1.3.0",
-    "@fluxerjs/util": "1.3.0",
-    "@fluxerjs/types": "1.3.0"
+    "@fluxerjs/collection": "1.3.1",
+    "@fluxerjs/core": "1.3.1",
+    "@fluxerjs/types": "1.3.1",
+    "@fluxerjs/util": "1.3.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",