speechflow 1.6.5 → 1.6.7

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

@@ -27,7 +27,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
     private ws:         ws.WebSocket | null = null
     private queue:      util.SingleQueue<SpeechFlowChunk | null> | null = null
     private resampler:  SpeexResampler | null = null
-    private destroyed   = false
+    private closing   = false
     private connectionTimeout: ReturnType<typeof setTimeout> | null = null
 
     /*  construct node  */
@@ -60,7 +60,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
             throw new Error("OpenAI transcribe node currently supports PCM-S16LE audio only")
 
         /*  clear destruction flag  */
-        this.destroyed = false
+        this.closing = false
 
         /*  create queue for results  */
         this.queue = new util.SingleQueue<SpeechFlowChunk | null>()
@@ -172,7 +172,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
                         const start = DateTime.now().diff(this.timeOpen!) // FIXME: OpenAI does not provide timestamps
                         const end   = start                               // FIXME: OpenAI does not provide timestamps
                         const metas = metastore.fetch(start, end)
-                        const meta = metas.reduce((prev: Map<string, any>, curr: Map<string, any>) => {
+                        const meta = metas.toReversed().reduce((prev: Map<string, any>, curr: Map<string, any>) => {
                             curr.forEach((val, key) => { prev.set(key, val) })
                             return prev
                         }, new Map<string, any>())
@@ -187,7 +187,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
                     const start = DateTime.now().diff(this.timeOpen!) // FIXME: OpenAI does not provide timestamps
                     const end   = start                               // FIXME: OpenAI does not provide timestamps
                     const metas = metastore.fetch(start, end)
-                    const meta = metas.reduce((prev: Map<string, any>, curr: Map<string, any>) => {
+                    const meta = metas.toReversed().reduce((prev: Map<string, any>, curr: Map<string, any>) => {
                         curr.forEach((val, key) => { prev.set(key, val) })
                         return prev
                     }, new Map<string, any>())
@@ -226,7 +226,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
             decodeStrings:      false,
             highWaterMark:      1,
             write (chunk: SpeechFlowChunk, encoding, callback) {
-                if (self.destroyed || self.ws === null) {
+                if (self.closing || self.ws === null) {
                     callback(new Error("stream already destroyed"))
                     return
                 }
@@ -248,7 +248,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
                             })
                         }
                         catch (error) {
-                            callback(error instanceof Error ? error : new Error("failed to send to OpenAI transcribe"))
+                            callback(util.ensureError(error, "failed to send to OpenAI transcribe"))
                             return
                         }
                     }
@@ -256,12 +256,12 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
                 }
             },
             read (size) {
-                if (self.destroyed || self.queue === null) {
+                if (self.closing || self.queue === null) {
                     this.push(null)
                     return
                 }
                 self.queue.read().then((chunk) => {
-                    if (self.destroyed) {
+                    if (self.closing || self.queue === null) {
                         this.push(null)
                         return
                     }
@@ -274,12 +274,12 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
                         this.push(chunk)
                     }
                 }).catch((error: unknown) => {
-                    if (!self.destroyed)
+                    if (!self.closing && self.queue !== null)
                         self.log("error", `queue read error: ${util.ensureError(error).message}`)
                 })
             },
             final (callback) {
-                if (self.destroyed || self.ws === null) {
+                if (self.closing || self.ws === null) {
                     callback()
                     return
                 }
@@ -291,7 +291,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
                 }
                 catch (error) {
                     self.log("warning", `error closing OpenAI connection: ${error}`)
-                    callback(error instanceof Error ? error : new Error("failed to close OpenAI connection"))
+                    callback(util.ensureError(error, "failed to close OpenAI connection"))
                 }
             }
         })
@@ -299,8 +299,8 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  indicate destruction first to stop all async operations  */
-        this.destroyed = true
+        /*  indicate closing first to stop all async operations  */
+        this.closing = true
 
         /*  clear connection timeout  */
         if (this.connectionTimeout !== null) {
@@ -322,9 +322,9 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
         if (this.openai !== null)
             this.openai = 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-t2a-amazon.ts

@@ -26,7 +26,7 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
 
     /*  internal state  */
     private client: PollyClient | null = null
-    private destroyed = false
+    private closing = false
     private resampler: SpeexResampler | null = null
 
     /*  construct node  */
@@ -61,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({
@@ -123,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
                 }
@@ -132,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"
@@ -147,7 +147,7 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
                     callback()
             },
             final (callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback()
                     return
                 }
@@ -159,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)
@@ -171,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,7 +23,7 @@ export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
 
     /*  internal state  */
     private elevenlabs: ElevenLabs.ElevenLabsClient | null = null
-    private destroyed = false
+    private closing = false
     private resampler: SpeexResampler | null = null
 
     /*  construct node  */
@@ -67,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({
@@ -116,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,
@@ -140,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"))
@@ -157,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
@@ -180,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
                 }
@@ -198,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

@@ -119,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,
@@ -130,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
@@ -150,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

@@ -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

@@ -257,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"
@@ -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)