speechflow 1.6.4 → 1.6.6

package/speechflow-cli/src/speechflow-node-t2a-amazon.ts

@@ -26,8 +26,7 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
 
     /*  internal state  */
     private client: PollyClient | null = null
-    private static speexInitialized = false
-    private destroyed = false
+    private closing = false
     private resampler: SpeexResampler | null = null
 
     /*  construct node  */
@@ -62,7 +61,7 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
     /*  open node  */
     async open () {
         /*  clear destruction flag  */
-        this.destroyed = false
+        this.closing = false
 
         /*  establish AWS Polly connection  */
         this.client = new PollyClient({
@@ -114,11 +113,6 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
 
         /*  establish resampler from AWS Polly's maximum 16Khz output
             (for PCM output) to our standard audio sample rate (48KHz)  */
-        if (!SpeechFlowNodeT2AAmazon.speexInitialized) {
-            /*  at least once initialize resampler  */
-            await SpeexResampler.initPromise
-            SpeechFlowNodeT2AAmazon.speexInitialized = true
-        }
         this.resampler = new SpeexResampler(1, 16000, this.config.audioSampleRate, 7)
 
         /*  create transform stream and connect it to the AWS Polly API  */
@@ -129,7 +123,7 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
             decodeStrings:      false,
             highWaterMark:      1,
             transform (chunk: SpeechFlowChunk, encoding, callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback(new Error("stream already destroyed"))
                     return
                 }
@@ -138,7 +132,7 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
                 else if (chunk.payload.length > 0) {
                     self.log("debug", `send data (${chunk.payload.length} bytes): "${chunk.payload}"`)
                     textToSpeech(chunk.payload as string).then((buffer) => {
-                        if (self.destroyed)
+                        if (self.closing)
                             throw new Error("stream destroyed during processing")
                         const chunkNew = chunk.clone()
                         chunkNew.type = "audio"
@@ -153,7 +147,7 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
                     callback()
             },
             final (callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback()
                     return
                 }
@@ -165,8 +159,8 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  indicate destruction  */
-        this.destroyed = true
+        /*  indicate closing  */
+        this.closing = true
 
         /*  destroy resampler  */
         if (this.resampler !== null)
@@ -177,9 +171,9 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
             this.client.destroy()
             this.client = null
         }
-        /*  destroy stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

package/speechflow-cli/src/speechflow-node-t2a-elevenlabs.ts

@@ -14,6 +14,7 @@ import SpeexResampler        from "speex-resampler"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Elevenlabs text-to-speech conversion  */
 export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
@@ -22,8 +23,7 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
 
     /*  internal state  */
     private elevenlabs: ElevenLabs.ElevenLabsClient | null = null
-    private static speexInitialized = false
-    private destroyed = false
+    private closing = false
     private resampler: SpeexResampler | null = null
 
     /*  construct node  */
@@ -68,7 +68,7 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
     /*  open node  */
     async open () {
         /*  clear destruction flag  */
-        this.destroyed = false
+        this.closing = false
 
         /*  establish ElevenLabs API connection  */
         this.elevenlabs = new ElevenLabs.ElevenLabsClient({
@@ -117,7 +117,7 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
                 modelId:          model,
                 languageCode:     this.params.language,
                 outputFormat:     `pcm_${maxSampleRate}` as ElevenLabs.ElevenLabs.OutputFormat,
-                seed:             815, /* arbitrary, but fixated by us */
+                seed:             815, /*  arbitrary, but fixated by us  */
                 voiceSettings: {
                     speed:           this.params.speed,
                     stability:       this.params.stability,
@@ -131,11 +131,6 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
 
         /*  establish resampler from ElevenLabs's maximum 24Khz
             output to our standard audio sample rate (48KHz)  */
-        if (!SpeechFlowNodeT2AElevenlabs.speexInitialized) {
-            /*  at least once initialize resampler  */
-            await SpeexResampler.initPromise
-            SpeechFlowNodeT2AElevenlabs.speexInitialized = true
-        }
         this.resampler = new SpeexResampler(1, maxSampleRate, this.config.audioSampleRate, 7)
 
         /*  create transform stream and connect it to the ElevenLabs API  */
@@ -146,7 +141,7 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
             decodeStrings:      false,
             highWaterMark:      1,
             transform (chunk: SpeechFlowChunk, encoding, callback) {
-                if (self.destroyed)
+                if (self.closing)
                     callback(new Error("stream already destroyed"))
                 else if (Buffer.isBuffer(chunk.payload))
                     callback(new Error("invalid chunk payload type"))
@@ -163,14 +158,14 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
                             }
                         }
                         try {
-                            if (self.destroyed) {
+                            if (self.closing) {
                                 clearProcessTimeout()
                                 callback(new Error("stream destroyed during processing"))
                                 return
                             }
                             const stream = await speechStream(chunk.payload as string)
                             const buffer = await getStreamAsBuffer(stream)
-                            if (self.destroyed) {
+                            if (self.closing) {
                                 clearProcessTimeout()
                                 callback(new Error("stream destroyed during processing"))
                                 return
@@ -186,13 +181,13 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
                         }
                         catch (error) {
                             clearProcessTimeout()
-                            callback(error instanceof Error ? error : new Error("ElevenLabs processing failed"))
+                            callback(util.ensureError(error, "ElevenLabs processing failed"))
                         }
                     })()
                 }
             },
             final (callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback()
                     return
                 }
@@ -204,12 +199,12 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  indicate destruction  */
-        this.destroyed = true
+        /*  indicate closing  */
+        this.closing = true
 
-        /*  destroy stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

package/speechflow-cli/src/speechflow-node-t2a-kokoro.ts

@@ -23,7 +23,6 @@ export default class SpeechFlowNodeT2AKokoro extends SpeechFlowNode {
     /*  internal state  */
     private kokoro: KokoroTTS | null = null
     private resampler: SpeexResampler | null = null
-    private static speexInitialized = false
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -82,11 +81,6 @@ export default class SpeechFlowNodeT2AKokoro extends SpeechFlowNode {
 
         /*  establish resampler from Kokoro's maximum 24Khz
             output to our standard audio sample rate (48KHz)  */
-        if (!SpeechFlowNodeT2AKokoro.speexInitialized) {
-            /*  at least once initialize resampler  */
-            SpeechFlowNodeT2AKokoro.speexInitialized = true
-            await SpeexResampler.initPromise
-        }
         this.resampler = new SpeexResampler(1, 24000, this.config.audioSampleRate, 7)
 
         /*  determine voice for text-to-speech operation  */
@@ -125,7 +119,7 @@ export default class SpeechFlowNodeT2AKokoro extends SpeechFlowNode {
         }
 
         /*  create transform stream and connect it to the Kokoro API  */
-        const log = (level: string, msg: string) => { this.log(level, msg) }
+        const self = this
         this.stream = new Stream.Transform({
             writableObjectMode: true,
             readableObjectMode: true,
@@ -136,7 +130,7 @@ export default class SpeechFlowNodeT2AKokoro extends SpeechFlowNode {
                     callback(new Error("invalid chunk payload type"))
                 else {
                     text2speech(chunk.payload).then((buffer) => {
-                        log("info", `Kokoro: received audio (buffer length: ${buffer.byteLength})`)
+                        self.log("info", `Kokoro: received audio (buffer length: ${buffer.byteLength})`)
                         chunk = chunk.clone()
                         chunk.type = "audio"
                         chunk.payload = buffer
@@ -156,9 +150,9 @@ export default class SpeechFlowNodeT2AKokoro extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  destroy stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

package/speechflow-cli/src/speechflow-node-t2t-amazon.ts

@@ -101,7 +101,7 @@ export default class SpeechFlowNodeT2TAmazon extends SpeechFlowNode {
                     await new Promise((resolve) => setTimeout(resolve, delayMs))
                 }
             }
-            throw lastError instanceof Error ? lastError : new Error(String(lastError))
+            throw util.ensureError(lastError)
         }
 
         /*  establish a duplex stream and connect it to AWS Translate  */
@@ -143,9 +143,9 @@ export default class SpeechFlowNodeT2TAmazon extends SpeechFlowNode {
             this.client = null
         }
 
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

package/speechflow-cli/src/speechflow-node-t2t-deepl.ts

@@ -108,9 +108,9 @@ export default class SpeechFlowNodeT2TDeepL extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

package/speechflow-cli/src/speechflow-node-t2t-format.ts

@@ -12,6 +12,7 @@ import wrapText from "wrap-text"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for text-to-text formatting  */
 export default class SpeechFlowNodeT2TFormat extends SpeechFlowNode {
@@ -71,9 +72,9 @@ export default class SpeechFlowNodeT2TFormat extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

package/speechflow-cli/src/speechflow-node-t2t-google.ts

@@ -118,9 +118,9 @@ export default class SpeechFlowNodeT2TGoogle extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

package/speechflow-cli/src/speechflow-node-t2t-modify.ts

@@ -26,6 +26,10 @@ export default class SpeechFlowNodeT2TModify extends SpeechFlowNode {
             replace: { type: "string", val: "" }
         })
 
+        /*  sanity check parameters  */
+        if (this.params.match === "")
+            throw new Error("match parameter cannot be empty")
+
         /*  declare node input/output format  */
         this.input  = "text"
         this.output = "text"
@@ -33,10 +37,6 @@ export default class SpeechFlowNodeT2TModify extends SpeechFlowNode {
 
     /*  open node  */
     async open () {
-        /*  validate parameters  */
-        if (this.params.match === "")
-            throw new Error("match parameter cannot be empty")
-
         /*  compile regex pattern  */
         const regex = util.run("compiling regex pattern",
             () => new RegExp(this.params.match, "g"))
@@ -75,9 +75,9 @@ export default class SpeechFlowNodeT2TModify extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

package/speechflow-cli/src/speechflow-node-t2t-ollama.ts

@@ -177,7 +177,7 @@ export default class SpeechFlowNodeT2TOllama extends SpeechFlowNode {
             models = await this.ollama.list()
         }
         catch (err) {
-            throw new Error(`failed to connect to Ollama API at ${this.params.api}: ${err}`)
+            throw new Error(`failed to connect to Ollama API at ${this.params.api}: ${err}`, { cause: err })
         }
         const exists = models.models.some((m) => m.name === this.params.model)
         if (!exists) {
@@ -266,9 +266,9 @@ export default class SpeechFlowNodeT2TOllama extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

package/speechflow-cli/src/speechflow-node-t2t-openai.ts

@@ -234,9 +234,9 @@ export default class SpeechFlowNodeT2TOpenAI extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

package/speechflow-cli/src/speechflow-node-t2t-sentence.ts

@@ -33,7 +33,7 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
     private queueRecv  = this.queue.pointerUse("recv")
     private queueSplit = this.queue.pointerUse("split")
     private queueSend  = this.queue.pointerUse("send")
-    private destroyed  = false
+    private closing  = false
     private workingOffTimer: ReturnType<typeof setTimeout> | null = null
 
     /*  construct node  */
@@ -51,12 +51,12 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
     /*  open node  */
     async open () {
         /*  clear destruction flag  */
-        this.destroyed = false
+        this.closing = false
 
         /*  work off queued text frames  */
         let workingOff = false
         const workOffQueue = async () => {
-            if (this.destroyed)
+            if (this.closing)
                 return
 
             /*  control working off round  */
@@ -70,7 +70,7 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
             this.queue.off("write", workOffQueue)
 
             /*  try to work off one or more chunks  */
-            while (!this.destroyed) {
+            while (!this.closing) {
                 const element = this.queueSplit.peek()
                 if (element === undefined)
                     break
@@ -134,7 +134,7 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
 
             /*  re-initiate working off round (if still not destroyed)  */
             workingOff = false
-            if (!this.destroyed) {
+            if (!this.closing) {
                 this.workingOffTimer = setTimeout(workOffQueue, 100)
                 this.queue.once("write", workOffQueue)
             }
@@ -151,7 +151,7 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
 
             /*  receive text chunk (writable side of stream)  */
             write (chunk: SpeechFlowChunk, encoding, callback) {
-                if (self.destroyed)
+                if (self.closing)
                     callback(new Error("stream already destroyed"))
                 else if (Buffer.isBuffer(chunk.payload))
                     callback(new Error("expected text input as string chunks"))
@@ -166,7 +166,7 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
 
             /*  receive no more text chunks (writable side of stream)  */
             final (callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback()
                     return
                 }
@@ -179,7 +179,7 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
             read (_size) {
                 /*  flush pending text chunks  */
                 const flushPendingChunks = () => {
-                    if (self.destroyed) {
+                    if (self.closing) {
                         this.push(null)
                         return
                     }
@@ -210,7 +210,7 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
                             self.queue.trim()
                         }
                     }
-                    else if (!self.destroyed)
+                    else if (!self.closing)
                         self.queue.once("write", flushPendingChunks)
                 }
                 flushPendingChunks()
@@ -220,8 +220,8 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  indicate destruction  */
-        this.destroyed = true
+        /*  indicate closing  */
+        this.closing = true
 
         /*  clean up timer  */
         if (this.workingOffTimer !== null) {
@@ -232,9 +232,9 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
         /*  remove any pending event listeners  */
         this.queue.removeAllListeners("write")
 
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

package/speechflow-cli/src/speechflow-node-t2t-subtitle.ts

@@ -20,13 +20,10 @@ import HAPIWebSocket from "hapi-plugin-websocket"
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 import * as util                           from "./speechflow-util"
 
-type wsPeerCtx = {
-    peer: string
-}
-type wsPeerInfo = {
-    ctx:        wsPeerCtx
-    ws:         WebSocket
-    req:        http.IncomingMessage
+type WSPeerInfo = {
+    ctx:  Record<string, any>
+    ws:   WebSocket
+    req:  http.IncomingMessage
 }
 
 /*  SpeechFlow node for subtitle (text-to-text) "translations"  */
@@ -160,7 +157,7 @@ export default class SpeechFlowNodeT2TSubtitle extends SpeechFlowNode {
         }
         else if (this.params.mode === "render") {
             /*  establish REST/WebSocket API  */
-            const wsPeers = new Map<string, wsPeerInfo>()
+            const wsPeers = new Map<string, WSPeerInfo>()
             this.hapi = new HAPI.Server({
                 address: this.params.addr,
                 port:    this.params.port
@@ -205,19 +202,18 @@ export default class SpeechFlowNodeT2TSubtitle extends SpeechFlowNode {
                     plugins: {
                         websocket: {
                             autoping: 30 * 1000,
-                            connect: (args: any) => {
-                                const ctx: wsPeerCtx            = args.ctx
-                                const ws:  WebSocket            = args.ws
-                                const req: http.IncomingMessage = args.req
+                            connect: ({ ctx, ws, req }) => {
                                 const peer = `${req.socket.remoteAddress}:${req.socket.remotePort}`
                                 ctx.peer = peer
                                 wsPeers.set(peer, { ctx, ws, req })
                                 this.log("info", `HAPI: WebSocket: connect: peer ${peer}`)
                             },
-                            disconnect: (args: any) => {
-                                const ctx: wsPeerCtx = args.ctx
+                            disconnect: ({ ctx, ws }) => {
                                 const peer = ctx.peer
                                 wsPeers.delete(peer)
+                                ws.removeAllListeners()
+                                if (ws.readyState === WebSocket.OPEN)
+                                    ws.close()
                                 this.log("info", `HAPI: WebSocket: disconnect: peer ${peer}`)
                             }
                         }
@@ -261,9 +257,9 @@ export default class SpeechFlowNodeT2TSubtitle extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

package/speechflow-cli/src/speechflow-node-t2t-transformers.ts

@@ -227,9 +227,9 @@ export default class SpeechFlowNodeT2TTransformers extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

package/speechflow-cli/src/speechflow-node-x2x-filter.ts

@@ -125,9 +125,9 @@ export default class SpeechFlowNodeX2XFilter extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

package/speechflow-cli/src/speechflow-node-x2x-trace.ts

@@ -12,6 +12,7 @@ import { Duration } from "luxon"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for data flow tracing  */
 export default class SpeechFlowNodeX2XTrace extends SpeechFlowNode {
@@ -19,7 +20,7 @@ export default class SpeechFlowNodeX2XTrace extends SpeechFlowNode {
     public static name = "x2x-trace"
 
     /*  internal state  */
-    private destroyed = false
+    private closing = false
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -56,7 +57,7 @@ export default class SpeechFlowNodeX2XTrace extends SpeechFlowNode {
         }
 
         /*  clear destruction flag  */
-        this.destroyed = false
+        this.closing = false
 
         /*  helper functions for formatting  */
         const fmtTime = (t: Duration) => t.toFormat("hh:mm:ss.SSS")
@@ -84,7 +85,7 @@ export default class SpeechFlowNodeX2XTrace extends SpeechFlowNode {
             highWaterMark:      1,
             transform (chunk: SpeechFlowChunk, encoding, callback) {
                 let error: Error | undefined
-                if (self.destroyed) {
+                if (self.closing) {
                     callback(new Error("stream already destroyed"))
                     return
                 }
@@ -118,7 +119,7 @@ export default class SpeechFlowNodeX2XTrace extends SpeechFlowNode {
                 }
             },
             final (callback) {
-                if (self.destroyed || self.params.mode === "sink") {
+                if (self.closing || self.params.mode === "sink") {
                     callback()
                     return
                 }
@@ -130,13 +131,13 @@ export default class SpeechFlowNodeX2XTrace extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  close stream  */
+        /*  indicate closing  */
+        this.closing = true
+
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
-
-        /*  indicate destruction  */
-        this.destroyed = true
     }
 }

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

@@ -36,6 +36,10 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
             chunk:  { type: "number", pos: 2, val: 200,  match: (n: number) => n >= 10 && n <= 1000 }
         })
 
+        /*  sanity check parameters  */
+        if (this.params.device === "")
+            throw new Error("required parameter \"device\" has to be given")
+
         /*  declare node input/output format  */
         if (this.params.mode === "rw") {
             this.input  = "audio"
@@ -115,7 +119,7 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
 
         /*  convert regular stream into object-mode stream  */
         const wrapper1 = util.createTransformStreamForWritableSide()
-        const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero)
+        const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero, highwaterMark)
         this.stream = Stream.compose(wrapper1, this.stream, wrapper2)
     }
 
@@ -136,7 +140,7 @@ 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)
+        const wrapper = util.createTransformStreamForReadableSide("audio", () => this.timeZero, highwaterMark)
         this.stream = Stream.compose(this.stream, wrapper)
     }
 
@@ -163,9 +167,6 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
 
     /*  open node  */
     async open () {
-        if (this.params.device === "")
-            throw new Error("required parameter \"device\" has to be given")
-
         /*  determine device  */
         const device = this.audioDeviceFromURL(this.params.mode, this.params.device)
 
@@ -193,6 +194,7 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
         /*  pass-through PortAudio errors  */
         this.io!.on("error", (err) => {
             this.emit("error", err)
+            this.stream?.emit("error", err)
         })
 
         /*  start PortAudio  */