speechflow 2.2.1 → 2.3.1

package/speechflow-cli/src/speechflow-node-xio-device.ts

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -116,7 +116,8 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
 
         /*  convert regular stream into object-mode stream  */
         const wrapper1 = util.createTransformStreamForWritableSide("audio", 1)
-        const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero, highwaterMark)
+        const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero, highwaterMark,
+            this.config.audioSampleRate, this.config.audioBitDepth, this.config.audioChannels)
         this.stream = Stream.compose(wrapper1, this.stream, wrapper2)
     }
 
@@ -137,7 +138,8 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
         this.stream = this.io as unknown as Stream.Readable
 
         /*  convert regular stream into object-mode stream  */
-        const wrapper = util.createTransformStreamForReadableSide("audio", () => this.timeZero, highwaterMark)
+        const wrapper = util.createTransformStreamForReadableSide("audio", () => this.timeZero, highwaterMark,
+            this.config.audioSampleRate, this.config.audioBitDepth, this.config.audioChannels)
         this.stream = Stream.compose(this.stream, wrapper)
     }
 
@@ -207,24 +209,36 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
                 if (!error.message.match(/AudioIO Quit expects 1 argument/))
                     throw error
             }
+            const ac1 = new AbortController()
             await Promise.race([
-                util.timeout(2 * 1000, "PortAudio abort timeout"),
+                util.timeout(2 * 1000, "PortAudio abort timeout", ac1.signal),
                 new Promise<void>((resolve) => {
                     this.io!.abort(() => {
                         resolve()
                     })
                 }).catch(catchHandler)
-            ])
+            ]).finally(() => {
+                ac1.abort()
+            })
+            const ac2 = new AbortController()
             await Promise.race([
-                util.timeout(2 * 1000, "PortAudio quit timeout"),
+                util.timeout(2 * 1000, "PortAudio quit timeout", ac2.signal),
                 new Promise<void>((resolve) => {
                     this.io!.quit(() => {
                         resolve()
                     })
                 }).catch(catchHandler)
-            ])
+            ]).finally(() => {
+                ac2.abort()
+            })
             this.io = null
         }
+
+        /*  shutdown stream  */
+        if (this.stream !== null) {
+            await util.destroyStream(this.stream)
+            this.stream = null
+        }
     }
 }
 

package/speechflow-cli/src/speechflow-node-xio-exec.ts

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -96,7 +96,7 @@ export default class SpeechFlowNodeXIOExec extends SpeechFlowNode {
         this.subprocess.on("error", (err) => {
             this.log("error", `subprocess error: ${err.message}`)
             this.emit("error", err)
-            if (this.stream !== null)
+            if (this.stream !== null && !this.stream.destroyed)
                 this.stream.emit("error", err)
         })
 
@@ -129,13 +129,15 @@ export default class SpeechFlowNodeXIOExec extends SpeechFlowNode {
             })
             const wrapper1 = util.createTransformStreamForWritableSide(this.params.type, highWaterMark)
             const wrapper2 = util.createTransformStreamForReadableSide(
-                this.params.type, () => this.timeZero, highWaterMark)
+                this.params.type, () => this.timeZero, highWaterMark,
+                this.config.audioSampleRate, this.config.audioBitDepth, this.config.audioChannels)
             this.stream = Stream.compose(wrapper1, this.stream, wrapper2)
         }
         else if (this.params.mode === "r") {
             /*  read-only mode: stdout only  */
             const wrapper = util.createTransformStreamForReadableSide(
-                this.params.type, () => this.timeZero, highWaterMark)
+                this.params.type, () => this.timeZero, highWaterMark,
+                this.config.audioSampleRate, this.config.audioBitDepth, this.config.audioChannels)
             this.stream = Stream.compose(this.subprocess.stdout!, wrapper)
         }
         else if (this.params.mode === "w") {
@@ -153,6 +155,7 @@ export default class SpeechFlowNodeXIOExec extends SpeechFlowNode {
             /*  gracefully end stdin if in write or read/write mode  */
             if ((this.params.mode === "w" || this.params.mode === "rw") && this.subprocess.stdin
                 && !this.subprocess.stdin.destroyed && !this.subprocess.stdin.writableEnded) {
+                const ac1 = new AbortController()
                 await Promise.race([
                     new Promise<void>((resolve, reject) => {
                         this.subprocess!.stdin!.end((err?: Error) => {
@@ -160,44 +163,55 @@ export default class SpeechFlowNodeXIOExec extends SpeechFlowNode {
                             else     resolve()
                         })
                     }),
-                    util.timeout(2000)
-                ]).catch((err: unknown) => {
+                    util.timeout(2000, "timeout", ac1.signal)
+                ]).finally(() => {
+                    ac1.abort()
+                }).catch((err: unknown) => {
                     const error = util.ensureError(err)
                     this.log("warning", `failed to gracefully close stdin: ${error.message}`)
                 })
             }
 
+            /*  remove event listeners to prevent errors during kill sequence  */
+            this.subprocess.removeAllListeners("error")
+            this.subprocess.removeAllListeners("exit")
+
             /*  wait for subprocess to exit gracefully  */
+            const ac2 = new AbortController()
             await Promise.race([
                 this.subprocess,
-                util.timeout(5000, "subprocess exit timeout")
-            ]).catch(async (err: unknown) => {
+                util.timeout(5000, "subprocess exit timeout", ac2.signal)
+            ]).finally(() => {
+                ac2.abort()
+            }).catch(async (err: unknown) => {
                 /*  force kill with SIGTERM  */
                 const error = util.ensureError(err)
                 if (error.message.includes("timeout")) {
                     this.log("warning", "subprocess did not exit gracefully, forcing termination")
                     this.subprocess!.kill("SIGTERM")
+                    const ac3 = new AbortController()
                     return Promise.race([
                         this.subprocess,
-                        util.timeout(2000)
-                    ])
+                        util.timeout(2000, "timeout", ac3.signal)
+                    ]).finally(() => {
+                        ac3.abort()
+                    })
                 }
             }).catch(async () => {
                 /*  force kill with SIGKILL  */
                 this.log("warning", "subprocess did not respond to SIGTERM, forcing SIGKILL")
                 this.subprocess!.kill("SIGKILL")
+                const ac4 = new AbortController()
                 return Promise.race([
                     this.subprocess,
-                    util.timeout(1000)
-                ])
+                    util.timeout(1000, "timeout", ac4.signal)
+                ]).finally(() => {
+                    ac4.abort()
+                })
             }).catch(() => {
                 this.log("error", "subprocess did not terminate even after SIGKILL")
             })
 
-            /*  remove event listeners to prevent memory leaks  */
-            this.subprocess.removeAllListeners("error")
-            this.subprocess.removeAllListeners("exit")
-
             /*  clear subprocess reference  */
             this.subprocess = null
         }

package/speechflow-cli/src/speechflow-node-xio-file.ts

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -96,7 +96,8 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                     chunker = new Stream.PassThrough({ highWaterMark: highWaterMarkText })
                 }
                 const wrapper = util.createTransformStreamForReadableSide(
-                    this.params.type, () => this.timeZero)
+                    this.params.type, () => this.timeZero, undefined,
+                    this.config.audioSampleRate, this.config.audioBitDepth, this.config.audioChannels)
                 this.stream = Stream.compose(process.stdin, chunker, wrapper)
             }
             else {
@@ -109,7 +110,8 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                     readable = fs.createReadStream(this.params.path,
                         { highWaterMark: highWaterMarkText, encoding: this.config.textEncoding })
                 const wrapper = util.createTransformStreamForReadableSide(
-                    this.params.type, () => this.timeZero)
+                    this.params.type, () => this.timeZero, undefined,
+                    this.config.audioSampleRate, this.config.audioBitDepth, this.config.audioChannels)
                 this.stream = Stream.compose(readable, wrapper)
             }
         }
@@ -158,8 +160,9 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                         },
                         destroy (err, callback) {
                             if (self.fd !== null) {
-                                fs.close(self.fd, () => {
-                                    self.fd = null
+                                const fd = self.fd
+                                self.fd = null
+                                fs.close(fd, () => {
                                     callback(err)
                                 })
                             }
@@ -199,6 +202,7 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                 const stream = this.stream
                 if ((stream instanceof Stream.Writable || stream instanceof Stream.Duplex)
                     && (!stream.writableEnded && !stream.destroyed)) {
+                    const ac = new AbortController()
                     await Promise.race([
                         new Promise<void>((resolve, reject) => {
                             stream.end((err?: Error) => {
@@ -208,8 +212,12 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                                     resolve()
                             })
                         }),
-                        util.timeout(5000)
-                    ])
+                        util.timeout(5000, "timeout", ac.signal)
+                    ]).finally(() => {
+                        ac.abort()
+                    }).catch(() => {
+                        /*  ignore timeout -- stdio stream cannot be destroyed  */
+                    })
                 }
             }
             this.stream = null

package/speechflow-cli/src/speechflow-node-xio-mqtt.ts

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -23,7 +23,7 @@ export default class SpeechFlowNodeXIOMQTT extends SpeechFlowNode {
     /*  internal state  */
     private broker:     MQTT.MqttClient | null                   = null
     private clientId:   string                                   = (new UUID(1)).format()
-    private chunkQueue: util.SingleQueue<SpeechFlowChunk> | null = null
+    private chunkQueue: util.AsyncQueue<SpeechFlowChunk> | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -100,13 +100,15 @@ export default class SpeechFlowNodeXIOMQTT extends SpeechFlowNode {
             const reasonCode = packet.reasonCode ?? 0
             this.log("info", `connection closed to MQTT ${this.params.url} (reason code: ${reasonCode})`)
         })
-        this.chunkQueue = new util.SingleQueue<SpeechFlowChunk>()
+        this.chunkQueue = new util.AsyncQueue<SpeechFlowChunk>()
         this.broker.on("message", (topic: string, payload: Buffer, packet: MQTT.IPublishPacket) => {
             if (topic !== this.params.topicRead || this.params.mode === "w")
                 return
+            if (this.chunkQueue === null)
+                return
             try {
                 const chunk = util.streamChunkDecode(payload)
-                this.chunkQueue!.write(chunk)
+                this.chunkQueue.write(chunk)
             }
             catch (_err: unknown) {
                 this.log("warning", `received invalid CBOR chunk from MQTT ${this.params.url}`)
@@ -141,12 +143,20 @@ export default class SpeechFlowNodeXIOMQTT extends SpeechFlowNode {
                 callback()
             },
             read (size: number) {
-                if (self.params.mode === "w")
-                    throw new Error("read operation on write-only node")
-                reads.add(self.chunkQueue!.read().then((chunk) => {
+                if (self.params.mode === "w") {
+                    self.log("error", "read operation on write-only node")
+                    this.push(null)
+                    return
+                }
+                if (self.chunkQueue === null)
+                    return
+                const queue = self.chunkQueue
+                reads.add(queue.read().then((chunk) => {
                     this.push(chunk, "binary")
                 }).catch((err: Error) => {
                     self.log("warning", `read on chunk queue operation failed: ${err}`)
+                    if (queue.destroyed)
+                        this.push(null)
                 }))
             }
         })
@@ -154,14 +164,10 @@ export default class SpeechFlowNodeXIOMQTT extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  clear chunk queue reference  */
-        this.chunkQueue = null
-
-        /*  close MQTT broker  */
-        if (this.broker !== null) {
-            if (this.broker.connected)
-                this.broker.end()
-            this.broker = null
+        /*  drain and clear chunk queue reference  */
+        if (this.chunkQueue !== null) {
+            this.chunkQueue.destroy()
+            this.chunkQueue = null
         }
 
         /*  shutdown stream  */
@@ -169,5 +175,12 @@ export default class SpeechFlowNodeXIOMQTT extends SpeechFlowNode {
             await util.destroyStream(this.stream)
             this.stream = null
         }
+
+        /*  close MQTT broker  */
+        if (this.broker !== null) {
+            if (this.broker.connected)
+                this.broker.end()
+            this.broker = null
+        }
     }
 }

package/speechflow-cli/src/speechflow-node-xio-vban.ts

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -32,7 +32,7 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
 
     /*  internal state  */
     private server:        VBANServer                        | null = null
-    private chunkQueue:    util.SingleQueue<SpeechFlowChunk> | null = null
+    private chunkQueue:    util.AsyncQueue<SpeechFlowChunk> | null = null
     private frameCounter                                            = 0
     private targetAddress                                           = ""
     private targetPort                                              = 0
@@ -99,7 +99,7 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
         })
 
         /*  setup chunk queue for incoming audio  */
-        this.chunkQueue = new util.SingleQueue<SpeechFlowChunk>()
+        this.chunkQueue = new util.AsyncQueue<SpeechFlowChunk>()
 
         /*  determine target for sending  */
         if (this.params.connect !== "") {
@@ -128,6 +128,12 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
             }
             const data = packet.data
 
+            /*  check sample rate compatibility  */
+            if (packet.sr !== this.config.audioSampleRate) {
+                this.log("warning", `incompatible VBAN sample rate: packet=${packet.sr}Hz, configured=${this.config.audioSampleRate}Hz`)
+                return
+            }
+
             /*  convert audio format if necessary  */
             let audioBuffer: Buffer
             const bitResolution = packet.bitResolution
@@ -139,7 +145,7 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
                 /*  8-bit unsigned to 16-bit signed  */
                 audioBuffer = Buffer.alloc(data.length * 2)
                 for (let i = 0; i < data.length; i++) {
-                    const sample = ((data[i] - 128) / 128) * 32767
+                    const sample = ((data[i] - 128) / 128) * 32768
                     audioBuffer.writeInt16LE(Math.round(sample), i * 2)
                 }
             }
@@ -153,7 +159,7 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
                     const b2 = data[i * 3 + 2]
                     const value = ((b2 << 16) | (b1 << 8) | b0) & 0xFFFFFF
                     const signed = value > 0x7FFFFF ? value - 0x1000000 : value
-                    const sample = (signed / 0x800000) * 32767
+                    const sample = (signed / 0x800000) * 32768
                     audioBuffer.writeInt16LE(Math.round(sample), i * 2)
                 }
             }
@@ -163,7 +169,7 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
                 audioBuffer = Buffer.alloc(samples * 2)
                 for (let i = 0; i < samples; i++) {
                     const value = data.readInt32LE(i * 4)
-                    const sample = (value / 0x80000000) * 32767
+                    const sample = (value / 0x80000000) * 32768
                     audioBuffer.writeInt16LE(Math.round(sample), i * 2)
                 }
             }
@@ -173,7 +179,7 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
                 audioBuffer = Buffer.alloc(samples * 2)
                 for (let i = 0; i < samples; i++) {
                     const value = data.readFloatLE(i * 4)
-                    const sample = Math.max(-32768, Math.min(32767, Math.round(value * 32767)))
+                    const sample = Math.max(-32768, Math.min(32767, Math.round(value * 32768)))
                     audioBuffer.writeInt16LE(sample, i * 2)
                 }
             }
@@ -183,7 +189,7 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
                 audioBuffer = Buffer.alloc(samples * 2)
                 for (let i = 0; i < samples; i++) {
                     const value = data.readDoubleLE(i * 8)
-                    const sample = Math.max(-32768, Math.min(32767, Math.round(value * 32767)))
+                    const sample = Math.max(-32768, Math.min(32767, Math.round(value * 32768)))
                     audioBuffer.writeInt16LE(sample, i * 2)
                 }
             }
@@ -227,11 +233,11 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
         /*  bind to listen port  */
         if (this.params.listen !== "") {
             const listen = this.parseAddress(this.params.listen, 6980)
-            this.server.bind(listen.port, listen.host)
+            await this.server.bind(listen.port, listen.host)
         }
         else
             /*  still need to bind for sending  */
-            this.server.bind(0)
+            await this.server.bind(0)
 
         /*  create duplex stream  */
         const self = this
@@ -279,7 +285,7 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
                     nbChannel:     self.config.audioChannels - 1,
                     bitResolution: EBitsResolutions.VBAN_DATATYPE_INT16,
                     codec:         ECodecs.VBAN_CODEC_PCM,
-                    frameCounter:  self.frameCounter++
+                    frameCounter:  self.frameCounter++ & 0xFFFFFFFF
                 }, audioBuffer)
 
                 /*  send packet  */
@@ -292,13 +298,20 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
                 callback()
             },
             read (size: number) {
-                if (self.params.mode === "w")
-                    throw new Error("read operation on write-only node")
-                reads.add(self.chunkQueue!.read().then((chunk) => {
+                if (self.params.mode === "w") {
+                    self.log("error", "read operation on write-only node")
+                    this.push(null)
+                    return
+                }
+                if (self.chunkQueue === null)
+                    return
+                const queue = self.chunkQueue
+                reads.add(queue.read().then((chunk) => {
                     this.push(chunk, "binary")
                 }).catch((err: Error) => {
                     self.log("warning", `read on chunk queue operation failed: ${err}`)
-                    this.push(null)
+                    if (queue.destroyed)
+                        this.push(null)
                 }))
             }
         })
@@ -308,20 +321,20 @@ export default class SpeechFlowNodeXIOVBAN extends SpeechFlowNode {
     async close () {
         /*  drain and clear chunk queue reference  */
         if (this.chunkQueue !== null) {
-            this.chunkQueue.drain()
+            this.chunkQueue.destroy()
             this.chunkQueue = null
         }
 
-        /*  close VBAN server  */
-        if (this.server !== null) {
-            this.server.close()
-            this.server = null
-        }
-
         /*  shutdown stream  */
         if (this.stream !== null) {
             await util.destroyStream(this.stream)
             this.stream = null
         }
+
+        /*  close VBAN server  */
+        if (this.server !== null) {
+            await this.server.close()
+            this.server = null
+        }
     }
 }