@fonoster/streams 0.15.17 → 0.16.0

package/dist/AudioPlayer.d.ts

@@ -0,0 +1,37 @@
+import * as net from "net";
+import { Readable } from "stream";
+/**
+ * @classdesc Object representing an audio player that can play audio files and streams.
+ */
+export declare class AudioPlayer {
+    private activeStream;
+    private socket;
+    private isPlaying;
+    /**
+     * Creates a new AudioPlayer.
+     *
+     * @param {net.Socket} socket - A TCP socket for writing audio data
+     */
+    constructor(socket: net.Socket);
+    /**
+     * Utility for playing audio files.
+     *
+     * @param {string} filePath - The path to the audio file
+     * @return {Promise<void>}
+     */
+    play(filePath: string): Promise<void>;
+    /**
+     * Plays audio from an input stream and returns an output stream.
+     * The playback can be stopped using stopPlayStream().
+     *
+     * @param {Readable} inputStream - The input stream to read audio from
+     * @return {Promise<void>}
+     */
+    playStream(inputStream: Readable): Promise<void>;
+    /**
+     * Stops the current stream playback.
+     */
+    stop(): void;
+    private _processAudioChunk;
+    private _cleanupActiveStream;
+}

package/dist/AudioPlayer.js

@@ -0,0 +1,182 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AudioPlayer = void 0;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const fs = __importStar(require("fs"));
+const promises_1 = require("node:timers/promises");
+const logger_1 = require("@fonoster/logger");
+const Message_1 = require("./Message");
+const logger = (0, logger_1.getLogger)({ service: "streams", filePath: __filename });
+const MAX_CHUNK_SIZE = 320;
+/**
+ * @classdesc Object representing an audio player that can play audio files and streams.
+ */
+class AudioPlayer {
+    /**
+     * Creates a new AudioPlayer.
+     *
+     * @param {net.Socket} socket - A TCP socket for writing audio data
+     */
+    constructor(socket) {
+        this.activeStream = null;
+        this.isPlaying = false;
+        this.socket = socket;
+    }
+    /**
+     * Utility for playing audio files.
+     *
+     * @param {string} filePath - The path to the audio file
+     * @return {Promise<void>}
+     */
+    play(filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const fileStream = fs.readFileSync(filePath);
+            logger.verbose("playing audio file", { filePath });
+            let offset = 0;
+            // eslint-disable-next-line no-loops/no-loops
+            while (offset < fileStream.length) {
+                const sliceSize = Math.min(fileStream.length - offset, MAX_CHUNK_SIZE);
+                const slicedChunk = fileStream.subarray(offset, offset + sliceSize);
+                yield this._processAudioChunk(slicedChunk);
+                offset += sliceSize;
+            }
+        });
+    }
+    /**
+     * Plays audio from an input stream and returns an output stream.
+     * The playback can be stopped using stopPlayStream().
+     *
+     * @param {Readable} inputStream - The input stream to read audio from
+     * @return {Promise<void>}
+     */
+    playStream(inputStream) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.isPlaying = true;
+            this.activeStream = inputStream;
+            const buffer = [];
+            let isProcessing = false;
+            const processBuffer = () => __awaiter(this, void 0, void 0, function* () {
+                if (!this.isPlaying || isProcessing || buffer.length === 0)
+                    return;
+                isProcessing = true;
+                try {
+                    while (buffer.length > 0 && this.isPlaying) {
+                        const chunk = buffer.shift();
+                        yield this._processAudioChunk(chunk);
+                    }
+                }
+                finally {
+                    isProcessing = false;
+                }
+            });
+            return new Promise((resolve, reject) => {
+                inputStream.on("data", (chunk) => __awaiter(this, void 0, void 0, function* () {
+                    if (!this.isPlaying || this.activeStream !== inputStream)
+                        return;
+                    for (let offset = 0; offset < chunk.length; offset += MAX_CHUNK_SIZE) {
+                        const sliceSize = Math.min(chunk.length - offset, MAX_CHUNK_SIZE);
+                        const slicedChunk = chunk.subarray(offset, offset + sliceSize);
+                        buffer.push(slicedChunk);
+                    }
+                    if (!isProcessing) {
+                        yield processBuffer();
+                        resolve();
+                    }
+                }));
+                inputStream.on("error", (err) => {
+                    logger.error("error playing stream", err);
+                    this._cleanupActiveStream();
+                    reject(err);
+                });
+                inputStream.on("end", () => {
+                    this._cleanupActiveStream();
+                });
+            });
+        });
+    }
+    /**
+     * Stops the current stream playback.
+     */
+    stop() {
+        this.isPlaying = false;
+        this._cleanupActiveStream();
+    }
+    _processAudioChunk(chunk) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const buffer = Message_1.Message.createSlinMessage(chunk);
+            this.socket.write(buffer);
+            yield (0, promises_1.setTimeout)(20);
+        });
+    }
+    _cleanupActiveStream() {
+        if (this.activeStream) {
+            this.activeStream.removeAllListeners("data");
+            this.activeStream.removeAllListeners("error");
+            this.activeStream.removeAllListeners("end");
+            if (typeof this.activeStream.pause === "function") {
+                this.activeStream.pause();
+            }
+            this.activeStream = null;
+        }
+    }
+}
+exports.AudioPlayer = AudioPlayer;

package/dist/AudioStream.d.ts

@@ -1,9 +1,28 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 import * as net from "net";
 import { Readable } from "stream";
 /**
  * @classdesc Object representing a stream of bidirectional audio data and control messages.
  */
 declare class AudioStream {
+    private player;
     private stream;
     private socket;
     /**
@@ -30,6 +49,18 @@ declare class AudioStream {
      * @return {Promise<void>}
      */
     play(filePath: string): Promise<void>;
+    /**
+     * Plays audio from an input stream and returns an output stream.
+     * The playback can be stopped using stopPlayStream().
+     *
+     * @param {Readable} inputStream - The input stream to read audio from
+     * @return {Promise<void>}
+     */
+    playStream(inputStream: Readable): Promise<void>;
+    /**
+     * Stops the current stream playback.
+     */
+    stop(): void;
     /**
      * Adds a listener for the data event.
      *

package/dist/AudioStream.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -43,29 +10,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AudioStream = void 0;
-/**
- * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
- * http://github.com/fonoster/fonoster
- *
- * This file is part of Fonoster
- *
- * Licensed under the MIT License (the "License");
- * you may not use this file except in compliance with
- * the License. You may obtain a copy of the License at
- *
- *    https://opensource.org/licenses/MIT
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-const fs = __importStar(require("fs"));
-const promises_1 = require("node:timers/promises");
+const AudioPlayer_1 = require("./AudioPlayer");
 const Message_1 = require("./Message");
 const types_1 = require("./types");
-const MAX_CHUNK_SIZE = 320;
 /**
  * @classdesc Object representing a stream of bidirectional audio data and control messages.
  */
@@ -79,6 +26,7 @@ class AudioStream {
     constructor(stream, socket) {
         this.stream = stream;
         this.socket = socket;
+        this.player = new AudioPlayer_1.AudioPlayer(socket);
     }
     /**
      * Writes media data to the stream.
@@ -106,20 +54,27 @@ class AudioStream {
      */
     play(filePath) {
         return __awaiter(this, void 0, void 0, function* () {
-            const fileStream = fs.readFileSync(filePath);
-            let offset = 0;
-            // eslint-disable-next-line no-loops/no-loops
-            while (offset < fileStream.length) {
-                const sliceSize = Math.min(fileStream.length - offset, MAX_CHUNK_SIZE);
-                const slicedChunk = fileStream.subarray(offset, offset + sliceSize);
-                const buffer = Message_1.Message.createSlinMessage(slicedChunk);
-                this.socket.write(buffer);
-                offset += sliceSize;
-                // Wait for 20ms to match the sample rate
-                yield (0, promises_1.setTimeout)(20);
-            }
+            return this.player.play(filePath);
         });
     }
+    /**
+     * Plays audio from an input stream and returns an output stream.
+     * The playback can be stopped using stopPlayStream().
+     *
+     * @param {Readable} inputStream - The input stream to read audio from
+     * @return {Promise<void>}
+     */
+    playStream(inputStream) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.player.playStream(inputStream);
+        });
+    }
+    /**
+     * Stops the current stream playback.
+     */
+    stop() {
+        this.player.stop();
+    }
     /**
      * Adds a listener for the data event.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/streams",
-  "version": "0.15.17",
+  "version": "0.16.0",
   "description": "Core support for Fonoster Streams",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -18,7 +18,7 @@
     "generate:readme": "node ../../.scripts/gen-readme.cjs"
   },
   "dependencies": {
-    "@fonoster/logger": "^0.15.17",
+    "@fonoster/logger": "^0.16.0",
     "uuid": "^11.0.3"
   },
   "devDependencies": {
@@ -37,5 +37,5 @@
   "bugs": {
     "url": "https://github.com/fonoster/fonoster/issues"
   },
-  "gitHead": "ef6c18caadd9624f000b71c8e14ad1de0d8d946d"
+  "gitHead": "ad4212a7938ad2e219b9d1ae27a430ec60d9f841"
 }