@fluxerjs/voice 1.2.4 → 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

@@ -49,10 +49,13 @@ var thumbnail = MINIMAL_PNG_BASE64;
 
 // src/VoiceConnection.ts
 var import_events = require("events");
+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,
@@ -210,8 +213,11 @@ var VoiceConnection = class extends import_events.EventEmitter {
   async getWebSocketConstructor() {
     try {
       return ws.default;
-    } catch {
-      throw new Error('Install "ws" for voice support: pnpm add ws');
+    } catch (err) {
+      throw new import_util.FluxerError('Install "ws" for voice support: pnpm add ws', {
+        code: import_util.ErrorCodes.VoiceWebSocketRequired,
+        cause: err instanceof Error ? err : void 0
+      });
     }
   }
   sendVoiceOp(op, d) {
@@ -253,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();
@@ -289,20 +295,40 @@ 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 Error(`HTTP ${response.status}`);
-        if (!response.body) throw new Error("No response body");
-        inputStream = import_node_stream.Readable.fromWeb(response.body);
+        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);
+        }
       } catch (e) {
-        const err = e instanceof Error ? e : new Error(String(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,
+          cause: e instanceof Error ? e : void 0
+        });
         this.emit("error", err);
         return;
       }
@@ -404,6 +430,7 @@ var VoiceConnection = class extends import_events.EventEmitter {
 // src/LiveKitRtcConnection.ts
 var import_node_child_process = require("child_process");
 var import_events2 = require("events");
+var import_util2 = require("@fluxerjs/util");
 var import_rtc_node = require("@livekit/rtc-node");
 
 // src/livekit.ts
@@ -492,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");
@@ -911,11 +940,17 @@ var LiveKitRtcConnection = class extends import_events2.EventEmitter {
     if (typeof urlOrBuffer === "string") {
       try {
         const response = await fetch(urlOrBuffer);
-        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+        if (!response.ok) {
+          throw new import_util2.FluxerError(`HTTP ${response.status}`, { code: import_util2.ErrorCodes.VoiceHttpError });
+        }
         const buf = await response.arrayBuffer();
         arrayBuffer = buf;
       } catch (e) {
-        this.emit("error", e instanceof Error ? e : new Error(String(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,
+          cause: e instanceof Error ? e : void 0
+        });
+        this.emit("error", err);
         return;
       }
     } else if (urlOrBuffer instanceof Uint8Array) {
@@ -1680,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();
@@ -1694,12 +1732,28 @@ var LiveKitRtcConnection = class extends import_events2.EventEmitter {
     let inputStream;
     if (typeof urlOrStream === "string") {
       try {
-        const response = await fetch(urlOrStream);
-        if (!response.ok) throw new Error(`HTTP ${response.status}`);
-        if (!response.body) throw new Error("No response body");
-        inputStream = import_node_stream2.Readable.fromWeb(response.body);
+        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);
+        }
       } catch (e) {
-        this.emit("error", e instanceof Error ? e : new Error(String(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,
+          cause: e instanceof Error ? e : void 0
+        });
+        this.emit("error", err);
         return;
       }
     } else {

package/dist/index.mjs

@@ -9,10 +9,13 @@ var thumbnail = MINIMAL_PNG_BASE64;
 
 // src/VoiceConnection.ts
 import { EventEmitter } from "events";
+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,
@@ -170,8 +173,11 @@ var VoiceConnection = class extends EventEmitter {
   async getWebSocketConstructor() {
     try {
       return ws.default;
-    } catch {
-      throw new Error('Install "ws" for voice support: pnpm add ws');
+    } catch (err) {
+      throw new FluxerError('Install "ws" for voice support: pnpm add ws', {
+        code: ErrorCodes.VoiceWebSocketRequired,
+        cause: err instanceof Error ? err : void 0
+      });
     }
   }
   sendVoiceOp(op, d) {
@@ -213,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();
@@ -249,20 +255,40 @@ 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 Error(`HTTP ${response.status}`);
-        if (!response.body) throw new Error("No response body");
-        inputStream = Readable.fromWeb(response.body);
+        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);
+        }
       } catch (e) {
-        const err = e instanceof Error ? e : new Error(String(e));
+        const err = e instanceof FluxerError ? e : new FluxerError(e instanceof Error ? e.message : String(e), {
+          code: ErrorCodes.FileFetchFailed,
+          cause: e instanceof Error ? e : void 0
+        });
         this.emit("error", err);
         return;
       }
@@ -364,6 +390,7 @@ var VoiceConnection = class extends EventEmitter {
 // src/LiveKitRtcConnection.ts
 import { execFile, spawn } from "child_process";
 import { EventEmitter as EventEmitter2 } from "events";
+import { ErrorCodes as ErrorCodes2, FluxerError as FluxerError2 } from "@fluxerjs/util";
 import {
   AudioStream,
   Room,
@@ -466,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";
@@ -885,11 +914,17 @@ var LiveKitRtcConnection = class extends EventEmitter2 {
     if (typeof urlOrBuffer === "string") {
       try {
         const response = await fetch(urlOrBuffer);
-        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+        if (!response.ok) {
+          throw new FluxerError2(`HTTP ${response.status}`, { code: ErrorCodes2.VoiceHttpError });
+        }
         const buf = await response.arrayBuffer();
         arrayBuffer = buf;
       } catch (e) {
-        this.emit("error", e instanceof Error ? e : new Error(String(e)));
+        const err = e instanceof FluxerError2 ? e : new FluxerError2(e instanceof Error ? e.message : String(e), {
+          code: ErrorCodes2.FileFetchFailed,
+          cause: e instanceof Error ? e : void 0
+        });
+        this.emit("error", err);
         return;
       }
     } else if (urlOrBuffer instanceof Uint8Array) {
@@ -1654,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();
@@ -1668,12 +1706,28 @@ var LiveKitRtcConnection = class extends EventEmitter2 {
     let inputStream;
     if (typeof urlOrStream === "string") {
       try {
-        const response = await fetch(urlOrStream);
-        if (!response.ok) throw new Error(`HTTP ${response.status}`);
-        if (!response.body) throw new Error("No response body");
-        inputStream = Readable2.fromWeb(response.body);
+        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);
+        }
       } catch (e) {
-        this.emit("error", e instanceof Error ? e : new Error(String(e)));
+        const err = e instanceof FluxerError2 ? e : new FluxerError2(e instanceof Error ? e.message : String(e), {
+          code: ErrorCodes2.FileFetchFailed,
+          cause: e instanceof Error ? e : void 0
+        });
+        this.emit("error", err);
         return;
       }
     } else {

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.2.4",
+  "version": "1.3.1",
   "description": "Voice support for Fluxer bots",
   "repository": {
     "type": "git",
@@ -39,9 +39,10 @@
     "prism-media": "^1.3.5",
     "tweetnacl": "^1.0.3",
     "ws": "^8.18.0",
-    "@fluxerjs/collection": "1.2.4",
-    "@fluxerjs/core": "1.2.4",
-    "@fluxerjs/types": "1.2.4"
+    "@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",