speechflow 1.6.0 → 1.6.2

package/speechflow-cli/dst/speechflow-util-audio.js

@@ -0,0 +1,251 @@
+"use strict";
+/*
+**  SpeechFlow - Speech Processing Flow Graph
+**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
+*/
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebAudio = void 0;
+exports.audioBufferDuration = audioBufferDuration;
+exports.audioArrayDuration = audioArrayDuration;
+exports.convertBufToF32 = convertBufToF32;
+exports.convertF32ToBuf = convertF32ToBuf;
+exports.convertBufToI16 = convertBufToI16;
+exports.convertI16ToBuf = convertI16ToBuf;
+exports.processInt16ArrayInSegments = processInt16ArrayInSegments;
+exports.lin2dB = lin2dB;
+exports.dB2lin = dB2lin;
+/*  standard dependencies  */
+const node_path_1 = __importDefault(require("node:path"));
+/*  external dependencies  */
+const node_web_audio_api_1 = require("node-web-audio-api");
+/*  calculate duration of an audio buffer  */
+function audioBufferDuration(buffer, sampleRate = 48000, bitDepth = 16, channels = 1, littleEndian = true) {
+    /*  sanity check parameters  */
+    if (!Buffer.isBuffer(buffer))
+        throw new Error("invalid input (Buffer expected)");
+    if (littleEndian !== true)
+        throw new Error("only Little Endian supported");
+    if (sampleRate <= 0)
+        throw new Error("sample rate must be positive");
+    if (bitDepth <= 0 || bitDepth % 8 !== 0)
+        throw new Error("bit depth must be positive and multiple of 8");
+    if (channels <= 0)
+        throw new Error("channels must be positive");
+    /*  calculate duration  */
+    const bytesPerSample = bitDepth / 8;
+    const totalSamples = buffer.length / (bytesPerSample * channels);
+    return totalSamples / sampleRate;
+}
+/*  calculate duration of an audio array  */
+function audioArrayDuration(arr, sampleRate = 48000, channels = 1) {
+    /*  sanity check parameters  */
+    if (arr.length === 0)
+        return 0;
+    if (sampleRate <= 0)
+        throw new Error("sample rate must be positive");
+    if (channels <= 0)
+        throw new Error("channels must be positive");
+    /*  calculate duration  */
+    const totalSamples = arr.length / channels;
+    return totalSamples / sampleRate;
+}
+/*  helper function: convert Buffer in PCM/I16 to Float32Array in PCM/F32 format  */
+function convertBufToF32(buf, littleEndian = true) {
+    if (buf.length % 2 !== 0)
+        throw new Error("buffer length must be even for 16-bit samples");
+    const dataView = new DataView(buf.buffer);
+    const arr = new Float32Array(buf.length / 2);
+    for (let i = 0; i < arr.length; i++)
+        arr[i] = dataView.getInt16(i * 2, littleEndian) / 32768;
+    return arr;
+}
+/*  helper function: convert Float32Array in PCM/F32 to Buffer in PCM/I16 format  */
+function convertF32ToBuf(arr) {
+    if (arr.length === 0)
+        return Buffer.alloc(0);
+    const int16Array = new Int16Array(arr.length);
+    for (let i = 0; i < arr.length; i++) {
+        let sample = arr[i];
+        if (Number.isNaN(sample))
+            sample = 0;
+        int16Array[i] = Math.max(-32768, Math.min(32767, Math.round(sample * 32768)));
+    }
+    return Buffer.from(int16Array.buffer);
+}
+/*  helper function: convert Buffer in PCM/I16 to Int16Array  */
+function convertBufToI16(buf, littleEndian = true) {
+    if (buf.length % 2 !== 0)
+        throw new Error("buffer length must be even for 16-bit samples");
+    const dataView = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    const arr = new Int16Array(buf.length / 2);
+    for (let i = 0; i < buf.length / 2; i++)
+        arr[i] = dataView.getInt16(i * 2, littleEndian);
+    return arr;
+}
+/*  helper function: convert In16Array in PCM/I16 to Buffer  */
+function convertI16ToBuf(arr, littleEndian = true) {
+    if (arr.length === 0)
+        return Buffer.alloc(0);
+    const buf = Buffer.allocUnsafe(arr.length * 2);
+    for (let i = 0; i < arr.length; i++) {
+        if (littleEndian)
+            buf.writeInt16LE(arr[i], i * 2);
+        else
+            buf.writeInt16BE(arr[i], i * 2);
+    }
+    return buf;
+}
+/*  process Int16Array in fixed-size segments  */
+async function processInt16ArrayInSegments(data, segmentSize, processor) {
+    /*  process full segments  */
+    let i = 0;
+    while ((i + segmentSize) <= data.length) {
+        const segment = data.slice(i, i + segmentSize);
+        const result = await processor(segment);
+        data.set(result, i);
+        i += segmentSize;
+    }
+    /*  process final partial segment if it exists  */
+    if (i < data.length) {
+        const len = data.length - i;
+        const segment = new Int16Array(segmentSize);
+        segment.set(data.slice(i), 0);
+        segment.fill(0, len, segmentSize);
+        const result = await processor(segment);
+        data.set(result.slice(0, len), i);
+    }
+    return data;
+}
+/*  helper functions for linear/decibel conversions  */
+function lin2dB(x) {
+    return 20 * Math.log10(Math.max(x, 1e-12));
+}
+function dB2lin(db) {
+    return Math.pow(10, db / 20);
+}
+class WebAudio {
+    sampleRate;
+    channels;
+    /*  internal state  */
+    audioContext;
+    sourceNode = null;
+    captureNode = null;
+    pendingPromises = new Map();
+    /*  construct object  */
+    constructor(sampleRate, channels) {
+        this.sampleRate = sampleRate;
+        this.channels = channels;
+        /*  create new audio context  */
+        this.audioContext = new node_web_audio_api_1.AudioContext({
+            sampleRate,
+            latencyHint: "interactive"
+        });
+    }
+    /*  setup object  */
+    async setup() {
+        /*  ensure audio context is not suspended  */
+        if (this.audioContext.state === "suspended")
+            await this.audioContext.resume();
+        /*  add audio worklet module  */
+        const url = node_path_1.default.resolve(__dirname, "speechflow-util-audio-wt.js");
+        await this.audioContext.audioWorklet.addModule(url);
+        /*  create source node  */
+        this.sourceNode = new node_web_audio_api_1.AudioWorkletNode(this.audioContext, "source", {
+            numberOfInputs: 0,
+            numberOfOutputs: 1,
+            outputChannelCount: [this.channels]
+        });
+        /*  create capture node  */
+        this.captureNode = new node_web_audio_api_1.AudioWorkletNode(this.audioContext, "capture", {
+            numberOfInputs: 1,
+            numberOfOutputs: 0
+        });
+        this.captureNode.port.addEventListener("message", (event) => {
+            const { type, chunkId, data } = event.data ?? {};
+            if (type === "capture-complete") {
+                const promise = this.pendingPromises.get(chunkId);
+                if (promise) {
+                    clearTimeout(promise.timeout);
+                    this.pendingPromises.delete(chunkId);
+                    const int16Data = new Int16Array(data.length);
+                    for (let i = 0; i < data.length; i++)
+                        int16Data[i] = Math.max(-32768, Math.min(32767, Math.round(data[i] * 32767)));
+                    promise.resolve(int16Data);
+                }
+            }
+        });
+        /*  start ports  */
+        this.sourceNode.port.start();
+        this.captureNode.port.start();
+    }
+    /*  process single audio chunk  */
+    async process(int16Array) {
+        const chunkId = `chunk_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingPromises.delete(chunkId);
+                reject(new Error("processing timeout"));
+            }, (int16Array.length / this.audioContext.sampleRate) * 1000 + 250);
+            if (this.captureNode !== null)
+                this.pendingPromises.set(chunkId, { resolve, reject, timeout });
+            try {
+                const float32Data = new Float32Array(int16Array.length);
+                for (let i = 0; i < int16Array.length; i++)
+                    float32Data[i] = int16Array[i] / 32768.0;
+                /*  start capture first  */
+                if (this.captureNode !== null) {
+                    this.captureNode?.port.postMessage({
+                        type: "start-capture",
+                        chunkId,
+                        expectedSamples: int16Array.length
+                    });
+                }
+                /*  small delay to ensure capture is ready before sending data  */
+                setTimeout(() => {
+                    /*  send input to source node  */
+                    this.sourceNode?.port.postMessage({
+                        type: "input-chunk",
+                        chunkId,
+                        data: { pcmData: float32Data, channels: this.channels }
+                    }, [float32Data.buffer]);
+                }, 5);
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                if (this.captureNode !== null)
+                    this.pendingPromises.delete(chunkId);
+                reject(new Error(`failed to process chunk: ${error}`));
+            }
+        });
+    }
+    async destroy() {
+        /*  reject all pending promises  */
+        try {
+            this.pendingPromises.forEach(({ reject, timeout }) => {
+                clearTimeout(timeout);
+                reject(new Error("WebAudio destroyed"));
+            });
+            this.pendingPromises.clear();
+        }
+        catch (_err) {
+            /* ignored - cleanup during shutdown */
+        }
+        /*  disconnect nodes  */
+        if (this.sourceNode !== null) {
+            this.sourceNode.disconnect();
+            this.sourceNode = null;
+        }
+        if (this.captureNode !== null) {
+            this.captureNode.disconnect();
+            this.captureNode = null;
+        }
+        /*  stop context  */
+        await this.audioContext.close();
+    }
+}
+exports.WebAudio = WebAudio;
+//# sourceMappingURL=speechflow-util-audio.js.map

package/speechflow-cli/dst/speechflow-util-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechflow-util-audio.js","sourceRoot":"","sources":["../src/speechflow-util-audio.ts"],"names":[],"mappings":";AAAA;;;;EAIE;;;;;;AASF,kDAuBC;AAGD,gDAgBC;AAGD,0CAQC;AAGD,0CAWC;AAGD,0CAQC;AAGD,0CAWC;AAGD,kEAwBC;AAGD,wBAEC;AACD,wBAEC;AAtID,6BAA6B;AAC7B,0DAA4B;AAE5B,6BAA6B;AAC7B,2DAAmE;AAEnE,6CAA6C;AAC7C,SAAgB,mBAAmB,CAC/B,MAAc,EACd,UAAU,GAAK,KAAK,EACpB,QAAQ,GAAO,EAAE,EACjB,QAAQ,GAAO,CAAC,EAChB,YAAY,GAAG,IAAI;IAEnB,+BAA+B;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACtD,IAAI,YAAY,KAAK,IAAI;QACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACnD,IAAI,UAAU,IAAI,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACnD,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,CAAC,KAAK,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACnE,IAAI,QAAQ,IAAI,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAEhD,0BAA0B;IAC1B,MAAM,cAAc,GAAG,QAAQ,GAAG,CAAC,CAAA;IACnC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC,CAAA;IAChE,OAAO,YAAY,GAAG,UAAU,CAAA;AACpC,CAAC;AAED,4CAA4C;AAC5C,SAAgB,kBAAkB,CAC9B,GAAiB,EACjB,UAAU,GAAK,KAAK,EACpB,QAAQ,GAAO,CAAC;IAEhB,+BAA+B;IAC/B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAChB,OAAO,CAAC,CAAA;IACZ,IAAI,UAAU,IAAI,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACnD,IAAI,QAAQ,IAAI,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAEhD,0BAA0B;IAC1B,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAA;IAC1C,OAAO,YAAY,GAAG,UAAU,CAAA;AACpC,CAAC;AAED,oFAAoF;AACpF,SAAgB,eAAe,CAAE,GAAW,EAAE,YAAY,GAAG,IAAI;IAC7D,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IACpE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAC/B,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,GAAG,KAAK,CAAA;IAC3D,OAAO,GAAG,CAAA;AACd,CAAC;AAED,oFAAoF;AACpF,SAAgB,eAAe,CAAE,GAAiB;IAC9C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAChB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC1B,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACpB,MAAM,GAAG,CAAC,CAAA;QACd,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACjF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;AACzC,CAAC;AAED,gEAAgE;AAChE,SAAgB,eAAe,CAAE,GAAW,EAAE,YAAY,GAAG,IAAI;IAC7D,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IACpE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAA;IACzE,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE;QACnC,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAA;IACnD,OAAO,GAAG,CAAA;AACd,CAAC;AAED,+DAA+D;AAC/D,SAAgB,eAAe,CAAE,GAAe,EAAE,YAAY,GAAG,IAAI;IACjE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAChB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC1B,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,YAAY;YACZ,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;;YAE/B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,GAAG,CAAA;AACd,CAAC;AAED,iDAAiD;AAC1C,KAAK,UAAU,2BAA2B,CAC7C,IAA6B,EAC7B,WAAmB,EACnB,SAAiF;IAEjF,6BAA6B;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAA;QAC9C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAA;QACvC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QACnB,CAAC,IAAI,WAAW,CAAA;IACpB,CAAC;IAED,kDAAkD;IAClD,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QAC3B,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;QAC3C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAA;QACjC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAA;QACvC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC;AAED,uDAAuD;AACvD,SAAgB,MAAM,CAAE,CAAS;IAC7B,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;AAC9C,CAAC;AACD,SAAgB,MAAM,CAAE,EAAU;IAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;AAChC,CAAC;AAED,MAAa,QAAQ;IAaN;IACA;IAbX,sBAAsB;IACf,YAAY,CAAc;IAC1B,UAAU,GAA8B,IAAI,CAAA;IAC5C,WAAW,GAA6B,IAAI,CAAA;IAC3C,eAAe,GAAG,IAAI,GAAG,EAI7B,CAAA;IAEJ,wBAAwB;IACxB,YACW,UAAkB,EAClB,QAAgB;QADhB,eAAU,GAAV,UAAU,CAAQ;QAClB,aAAQ,GAAR,QAAQ,CAAQ;QAEvB,gCAAgC;QAChC,IAAI,CAAC,YAAY,GAAG,IAAI,iCAAY,CAAC;YACjC,UAAU;YACV,WAAW,EAAE,aAAa;SAC7B,CAAC,CAAA;IACN,CAAC;IAED,oBAAoB;IACb,KAAK,CAAC,KAAK;QACd,6CAA6C;QAC7C,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,KAAK,WAAW;YACvC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAA;QAEpC,gCAAgC;QAChC,MAAM,GAAG,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAA;QAClE,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QAEnD,0BAA0B;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,qCAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE;YAChE,cAAc,EAAG,CAAC;YAClB,eAAe,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAE,IAAI,CAAC,QAAQ,CAAE;SACxC,CAAC,CAAA;QAEF,2BAA2B;QAC3B,IAAI,CAAC,WAAW,GAAG,IAAI,qCAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE;YAClE,cAAc,EAAG,CAAC;YAClB,eAAe,EAAE,CAAC;SACrB,CAAC,CAAA;QACF,IAAI,CAAC,WAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACzD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;YAChD,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBACjD,IAAI,OAAO,EAAE,CAAC;oBACV,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;oBAC7B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;oBACpC,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;oBAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;wBAChC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;oBACjF,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;gBAC9B,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAA;QAEF,mBAAmB;QACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;QAC5B,IAAI,CAAC,WAAY,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IAClC,CAAC;IAED,kCAAkC;IAC3B,KAAK,CAAC,OAAO,CAAE,UAAsB;QACxC,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;QACpF,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBACpC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAA;YAC3C,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,CAAA;YACnE,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;gBACzB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;YACnE,IAAI,CAAC;gBACD,MAAM,WAAW,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;gBACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE;oBACtC,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAA;gBAE5C,2BAA2B;gBAC3B,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;oBAC5B,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC;wBAC/B,IAAI,EAAE,eAAe;wBACrB,OAAO;wBACP,eAAe,EAAE,UAAU,CAAC,MAAM;qBACrC,CAAC,CAAA;gBACN,CAAC;gBAED,kEAAkE;gBAClE,UAAU,CAAC,GAAG,EAAE;oBACZ,iCAAiC;oBACjC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC;wBAC9B,IAAI,EAAE,aAAa;wBACnB,OAAO;wBACP,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;qBAC1D,EAAE,CAAE,WAAW,CAAC,MAAM,CAAE,CAAC,CAAA;gBAC9B,CAAC,EAAE,CAAC,CAAC,CAAA;YACT,CAAC;YACD,OAAO,KAAK,EAAE,CAAC;gBACX,YAAY,CAAC,OAAO,CAAC,CAAA;gBACrB,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;oBACzB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBACxC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC,CAAA;YAC1D,CAAC;QACL,CAAC,CAAC,CAAA;IACN,CAAC;IAEM,KAAK,CAAC,OAAO;QAChB,mCAAmC;QACnC,IAAI,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;gBACjD,YAAY,CAAC,OAAO,CAAC,CAAA;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAA;YAC3C,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAA;QAChC,CAAC;QACD,OAAO,IAAI,EAAE,CAAC;YACV,uCAAuC;QAC3C,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAA;YAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAA;YAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QAC3B,CAAC;QAED,oBAAoB;QACpB,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IACnC,CAAC;CACJ;AAtID,4BAsIC"}

package/speechflow-cli/dst/speechflow-util-error.d.ts

@@ -0,0 +1,14 @@
+export declare function ensureError(error: unknown, prefix?: string, debug?: boolean): Error;
+export declare function ensurePromise<T>(arg: T | Promise<T>): Promise<T>;
+type runNoPromise<T> = [
+    T
+] extends [Promise<any>] ? never : T;
+export declare function run<T, X extends runNoPromise<T> | never>(action: () => X, oncatch?: (error: Error) => X | never, onfinally?: () => void): X;
+export declare function run<T, X extends runNoPromise<T> | never>(description: string, action: () => X, oncatch?: (error: Error) => X | never, onfinally?: () => void): X;
+export declare function run<T, X extends (T | Promise<T>)>(action: () => X, oncatch?: (error: Error) => X, onfinally?: () => void): Promise<T>;
+export declare function run<T, X extends (T | Promise<T>)>(description: string, action: () => X, oncatch?: (error: Error) => X, onfinally?: () => void): Promise<T>;
+export declare function runner<T, X extends runNoPromise<T> | never, F extends (...args: any[]) => X>(action: F, oncatch?: (error: Error) => X | never, onfinally?: () => void): F;
+export declare function runner<T, X extends runNoPromise<T> | never, F extends (...args: any[]) => X>(description: string, action: F, oncatch?: (error: Error) => X | never, onfinally?: () => void): F;
+export declare function runner<T, X extends (T | Promise<T>), F extends (...args: any[]) => Promise<T>>(action: F, oncatch?: (error: Error) => X, onfinally?: () => void): F;
+export declare function runner<T, X extends (T | Promise<T>), F extends (...args: any[]) => Promise<T>>(description: string, action: F, oncatch?: (error: Error) => X, onfinally?: () => void): F;
+export {};

package/speechflow-cli/dst/speechflow-util-error.js

@@ -0,0 +1,131 @@
+"use strict";
+/*
+**  SpeechFlow - Speech Processing Flow Graph
+**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureError = ensureError;
+exports.ensurePromise = ensurePromise;
+exports.run = run;
+exports.runner = runner;
+/*  helper function for retrieving an Error object  */
+function ensureError(error, prefix, debug = false) {
+    if (error instanceof Error && prefix === undefined && debug === false)
+        return error;
+    let msg = error instanceof Error ?
+        error.message : String(error);
+    if (prefix)
+        msg = `${prefix}: ${msg}`;
+    if (debug && error instanceof Error)
+        msg = `${msg}\n${error.stack}`;
+    return new Error(msg, { cause: error });
+}
+/*  helper function for retrieving a Promise object  */
+function ensurePromise(arg) {
+    if (!(arg instanceof Promise))
+        arg = Promise.resolve(arg);
+    return arg;
+}
+/*  helper function for running the finally code of "run"  */
+function runFinally(onfinally) {
+    if (!onfinally)
+        return;
+    try {
+        onfinally();
+    }
+    catch (_error) { /*  ignored  */ }
+}
+function run(...args) {
+    /*  support overloaded signatures  */
+    let description;
+    let action;
+    let oncatch;
+    let onfinally;
+    if (typeof args[0] === "string") {
+        description = args[0];
+        action = args[1];
+        oncatch = args[2];
+        onfinally = args[3];
+    }
+    else {
+        action = args[0];
+        oncatch = args[1];
+        onfinally = args[2];
+    }
+    /*  perform the action  */
+    let result;
+    try {
+        result = action();
+    }
+    catch (arg) {
+        /*  synchronous case (error branch)  */
+        let error = ensureError(arg, description);
+        if (oncatch) {
+            try {
+                result = oncatch(error);
+            }
+            catch (arg) {
+                error = ensureError(arg, description);
+                runFinally(onfinally);
+                throw error;
+            }
+            runFinally(onfinally);
+            return result;
+        }
+        runFinally(onfinally);
+        throw error;
+    }
+    if (result instanceof Promise) {
+        /*  asynchronous case (result or error branch)  */
+        return result.catch((arg) => {
+            /*  asynchronous case (error branch)  */
+            let error = ensureError(arg, description);
+            if (oncatch) {
+                try {
+                    return oncatch(error);
+                }
+                catch (arg) {
+                    error = ensureError(arg, description);
+                    throw error;
+                }
+            }
+            throw error;
+        }).finally(() => {
+            /*  asynchronous case (result and error branch)  */
+            runFinally(onfinally);
+        });
+    }
+    else {
+        /*  synchronous case (result branch)  */
+        runFinally(onfinally);
+        return result;
+    }
+}
+function runner(...args) {
+    /*  support overloaded signatures  */
+    let description;
+    let action;
+    let oncatch;
+    let onfinally;
+    if (typeof args[0] === "string") {
+        description = args[0];
+        action = args[1];
+        oncatch = args[2];
+        onfinally = args[3];
+    }
+    else {
+        action = args[0];
+        oncatch = args[1];
+        onfinally = args[2];
+    }
+    /*  wrap the "run" operation on "action" into function
+        which exposes the signature of "action"  */
+    return (...args) => {
+        if (description)
+            return run(description, () => action(...args), oncatch, onfinally);
+        else
+            return run(() => action(...args), oncatch, onfinally);
+    };
+}
+//# sourceMappingURL=speechflow-util-error.js.map

package/speechflow-cli/dst/speechflow-util-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechflow-util-error.js","sourceRoot":"","sources":["../src/speechflow-util-error.ts"],"names":[],"mappings":"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"}

package/speechflow-cli/dst/speechflow-util-queue.d.ts

@@ -0,0 +1,68 @@
+import { EventEmitter } from "node:events";
+import { type Type } from "arktype";
+import { Duration } from "luxon";
+export declare function importObject<T>(name: string, arg: object | string, validator: Type<T, {}>): T;
+export declare class SingleQueue<T> extends EventEmitter {
+    private queue;
+    write(item: T): void;
+    read(): Promise<T>;
+}
+export declare class DoubleQueue<T0, T1> extends EventEmitter {
+    private queue0;
+    private queue1;
+    private notify;
+    write0(item: T0): void;
+    write1(item: T1): void;
+    read(): Promise<[T0, T1]>;
+}
+export type QueueElement = {
+    type: string;
+};
+export declare class QueuePointer<T extends QueueElement> extends EventEmitter {
+    private name;
+    private queue;
+    private index;
+    constructor(name: string, queue: Queue<T>);
+    maxPosition(): number;
+    position(index?: number): number;
+    walk(num: number): void;
+    walkForwardUntil(type: T["type"]): void;
+    walkBackwardUntil(type: T["type"]): void;
+    searchForward(type: T["type"]): number;
+    searchBackward(type: T["type"]): number;
+    peek(position?: number): T;
+    read(): T;
+    slice(size?: number): T[];
+    touch(): void;
+    append(element: T): void;
+    insert(element: T): void;
+    delete(): void;
+}
+export declare class Queue<T extends QueueElement> extends EventEmitter {
+    elements: T[];
+    private pointers;
+    constructor();
+    pointerUse(name: string): QueuePointer<T>;
+    pointerDelete(name: string): void;
+    trim(): void;
+}
+export declare class TimeStore<T> extends EventEmitter {
+    private tree;
+    store(start: Duration, end: Duration, item: T): void;
+    fetch(start: Duration, end: Duration): T[];
+    prune(_before: Duration): void;
+    clear(): void;
+}
+export declare class AsyncQueue<T> {
+    private queue;
+    private resolvers;
+    write(v: T | null): void;
+    read(): Promise<T | null>;
+    destroy(): void;
+}
+export declare class CachedRegExp {
+    private cache;
+    compile(pattern: string): RegExp | null;
+    clear(): void;
+    size(): number;
+}