speechflow 1.6.0 → 1.6.2

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

@@ -19,7 +19,7 @@ import { DateTime, Duration } from "luxon"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  helper class for an asynchronous queue  */
 class AsyncQueue<T> {
@@ -73,7 +73,7 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
     private destroyed                                                           = false
     private initTimeout:       ReturnType<typeof setTimeout> | null             = null
     private connectionTimeout: ReturnType<typeof setTimeout> | null             = null
-    private queue:             utils.SingleQueue<SpeechFlowChunk | null> | null = null
+    private queue:             util.SingleQueue<SpeechFlowChunk | null> | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -114,10 +114,10 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
         this.destroyed = false
 
         /*  create queue for results  */
-        this.queue = new utils.SingleQueue<SpeechFlowChunk | null>()
+        this.queue = new util.SingleQueue<SpeechFlowChunk | null>()
 
         /*  create a store for the meta information  */
-        const metastore = new utils.TimeStore<Map<string, any>>()
+        const metastore = new util.TimeStore<Map<string, any>>()
 
         /*  connect to Amazon Transcribe API  */
         this.client = new TranscribeStreamingClient({
@@ -225,7 +225,7 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
                             metastore.store(chunk.timestampStart, chunk.timestampEnd, chunk.meta)
                         audioQueue.push(new Uint8Array(chunk.payload)) /* intentionally discard all time information */
                         ensureAudioStreamActive().catch((error: unknown) => {
-                            self.log("error", `failed to start audio stream: ${utils.ensureError(error).message}`)
+                            self.log("error", `failed to start audio stream: ${util.ensureError(error).message}`)
                         })
                     }
                     callback()
@@ -251,7 +251,7 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
                     }
                 }).catch((error: unknown) => {
                     if (!self.destroyed)
-                        self.log("error", `queue read error: ${utils.ensureError(error).message}`)
+                        self.log("error", `queue read error: ${util.ensureError(error).message}`)
                 })
             },
             final (callback) {
@@ -259,7 +259,7 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
                     callback()
                     return
                 }
-                utils.run(
+                util.run(
                     () => self.client!.destroy(),
                     (error: Error) => self.log("warning", `error closing Amazon Transcribe connection: ${error}`)
                 )

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

@@ -13,7 +13,7 @@ import { DateTime, Duration } from "luxon"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Deepgram speech-to-text conversion  */
 export default class SpeechFlowNodeA2TDeepgram extends SpeechFlowNode {
@@ -25,7 +25,7 @@ export default class SpeechFlowNodeA2TDeepgram extends SpeechFlowNode {
     private destroyed                                                           = false
     private initTimeout:       ReturnType<typeof setTimeout> | null             = null
     private connectionTimeout: ReturnType<typeof setTimeout> | null             = null
-    private queue:             utils.SingleQueue<SpeechFlowChunk | null> | null = null
+    private queue:             util.SingleQueue<SpeechFlowChunk | null> | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -78,10 +78,10 @@ export default class SpeechFlowNodeA2TDeepgram extends SpeechFlowNode {
         this.destroyed = false
 
         /*  create queue for results  */
-        this.queue = new utils.SingleQueue<SpeechFlowChunk | null>()
+        this.queue = new util.SingleQueue<SpeechFlowChunk | null>()
 
         /*  create a store for the meta information  */
-        const metastore = new utils.TimeStore<Map<string, any>>()
+        const metastore = new util.TimeStore<Map<string, any>>()
 
         /*  connect to Deepgram API  */
         const deepgram = Deepgram.createClient(this.params.key)
@@ -234,7 +234,7 @@ export default class SpeechFlowNodeA2TDeepgram extends SpeechFlowNode {
                     }
                 }).catch((error: unknown) => {
                     if (!self.destroyed)
-                        self.log("error", `queue read error: ${utils.ensureError(error).message}`)
+                        self.log("error", `queue read error: ${util.ensureError(error).message}`)
                 })
             },
             final (callback) {

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

@@ -15,7 +15,7 @@ import ws                     from "ws"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for OpenAI speech-to-text conversion  */
 export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
@@ -26,7 +26,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
     private static speexInitialized = false
     private openai:     OpenAI | null = null
     private ws:         ws.WebSocket | null = null
-    private queue:      utils.SingleQueue<SpeechFlowChunk | null> | null = null
+    private queue:      util.SingleQueue<SpeechFlowChunk | null> | null = null
     private resampler:  SpeexResampler | null = null
     private destroyed   = false
     private connectionTimeout: ReturnType<typeof setTimeout> | null = null
@@ -64,10 +64,10 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
         this.destroyed = false
 
         /*  create queue for results  */
-        this.queue = new utils.SingleQueue<SpeechFlowChunk | null>()
+        this.queue = new util.SingleQueue<SpeechFlowChunk | null>()
 
         /*  create a store for the meta information  */
-        const metastore = new utils.TimeStore<Map<string, any>>()
+        const metastore = new util.TimeStore<Map<string, any>>()
 
         /*  establish resampler from our standard audio sample rate (48Khz)
             to OpenAI's maximum 24Khz input sample rate  */
@@ -281,7 +281,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
                     }
                 }).catch((error: unknown) => {
                     if (!self.destroyed)
-                        self.log("error", `queue read error: ${utils.ensureError(error).message}`)
+                        self.log("error", `queue read error: ${util.ensureError(error).message}`)
                 })
             },
             final (callback) {

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

@@ -17,7 +17,7 @@ import {
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Amazon Polly text-to-speech conversion  */
 export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
@@ -146,7 +146,7 @@ export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error, "failed to send to AWS Polly"))
+                        callback(util.ensureError(error, "failed to send to AWS Polly"))
                     })
                 }
                 else

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

@@ -13,7 +13,7 @@ import SpeexResampler from "speex-resampler"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Kokoro text-to-speech conversion  */
 export default class SpeechFlowNodeT2AKokoro extends SpeechFlowNode {
@@ -143,7 +143,7 @@ export default class SpeechFlowNodeT2AKokoro extends SpeechFlowNode {
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

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

@@ -12,7 +12,7 @@ import { TranslateClient, TranslateTextCommand } from "@aws-sdk/client-translate
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Amazon Translate text-to-text translations  */
 export default class SpeechFlowNodeT2TAmazon extends SpeechFlowNode {
@@ -124,7 +124,7 @@ export default class SpeechFlowNodeT2TAmazon extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

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

@@ -12,7 +12,7 @@ import * as DeepL from "deepl-node"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for DeepL text-to-text translations  */
 export default class SpeechFlowNodeT2TDeepL extends SpeechFlowNode {
@@ -95,7 +95,7 @@ export default class SpeechFlowNodeT2TDeepL extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

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

@@ -13,7 +13,7 @@ import * as arktype                 from "arktype"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Google Translate text-to-text translations  */
 export default class SpeechFlowNodeT2TGoogle extends SpeechFlowNode {
@@ -55,9 +55,9 @@ export default class SpeechFlowNodeT2TGoogle extends SpeechFlowNode {
     /*  open node  */
     async open () {
         /*  instantiate Google Translate client  */
-        const data = utils.run("Google Cloud API credentials key", () =>
+        const data = util.run("Google Cloud API credentials key", () =>
             JSON.parse(this.params.key))
-        const credentials = utils.importObject("Google Cloud API credentials key",
+        const credentials = util.importObject("Google Cloud API credentials key",
             data,
             arktype.type({
                 project_id:   "string",
@@ -74,7 +74,7 @@ export default class SpeechFlowNodeT2TGoogle extends SpeechFlowNode {
         })
 
         /*  provide text-to-text translation  */
-        const translate = utils.runner("Google Translate API", async (text: string) => {
+        const translate = util.runner("Google Translate API", async (text: string) => {
             const [ response ] = await this.client!.translateText({
                 parent:   `projects/${credentials.project_id}/locations/global`,
                 contents: [ text ],
@@ -105,7 +105,7 @@ export default class SpeechFlowNodeT2TGoogle extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

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

@@ -9,7 +9,7 @@ import Stream   from "node:stream"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for text-to-text modification via regex  */
 export default class SpeechFlowNodeT2TModify extends SpeechFlowNode {
@@ -38,7 +38,7 @@ export default class SpeechFlowNodeT2TModify extends SpeechFlowNode {
             throw new Error("match parameter cannot be empty")
 
         /*  compile regex pattern  */
-        const regex = utils.run("compiling regex pattern",
+        const regex = util.run("compiling regex pattern",
             () => new RegExp(this.params.match, "g"))
 
         /*  apply regex-based modification  */

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

@@ -12,7 +12,7 @@ import { Ollama, type ListResponse } from "ollama"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  internal utility types  */
 type ConfigEntry = { systemPrompt: string, chat: Array<{ role: string, content: string }> }
@@ -252,7 +252,7 @@ export default class SpeechFlowNodeT2TOllama extends SpeechFlowNode {
                             this.push(chunkNew)
                             callback()
                         }).catch((error: unknown) => {
-                            callback(utils.ensureError(error))
+                            callback(util.ensureError(error))
                         })
                     }
                 }

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

@@ -12,7 +12,7 @@ import OpenAI from "openai"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  internal utility types  */
 type ConfigEntry = { systemPrompt: string, chat: OpenAI.ChatCompletionMessageParam[] }
@@ -221,7 +221,7 @@ export default class SpeechFlowNodeT2TOpenAI extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

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

@@ -12,7 +12,7 @@ import { Duration }       from "luxon"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  text stream queue element */
 type TextQueueElement = {
@@ -29,7 +29,7 @@ export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
     public static name = "t2t-sentence"
 
     /*  internal state  */
-    private queue      = new utils.Queue<TextQueueElement>()
+    private queue      = new util.Queue<TextQueueElement>()
     private queueRecv  = this.queue.pointerUse("recv")
     private queueSplit = this.queue.pointerUse("split")
     private queueSend  = this.queue.pointerUse("send")

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

@@ -18,7 +18,7 @@ import HAPIWebSocket from "hapi-plugin-websocket"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 type wsPeerCtx = {
     peer: string
@@ -147,7 +147,7 @@ export default class SpeechFlowNodeT2TSubtitle extends SpeechFlowNode {
                                 this.push(chunkNew)
                                 callback()
                             }).catch((error: unknown) => {
-                                callback(utils.ensureError(error))
+                                callback(util.ensureError(error))
                             })
                         }
                     }

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

@@ -13,7 +13,7 @@ import * as Transformers from "@huggingface/transformers"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  internal utility types  */
 type ConfigEntry = { systemPrompt: string, chat: Array<{ role: string, content: string }> }
@@ -214,7 +214,7 @@ export default class SpeechFlowNodeT2TTransformers extends SpeechFlowNode {
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

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

@@ -9,7 +9,7 @@ import Stream from "node:stream"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for data flow filtering (based on meta information)  */
 export default class SpeechFlowNodeX2XFilter extends SpeechFlowNode {
@@ -17,7 +17,7 @@ export default class SpeechFlowNodeX2XFilter extends SpeechFlowNode {
     public static name = "x2x-filter"
 
     /*  cached regular expression instance  */
-    private cachedRegExp = new utils.CachedRegExp()
+    private cachedRegExp = new util.CachedRegExp()
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {

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

@@ -12,7 +12,7 @@ import PortAudio        from "@gpeng/naudiodon"
 
 /*  internal dependencies  */
 import SpeechFlowNode   from "./speechflow-node"
-import * as utils       from "./speechflow-utils"
+import * as util        from "./speechflow-util"
 
 /*  SpeechFlow node for device access  */
 export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
@@ -135,8 +135,8 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
             this.stream = this.io as unknown as Stream.Duplex
 
             /*  convert regular stream into object-mode stream  */
-            const wrapper1 = utils.createTransformStreamForWritableSide()
-            const wrapper2 = utils.createTransformStreamForReadableSide("audio", () => this.timeZero)
+            const wrapper1 = util.createTransformStreamForWritableSide()
+            const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero)
             this.stream = Stream.compose(wrapper1, this.stream, wrapper2)
         }
         else if (this.params.mode === "r") {
@@ -156,7 +156,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 = utils.createTransformStreamForReadableSide("audio", () => this.timeZero)
+            const wrapper = util.createTransformStreamForReadableSide("audio", () => this.timeZero)
             this.stream = Stream.compose(this.stream, wrapper)
         }
         else if (this.params.mode === "w") {
@@ -176,7 +176,7 @@ export default class SpeechFlowNodeXIODevice extends SpeechFlowNode {
             this.stream = this.io as unknown as Stream.Writable
 
             /*  convert regular stream into object-mode stream  */
-            const wrapper = utils.createTransformStreamForWritableSide()
+            const wrapper = util.createTransformStreamForWritableSide()
             this.stream = Stream.compose(wrapper, this.stream)
         }
         else

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

@@ -10,7 +10,7 @@ import Stream           from "node:stream"
 
 /*  internal dependencies  */
 import SpeechFlowNode   from "./speechflow-node"
-import * as utils       from "./speechflow-utils"
+import * as util        from "./speechflow-util"
 
 /*  SpeechFlow node for file access  */
 export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
@@ -64,8 +64,8 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
             This ensures the writable side of the composed stream below
             properly signals completion while keeping process.stdout open
             (as it's a global stream that shouldn't be closed by individual nodes). */
-        const createStdoutChunker = () => {
-            return new Stream.Writable({
+        const createStdoutChunker = () =>
+            new Stream.Writable({
                 highWaterMark: this.params.type === "audio" ?
                     highWaterMarkAudio : highWaterMarkText,
                 write (chunk: Buffer | string, encoding, callback) {
@@ -79,7 +79,6 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                     callback()
                 }
             })
-        }
 
         /*  dispatch according to mode and path  */
         if (this.params.mode === "rw") {
@@ -129,8 +128,8 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
             }
 
             /*  convert regular stream into object-mode stream  */
-            const wrapper1 = utils.createTransformStreamForWritableSide()
-            const wrapper2 = utils.createTransformStreamForReadableSide(
+            const wrapper1 = util.createTransformStreamForWritableSide()
+            const wrapper2 = util.createTransformStreamForReadableSide(
                 this.params.type, () => this.timeZero)
             this.stream = Stream.compose(wrapper1, this.stream, wrapper2)
         }
@@ -146,7 +145,7 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                     process.stdin.setEncoding(this.config.textEncoding)
                     chunker = new Stream.PassThrough({ highWaterMark: highWaterMarkText })
                 }
-                const wrapper = utils.createTransformStreamForReadableSide(
+                const wrapper = util.createTransformStreamForReadableSide(
                     this.params.type, () => this.timeZero)
                 this.stream = Stream.compose(process.stdin, chunker, wrapper)
             }
@@ -159,7 +158,7 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                 else
                     readable = fs.createReadStream(this.params.path,
                         { highWaterMark: highWaterMarkText, encoding: this.config.textEncoding })
-                const wrapper = utils.createTransformStreamForReadableSide(
+                const wrapper = util.createTransformStreamForReadableSide(
                     this.params.type, () => this.timeZero)
                 this.stream = Stream.compose(readable, wrapper)
             }
@@ -172,7 +171,7 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                 else
                     process.stdout.setEncoding(this.config.textEncoding)
                 const chunker = createStdoutChunker()
-                const wrapper = utils.createTransformStreamForWritableSide()
+                const wrapper = util.createTransformStreamForWritableSide()
                 this.stream = Stream.compose(wrapper, chunker)
             }
             else {
@@ -184,7 +183,7 @@ export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
                 else
                     writable = fs.createWriteStream(this.params.path,
                         { highWaterMark: highWaterMarkText, encoding: this.config.textEncoding })
-                const wrapper = utils.createTransformStreamForWritableSide()
+                const wrapper = util.createTransformStreamForWritableSide()
                 this.stream = Stream.compose(wrapper, writable)
             }
         }

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

@@ -13,7 +13,7 @@ import UUID   from "pure-uuid"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for MQTT networking  */
 export default class SpeechFlowNodeXIOMQTT extends SpeechFlowNode {
@@ -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: utils.SingleQueue<SpeechFlowChunk> | null = null
+    private chunkQueue: util.SingleQueue<SpeechFlowChunk> | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -99,12 +99,12 @@ export default class SpeechFlowNodeXIOMQTT extends SpeechFlowNode {
         this.broker.on("disconnect", (packet: MQTT.IDisconnectPacket) => {
             this.log("info", `connection closed to MQTT ${this.params.url}`)
         })
-        this.chunkQueue = new utils.SingleQueue<SpeechFlowChunk>()
+        this.chunkQueue = new util.SingleQueue<SpeechFlowChunk>()
         this.broker.on("message", (topic: string, payload: Buffer, packet: MQTT.IPublishPacket) => {
             if (topic !== this.params.topicRead || this.params.mode === "w")
                 return
             try {
-                const chunk = utils.streamChunkDecode(payload)
+                const chunk = util.streamChunkDecode(payload)
                 this.chunkQueue!.write(chunk)
             }
             catch (_err: any) {
@@ -125,7 +125,7 @@ export default class SpeechFlowNodeXIOMQTT extends SpeechFlowNode {
                 else if (!self.broker!.connected)
                     callback(new Error("still no MQTT connection available"))
                 else {
-                    const data = Buffer.from(utils.streamChunkEncode(chunk))
+                    const data = Buffer.from(util.streamChunkEncode(chunk))
                     self.broker!.publish(self.params.topicWrite, data, { qos: 2, retain: false }, (err) => {
                         if (err)
                             callback(new Error(`failed to publish to MQTT topic "${self.params.topicWrite}": ${err}`))

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

@@ -13,7 +13,7 @@ import ReconnWebSocket, { ErrorEvent } from "@opensumi/reconnecting-websocket"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Websocket networking  */
 export default class SpeechFlowNodeXIOWebSocket extends SpeechFlowNode {
@@ -63,7 +63,7 @@ export default class SpeechFlowNodeXIOWebSocket extends SpeechFlowNode {
             /*  listen locally on a Websocket port  */
             const url = new URL(this.params.listen)
             const websockets = new Set<ws.WebSocket>()
-            const chunkQueue = new utils.SingleQueue<SpeechFlowChunk>()
+            const chunkQueue = new util.SingleQueue<SpeechFlowChunk>()
             this.server = new ws.WebSocketServer({
                 host: url.hostname,
                 port: Number.parseInt(url.port, 10),
@@ -101,7 +101,7 @@ export default class SpeechFlowNodeXIOWebSocket extends SpeechFlowNode {
                         buffer = Buffer.from(data)
                     else
                         buffer = Buffer.concat(data)
-                    const chunk = utils.streamChunkDecode(buffer)
+                    const chunk = util.streamChunkDecode(buffer)
                     chunkQueue.write(chunk)
                 })
             })
@@ -122,7 +122,7 @@ export default class SpeechFlowNodeXIOWebSocket extends SpeechFlowNode {
                     else if (websockets.size === 0)
                         callback(new Error("still no Websocket connections available"))
                     else {
-                        const data = utils.streamChunkEncode(chunk)
+                        const data = util.streamChunkEncode(chunk)
                         const results: Promise<void>[] = []
                         for (const websocket of websockets.values()) {
                             results.push(new Promise<void>((resolve, reject) => {
@@ -172,7 +172,7 @@ export default class SpeechFlowNodeXIOWebSocket extends SpeechFlowNode {
             this.client.addEventListener("error", (ev: ErrorEvent) => {
                 this.log("error", `error of connection on URL ${this.params.connect}: ${ev.error.message}`)
             })
-            const chunkQueue = new utils.SingleQueue<SpeechFlowChunk>()
+            const chunkQueue = new util.SingleQueue<SpeechFlowChunk>()
             this.client.addEventListener("message", (ev: MessageEvent) => {
                 if (this.params.mode === "w") {
                     this.log("warning", `connection to URL ${this.params.connect}: ` +
@@ -185,7 +185,7 @@ export default class SpeechFlowNodeXIOWebSocket extends SpeechFlowNode {
                     return
                 }
                 const buffer = Buffer.from(ev.data)
-                const chunk = utils.streamChunkDecode(buffer)
+                const chunk = util.streamChunkDecode(buffer)
                 chunkQueue.write(chunk)
             })
             this.client.binaryType = "arraybuffer"
@@ -203,7 +203,7 @@ export default class SpeechFlowNodeXIOWebSocket extends SpeechFlowNode {
                     else if (!self.client!.OPEN)
                         callback(new Error("still no Websocket connection available"))
                     else {
-                        const data = utils.streamChunkEncode(chunk)
+                        const data = util.streamChunkEncode(chunk)
                         self.client!.send(data)
                         callback()
                     }