even-toolkit 1.0.1 → 1.1.1

package/dist/stt/audio/buffer.d.ts

@@ -0,0 +1,12 @@
+/** Audio accumulator — collects Float32 chunks and exports as WAV */
+export declare function createAudioBuffer(config?: {
+    maxSeconds?: number;
+    sampleRate?: number;
+}): {
+    append: (chunk: Float32Array) => void;
+    getAll: () => Float32Array;
+    getWav: () => Blob;
+    clear: () => void;
+    duration: () => number;
+};
+//# sourceMappingURL=buffer.d.ts.map

package/dist/stt/audio/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../stt/audio/buffer.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;oBAM9D,YAAY,KAAG,IAAI;kBAMvB,YAAY;kBAUZ,IAAI;iBAIL,IAAI;oBAKD,MAAM;EAK5B"}

package/dist/stt/audio/buffer.js

@@ -0,0 +1,35 @@
+import { float32ToWav } from './pcm-utils';
+/** Audio accumulator — collects Float32 chunks and exports as WAV */
+export function createAudioBuffer(config) {
+    const sampleRate = config?.sampleRate ?? 16000;
+    const maxSamples = (config?.maxSeconds ?? 30) * sampleRate;
+    const chunks = [];
+    let totalSamples = 0;
+    function append(chunk) {
+        if (totalSamples + chunk.length > maxSamples)
+            return;
+        chunks.push(chunk);
+        totalSamples += chunk.length;
+    }
+    function getAll() {
+        const out = new Float32Array(totalSamples);
+        let offset = 0;
+        for (const chunk of chunks) {
+            out.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return out;
+    }
+    function getWav() {
+        return float32ToWav(getAll(), sampleRate);
+    }
+    function clear() {
+        chunks.length = 0;
+        totalSamples = 0;
+    }
+    function duration() {
+        return totalSamples / sampleRate;
+    }
+    return { append, getAll, getWav, clear, duration };
+}
+//# sourceMappingURL=buffer.js.map

package/dist/stt/audio/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../../../stt/audio/buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,MAAqD;IACrF,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,KAAK,CAAC;IAC/C,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC;IAC3D,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,SAAS,MAAM,CAAC,KAAmB;QACjC,IAAI,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,UAAU;YAAE,OAAO;QACrD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,SAAS,MAAM;QACb,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;QACzB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,MAAM;QACb,OAAO,YAAY,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS,KAAK;QACZ,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAClB,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,SAAS,QAAQ;QACf,OAAO,YAAY,GAAG,UAAU,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC"}

package/dist/stt/audio/pcm-utils.d.ts

@@ -0,0 +1,9 @@
+/** Convert Uint8Array of 16-bit signed PCM to Int16Array */
+export declare function uint8ToPcm16(data: Uint8Array): Int16Array;
+/** Convert Int16Array PCM to Float32Array [-1, 1] */
+export declare function pcm16ToFloat32(data: Int16Array): Float32Array;
+/** Convert Float32Array [-1, 1] to Int16Array PCM */
+export declare function float32ToPcm16(data: Float32Array): Int16Array;
+/** Convert Float32Array to WAV Blob */
+export declare function float32ToWav(data: Float32Array, sampleRate: number): Blob;
+//# sourceMappingURL=pcm-utils.d.ts.map

package/dist/stt/audio/pcm-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-utils.d.ts","sourceRoot":"","sources":["../../../stt/audio/pcm-utils.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAEzD;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAM7D;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAO7D;AAED,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CA4BzE"}

package/dist/stt/audio/pcm-utils.js

@@ -0,0 +1,52 @@
+/** Convert Uint8Array of 16-bit signed PCM to Int16Array */
+export function uint8ToPcm16(data) {
+    return new Int16Array(data.buffer, data.byteOffset, data.byteLength / 2);
+}
+/** Convert Int16Array PCM to Float32Array [-1, 1] */
+export function pcm16ToFloat32(data) {
+    const out = new Float32Array(data.length);
+    for (let i = 0; i < data.length; i++) {
+        out[i] = data[i] / 32768;
+    }
+    return out;
+}
+/** Convert Float32Array [-1, 1] to Int16Array PCM */
+export function float32ToPcm16(data) {
+    const out = new Int16Array(data.length);
+    for (let i = 0; i < data.length; i++) {
+        const s = Math.max(-1, Math.min(1, data[i]));
+        out[i] = s < 0 ? s * 0x8000 : s * 0x7fff;
+    }
+    return out;
+}
+/** Convert Float32Array to WAV Blob */
+export function float32ToWav(data, sampleRate) {
+    const pcm = float32ToPcm16(data);
+    const buffer = new ArrayBuffer(44 + pcm.byteLength);
+    const view = new DataView(buffer);
+    // RIFF header
+    writeString(view, 0, 'RIFF');
+    view.setUint32(4, 36 + pcm.byteLength, true);
+    writeString(view, 8, 'WAVE');
+    // fmt chunk
+    writeString(view, 12, 'fmt ');
+    view.setUint32(16, 16, true); // chunk size
+    view.setUint16(20, 1, true); // PCM format
+    view.setUint16(22, 1, true); // mono
+    view.setUint32(24, sampleRate, true); // sample rate
+    view.setUint32(28, sampleRate * 2, true); // byte rate
+    view.setUint16(32, 2, true); // block align
+    view.setUint16(34, 16, true); // bits per sample
+    // data chunk
+    writeString(view, 36, 'data');
+    view.setUint32(40, pcm.byteLength, true);
+    const bytes = new Uint8Array(buffer, 44);
+    bytes.set(new Uint8Array(pcm.buffer, pcm.byteOffset, pcm.byteLength));
+    return new Blob([buffer], { type: 'audio/wav' });
+}
+function writeString(view, offset, str) {
+    for (let i = 0; i < str.length; i++) {
+        view.setUint8(offset + i, str.charCodeAt(i));
+    }
+}
+//# sourceMappingURL=pcm-utils.js.map

package/dist/stt/audio/pcm-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-utils.js","sourceRoot":"","sources":["../../../stt/audio/pcm-utils.ts"],"names":[],"mappings":"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"}

package/dist/stt/audio/resample.d.ts

@@ -0,0 +1,3 @@
+/** Linear interpolation resample from one sample rate to another */
+export declare function resample(input: Float32Array, fromRate: number, toRate: number): Float32Array;
+//# sourceMappingURL=resample.d.ts.map

package/dist/stt/audio/resample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resample.d.ts","sourceRoot":"","sources":["../../../stt/audio/resample.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAgB5F"}

package/dist/stt/audio/resample.js

@@ -0,0 +1,17 @@
+/** Linear interpolation resample from one sample rate to another */
+export function resample(input, fromRate, toRate) {
+    if (fromRate === toRate)
+        return input;
+    const ratio = fromRate / toRate;
+    const outputLength = Math.round(input.length / ratio);
+    const output = new Float32Array(outputLength);
+    for (let i = 0; i < outputLength; i++) {
+        const srcIndex = i * ratio;
+        const srcFloor = Math.floor(srcIndex);
+        const srcCeil = Math.min(srcFloor + 1, input.length - 1);
+        const frac = srcIndex - srcFloor;
+        output[i] = input[srcFloor] * (1 - frac) + input[srcCeil] * frac;
+    }
+    return output;
+}
+//# sourceMappingURL=resample.js.map

package/dist/stt/audio/resample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resample.js","sourceRoot":"","sources":["../../../stt/audio/resample.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,UAAU,QAAQ,CAAC,KAAmB,EAAE,QAAgB,EAAE,MAAc;IAC5E,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC;IAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/stt/audio/vad.d.ts

@@ -0,0 +1,17 @@
+/** Energy-based Voice Activity Detection */
+export interface VADConfig {
+    silenceThresholdMs?: number;
+    speechThresholdDb?: number;
+    frameSizeMs?: number;
+}
+export interface VADResult {
+    isSpeech: boolean;
+    speechStarted: boolean;
+    speechEnded: boolean;
+    energy: number;
+}
+export declare function createVAD(config?: VADConfig): {
+    process: (frame: Float32Array) => VADResult;
+    reset: () => void;
+};
+//# sourceMappingURL=vad.d.ts.map

package/dist/stt/audio/vad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vad.d.ts","sourceRoot":"","sources":["../../../stt/audio/vad.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,MAAM,WAAW,SAAS;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS;qBAQlB,YAAY,KAAG,SAAS;;EAqCjD"}

package/dist/stt/audio/vad.js

@@ -0,0 +1,43 @@
+/** Energy-based Voice Activity Detection */
+export function createVAD(config) {
+    const silenceMs = config?.silenceThresholdMs ?? 1500;
+    const thresholdDb = config?.speechThresholdDb ?? -26;
+    const threshold = Math.pow(10, thresholdDb / 20);
+    let speaking = false;
+    let silenceStart = 0;
+    function process(frame) {
+        // RMS energy
+        let sum = 0;
+        for (let i = 0; i < frame.length; i++) {
+            sum += frame[i] * frame[i];
+        }
+        const rms = Math.sqrt(sum / frame.length);
+        const isSpeech = rms > threshold;
+        let speechStarted = false;
+        let speechEnded = false;
+        if (isSpeech) {
+            if (!speaking) {
+                speaking = true;
+                speechStarted = true;
+            }
+            silenceStart = 0;
+        }
+        else if (speaking) {
+            if (silenceStart === 0) {
+                silenceStart = Date.now();
+            }
+            else if (Date.now() - silenceStart > silenceMs) {
+                speaking = false;
+                speechEnded = true;
+                silenceStart = 0;
+            }
+        }
+        return { isSpeech, speechStarted, speechEnded, energy: rms };
+    }
+    function reset() {
+        speaking = false;
+        silenceStart = 0;
+    }
+    return { process, reset };
+}
+//# sourceMappingURL=vad.js.map

package/dist/stt/audio/vad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vad.js","sourceRoot":"","sources":["../../../stt/audio/vad.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAe5C,MAAM,UAAU,SAAS,CAAC,MAAkB;IAC1C,MAAM,SAAS,GAAG,MAAM,EAAE,kBAAkB,IAAI,IAAI,CAAC;IACrD,MAAM,WAAW,GAAG,MAAM,EAAE,iBAAiB,IAAI,CAAC,EAAE,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;IAEjD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,SAAS,OAAO,CAAC,KAAmB;QAClC,aAAa;QACb,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,GAAG,GAAG,SAAS,CAAC;QAEjC,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,WAAW,GAAG,KAAK,CAAC;QAExB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,CAAC;gBAChB,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,YAAY,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,QAAQ,EAAE,CAAC;YACpB,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;gBACvB,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,CAAC;iBAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,GAAG,SAAS,EAAE,CAAC;gBACjD,QAAQ,GAAG,KAAK,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,YAAY,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC/D,CAAC;IAED,SAAS,KAAK;QACZ,QAAQ,GAAG,KAAK,CAAC;QACjB,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/stt/engine.d.ts

@@ -0,0 +1,38 @@
+import type { STTEngineConfig, STTState, STTTranscript, STTError } from './types';
+/**
+ * STTEngine orchestrates source -> processing -> provider.
+ *
+ * For `web-speech` provider: skips audio source (it handles its own mic).
+ * For other providers: starts audio source, pipes through optional resample
+ * and VAD, buffers audio, and calls provider.transcribe() on speech end.
+ */
+export declare class STTEngine {
+    private config;
+    private provider;
+    private source;
+    private sourceUnsub;
+    private transcriptListeners;
+    private stateListeners;
+    private errorListeners;
+    private providerUnsubs;
+    private vad;
+    private buffer;
+    private targetSampleRate;
+    constructor(config: STTEngineConfig);
+    onTranscript(cb: (t: STTTranscript) => void): () => void;
+    onStateChange(cb: (s: STTState) => void): () => void;
+    onError(cb: (e: STTError) => void): () => void;
+    private emitTranscript;
+    private emitState;
+    private emitError;
+    start(): Promise<void>;
+    stop(): void;
+    abort(): void;
+    dispose(): void;
+    private resolveSource;
+    private processAudio;
+    private flushBuffer;
+    private subscribeProvider;
+    private switchToFallback;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/stt/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../stt/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,QAAQ,EACR,aAAa,EACb,QAAQ,EAET,MAAM,SAAS,CAAC;AAOjB;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAA6B;IAEhD,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,cAAc,CAAoC;IAE1D,OAAO,CAAC,cAAc,CAAyB;IAE/C,OAAO,CAAC,GAAG,CAA6C;IACxD,OAAO,CAAC,MAAM,CAAqD;IACnE,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,eAAe;IAOnC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAQxD,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAQpD,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ9C,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,SAAS;IAMX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+D5B,IAAI,IAAI,IAAI;IASZ,KAAK,IAAI,IAAI;IASb,OAAO,IAAI,IAAI;IAef,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,YAAY;YAyBN,WAAW;IAuBzB,OAAO,CAAC,iBAAiB;YAaX,gBAAgB;CAmB/B"}

package/dist/stt/engine.js

@@ -0,0 +1,233 @@
+import { createProvider } from './registry';
+import { MicrophoneSource } from './sources/microphone';
+import { resample } from './audio/resample';
+import { createVAD } from './audio/vad';
+import { createAudioBuffer } from './audio/buffer';
+/**
+ * STTEngine orchestrates source -> processing -> provider.
+ *
+ * For `web-speech` provider: skips audio source (it handles its own mic).
+ * For other providers: starts audio source, pipes through optional resample
+ * and VAD, buffers audio, and calls provider.transcribe() on speech end.
+ */
+export class STTEngine {
+    constructor(config) {
+        this.provider = null;
+        this.source = null;
+        this.sourceUnsub = null;
+        this.transcriptListeners = [];
+        this.stateListeners = [];
+        this.errorListeners = [];
+        this.providerUnsubs = [];
+        this.vad = null;
+        this.buffer = null;
+        this.config = config;
+        this.targetSampleRate = config.sampleRate ?? 16000;
+    }
+    // ── Event subscriptions ──
+    onTranscript(cb) {
+        this.transcriptListeners.push(cb);
+        return () => {
+            const idx = this.transcriptListeners.indexOf(cb);
+            if (idx >= 0)
+                this.transcriptListeners.splice(idx, 1);
+        };
+    }
+    onStateChange(cb) {
+        this.stateListeners.push(cb);
+        return () => {
+            const idx = this.stateListeners.indexOf(cb);
+            if (idx >= 0)
+                this.stateListeners.splice(idx, 1);
+        };
+    }
+    onError(cb) {
+        this.errorListeners.push(cb);
+        return () => {
+            const idx = this.errorListeners.indexOf(cb);
+            if (idx >= 0)
+                this.errorListeners.splice(idx, 1);
+        };
+    }
+    emitTranscript(t) {
+        for (const cb of this.transcriptListeners)
+            cb(t);
+    }
+    emitState(s) {
+        for (const cb of this.stateListeners)
+            cb(s);
+    }
+    emitError(e) {
+        for (const cb of this.errorListeners)
+            cb(e);
+    }
+    // ── Lifecycle ──
+    async start() {
+        this.emitState('loading');
+        try {
+            // Create and init provider
+            this.provider = await createProvider(this.config.provider);
+            this.subscribeProvider(this.provider);
+            await this.provider.init({
+                language: this.config.language,
+                mode: this.config.mode,
+                apiKey: this.config.apiKey,
+                modelId: this.config.modelId,
+                continuous: this.config.continuous,
+                vadEnabled: typeof this.config.vad === 'boolean' ? this.config.vad : !!this.config.vad,
+                vadSilenceMs: typeof this.config.vad === 'object' ? this.config.vad.silenceMs : undefined,
+                sampleRate: this.targetSampleRate,
+            });
+            // web-speech handles its own microphone
+            if (this.config.provider === 'web-speech') {
+                this.provider.start();
+                return;
+            }
+            // Set up audio source
+            this.source = this.resolveSource();
+            await this.source.start();
+            // Set up VAD if enabled
+            if (this.config.vad) {
+                const vadConfig = typeof this.config.vad === 'object' ? {
+                    silenceThresholdMs: this.config.vad.silenceMs,
+                    speechThresholdDb: this.config.vad.thresholdDb,
+                } : undefined;
+                this.vad = createVAD(vadConfig);
+            }
+            // Set up audio buffer for batch mode
+            this.buffer = createAudioBuffer({ sampleRate: this.targetSampleRate });
+            // Wire audio pipeline
+            this.sourceUnsub = this.source.onAudioData((pcm, sampleRate) => {
+                this.processAudio(pcm, sampleRate);
+            });
+            this.provider.start();
+        }
+        catch (err) {
+            const error = {
+                code: 'unknown',
+                message: err instanceof Error ? err.message : String(err),
+                provider: this.config.provider,
+            };
+            this.emitError(error);
+            this.emitState('error');
+            // Attempt fallback
+            if (this.config.fallback) {
+                await this.switchToFallback();
+            }
+        }
+    }
+    stop() {
+        this.provider?.stop();
+        this.sourceUnsub?.();
+        this.sourceUnsub = null;
+        this.source?.stop();
+        this.vad?.reset();
+        this.buffer?.clear();
+    }
+    abort() {
+        this.provider?.abort();
+        this.sourceUnsub?.();
+        this.sourceUnsub = null;
+        this.source?.stop();
+        this.vad?.reset();
+        this.buffer?.clear();
+    }
+    dispose() {
+        this.abort();
+        for (const unsub of this.providerUnsubs)
+            unsub();
+        this.providerUnsubs.length = 0;
+        this.provider?.dispose();
+        this.provider = null;
+        this.source?.dispose();
+        this.source = null;
+        this.transcriptListeners.length = 0;
+        this.stateListeners.length = 0;
+        this.errorListeners.length = 0;
+    }
+    // ── Internal ──
+    resolveSource() {
+        const src = this.config.source;
+        if (!src || src === 'microphone') {
+            return new MicrophoneSource();
+        }
+        if (src === 'glass-bridge') {
+            throw new Error('glass-bridge source requires a GlassBridgeSource instance. ' +
+                'Pass an AudioSource object directly via config.source.');
+        }
+        // Custom AudioSource instance
+        return src;
+    }
+    processAudio(pcm, sampleRate) {
+        // Resample if needed
+        let samples = sampleRate !== this.targetSampleRate
+            ? resample(pcm, sampleRate, this.targetSampleRate)
+            : pcm;
+        if (!this.buffer)
+            return;
+        // If VAD is enabled, check for speech boundaries
+        if (this.vad) {
+            const result = this.vad.process(samples);
+            if (result.isSpeech || result.speechEnded) {
+                this.buffer.append(samples);
+            }
+            if (result.speechEnded) {
+                this.flushBuffer();
+            }
+        }
+        else {
+            // No VAD: accumulate everything, provider handles streaming
+            this.buffer.append(samples);
+        }
+    }
+    async flushBuffer() {
+        if (!this.buffer || !this.provider)
+            return;
+        const audio = this.buffer.getAll();
+        this.buffer.clear();
+        if (audio.length === 0)
+            return;
+        // If provider supports batch transcription
+        if (this.provider.transcribe) {
+            try {
+                const transcript = await this.provider.transcribe(audio, this.targetSampleRate);
+                this.emitTranscript(transcript);
+            }
+            catch (err) {
+                this.emitError({
+                    code: 'unknown',
+                    message: err instanceof Error ? err.message : String(err),
+                    provider: this.config.provider,
+                });
+            }
+        }
+    }
+    subscribeProvider(provider) {
+        this.providerUnsubs.push(provider.onTranscript((t) => this.emitTranscript(t)), provider.onStateChange((s) => this.emitState(s)), provider.onError((e) => {
+            this.emitError(e);
+            if (this.config.fallback) {
+                this.switchToFallback();
+            }
+        }));
+    }
+    async switchToFallback() {
+        if (!this.config.fallback)
+            return;
+        // Clean up current provider
+        for (const unsub of this.providerUnsubs)
+            unsub();
+        this.providerUnsubs.length = 0;
+        this.provider?.dispose();
+        this.provider = null;
+        // Switch to fallback
+        const fallbackType = this.config.fallback;
+        this.config = { ...this.config, provider: fallbackType, fallback: undefined };
+        try {
+            await this.start();
+        }
+        catch {
+            // Fallback also failed — nothing more to do
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/stt/engine.js.map

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

package/dist/stt/i18n.d.ts

@@ -0,0 +1,13 @@
+/** Language mapping utilities for STT providers */
+/** BCP 47 → Whisper ISO 639-1 */
+export declare function toWhisperLang(bcp47: string): string;
+/** Short code → BCP 47 (best guess) */
+export declare function toWebSpeechLang(lang: string): string;
+export interface SupportedLanguage {
+    code: string;
+    name: string;
+    whisper: boolean;
+    webSpeech: boolean;
+}
+export declare const SUPPORTED_LANGUAGES: SupportedLanguage[];
+//# sourceMappingURL=i18n.d.ts.map

package/dist/stt/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../stt/i18n.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,iCAAiC;AACjC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAalD,CAAC"}

package/dist/stt/i18n.js

@@ -0,0 +1,31 @@
+/** Language mapping utilities for STT providers */
+/** BCP 47 → Whisper ISO 639-1 */
+export function toWhisperLang(bcp47) {
+    return bcp47.split('-')[0].toLowerCase();
+}
+/** Short code → BCP 47 (best guess) */
+export function toWebSpeechLang(lang) {
+    const map = {
+        en: 'en-US', it: 'it-IT', es: 'es-ES', fr: 'fr-FR',
+        de: 'de-DE', pt: 'pt-BR', zh: 'zh-CN', ja: 'ja-JP',
+        ko: 'ko-KR', ru: 'ru-RU', ar: 'ar-SA', hi: 'hi-IN',
+    };
+    if (lang.includes('-'))
+        return lang;
+    return map[lang.toLowerCase()] ?? `${lang}-${lang.toUpperCase()}`;
+}
+export const SUPPORTED_LANGUAGES = [
+    { code: 'en-US', name: 'English', whisper: true, webSpeech: true },
+    { code: 'it-IT', name: 'Italian', whisper: true, webSpeech: true },
+    { code: 'es-ES', name: 'Spanish', whisper: true, webSpeech: true },
+    { code: 'fr-FR', name: 'French', whisper: true, webSpeech: true },
+    { code: 'de-DE', name: 'German', whisper: true, webSpeech: true },
+    { code: 'pt-BR', name: 'Portuguese', whisper: true, webSpeech: true },
+    { code: 'zh-CN', name: 'Chinese', whisper: true, webSpeech: true },
+    { code: 'ja-JP', name: 'Japanese', whisper: true, webSpeech: true },
+    { code: 'ko-KR', name: 'Korean', whisper: true, webSpeech: true },
+    { code: 'ru-RU', name: 'Russian', whisper: true, webSpeech: true },
+    { code: 'ar-SA', name: 'Arabic', whisper: true, webSpeech: true },
+    { code: 'hi-IN', name: 'Hindi', whisper: true, webSpeech: true },
+];
+//# sourceMappingURL=i18n.js.map

package/dist/stt/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../stt/i18n.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,iCAAiC;AACjC,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,GAAG,GAA2B;QAClC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO;QAClD,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO;QAClD,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO;KACnD,CAAC;IACF,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;AACpE,CAAC;AASD,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IAClE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IAClE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IAClE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IACjE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IACjE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IACrE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IAClE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IACnE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IACjE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IAClE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IACjE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;CACjE,CAAC"}

package/dist/stt/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types';
+export { STTEngine } from './engine';
+export { createProvider } from './registry';
+export * from './i18n';
+export { MicrophoneSource } from './sources/microphone';
+export { GlassBridgeSource } from './sources/glass-bridge';
+export * from './audio/pcm-utils';
+export * from './audio/resample';
+export * from './audio/vad';
+export { createAudioBuffer } from './audio/buffer';
+//# sourceMappingURL=index.d.ts.map

package/dist/stt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../stt/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/stt/index.js

@@ -0,0 +1,11 @@
+export * from './types';
+export { STTEngine } from './engine';
+export { createProvider } from './registry';
+export * from './i18n';
+export { MicrophoneSource } from './sources/microphone';
+export { GlassBridgeSource } from './sources/glass-bridge';
+export * from './audio/pcm-utils';
+export * from './audio/resample';
+export * from './audio/vad';
+export { createAudioBuffer } from './audio/buffer';
+//# sourceMappingURL=index.js.map

package/dist/stt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../stt/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/stt/providers/deepgram.d.ts

@@ -0,0 +1,29 @@
+import type { STTProvider, STTProviderConfig, STTMode, STTState, STTTranscript, STTError } from '../types';
+export declare class DeepgramProvider implements STTProvider {
+    readonly type: "deepgram";
+    readonly supportedModes: STTMode[];
+    private _state;
+    private apiKey;
+    private language;
+    private modelId;
+    private ws;
+    private transcriptCbs;
+    private stateCbs;
+    private errorCbs;
+    get state(): STTState;
+    init(config: STTProviderConfig): Promise<void>;
+    start(): void;
+    /** Send raw audio data (PCM Int16 or Float32 as ArrayBuffer) to the Deepgram stream. */
+    sendAudio(data: ArrayBuffer | Int16Array | Float32Array): void;
+    stop(): void;
+    abort(): void;
+    dispose(): void;
+    onTranscript(cb: (t: STTTranscript) => void): () => void;
+    onStateChange(cb: (s: STTState) => void): () => void;
+    onError(cb: (e: STTError) => void): () => void;
+    private closeSocket;
+    private setState;
+    private emitTranscript;
+    private emitError;
+}
+//# sourceMappingURL=deepgram.d.ts.map