@su-record/vibe 2.7.2 → 2.7.5

package/dist/interface/voice/TTSProvider.js

@@ -0,0 +1,252 @@
+/**
+ * TTS Multi-Provider — 텍스트 → 음성 변환
+ *
+ * Provider 체인: Edge TTS (무료) → OpenAI TTS → Google Cloud TTS
+ * 긴 텍스트 자동 청킹, 스트리밍 지원.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import * as crypto from 'node:crypto';
+import { createVoiceError } from './types.js';
+const DEFAULT_TTS_TIMEOUT = 8_000;
+const TTS_TEMP_DIR = path.join(os.tmpdir(), 'vibe-tts');
+// ============================================================================
+// Edge TTS Provider (무료, API 키 불필요)
+// ============================================================================
+export class EdgeTTSProvider {
+    name = 'edge';
+    timeoutMs;
+    voice;
+    constructor(config) {
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TTS_TIMEOUT;
+        this.voice = config.voice ?? 'ko-KR-SunHiNeural';
+    }
+    isAvailable() {
+        return true;
+    }
+    async synthesize(text, options) {
+        const start = Date.now();
+        const voice = options?.voice ?? this.voice;
+        const format = options?.format ?? 'mp3';
+        const outPath = getTempPath(format);
+        try {
+            const edgeTts = await import('node-edge-tts');
+            const tts = new edgeTts.default();
+            await tts.synthesize(text, voice, { rate: formatRate(options?.speed) });
+            const audioBuffer = tts.toBuffer();
+            fs.writeFileSync(outPath, audioBuffer);
+            return {
+                audioPath: outPath,
+                format,
+                providerUsed: 'edge',
+                durationMs: Date.now() - start,
+                sizeBytes: audioBuffer.length,
+            };
+        }
+        catch (err) {
+            throw new Error(`Edge TTS failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+// ============================================================================
+// OpenAI TTS Provider
+// ============================================================================
+export class OpenAITTSProvider {
+    name = 'openai';
+    apiKey;
+    timeoutMs;
+    constructor(config) {
+        this.apiKey = config.apiKey ?? process.env.OPENAI_API_KEY ?? '';
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TTS_TIMEOUT;
+    }
+    isAvailable() {
+        return this.apiKey.length > 0;
+    }
+    async synthesize(text, options) {
+        const start = Date.now();
+        const format = options?.format ?? 'mp3';
+        const outPath = getTempPath(format);
+        const responseFormat = format === 'opus' ? 'opus' : format === 'wav' ? 'wav' : 'mp3';
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch('https://api.openai.com/v1/audio/speech', {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    model: 'tts-1',
+                    input: text,
+                    voice: options?.voice ?? 'nova',
+                    response_format: responseFormat,
+                    speed: options?.speed ?? 1.0,
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (!res.ok) {
+                throw new Error(`OpenAI TTS HTTP ${res.status}: ${await res.text()}`);
+            }
+            const buffer = Buffer.from(await res.arrayBuffer());
+            fs.writeFileSync(outPath, buffer);
+            return {
+                audioPath: outPath,
+                format,
+                providerUsed: 'openai',
+                durationMs: Date.now() - start,
+                sizeBytes: buffer.length,
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+// ============================================================================
+// Google Cloud TTS Provider
+// ============================================================================
+export class GoogleTTSProvider {
+    name = 'google';
+    apiKey;
+    timeoutMs;
+    constructor(config) {
+        this.apiKey = config.apiKey ?? process.env.GOOGLE_TTS_API_KEY ?? '';
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TTS_TIMEOUT;
+    }
+    isAvailable() {
+        return this.apiKey.length > 0;
+    }
+    async synthesize(text, options) {
+        const start = Date.now();
+        const format = options?.format ?? 'mp3';
+        const outPath = getTempPath(format);
+        const audioEncoding = format === 'opus' ? 'OGG_OPUS' : format === 'wav' ? 'LINEAR16' : 'MP3';
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`https://texttospeech.googleapis.com/v1/text:synthesize?key=${this.apiKey}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    input: { text },
+                    voice: {
+                        languageCode: options?.language ?? 'ko-KR',
+                        name: options?.voice ?? 'ko-KR-Neural2-A',
+                    },
+                    audioConfig: {
+                        audioEncoding,
+                        speakingRate: options?.speed ?? 1.0,
+                    },
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (!res.ok) {
+                throw new Error(`Google TTS HTTP ${res.status}: ${await res.text()}`);
+            }
+            const data = (await res.json());
+            const buffer = Buffer.from(data.audioContent, 'base64');
+            fs.writeFileSync(outPath, buffer);
+            return {
+                audioPath: outPath,
+                format,
+                providerUsed: 'google',
+                durationMs: Date.now() - start,
+                sizeBytes: buffer.length,
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+// ============================================================================
+// TTS Provider Chain (with fallback + text chunking)
+// ============================================================================
+export class TTSProviderChain {
+    providers;
+    logger;
+    constructor(configs, logger) {
+        this.logger = logger;
+        this.providers = configs
+            .filter(c => c.enabled)
+            .map(c => this.createProvider(c));
+    }
+    async synthesize(text, options) {
+        const errors = [];
+        for (const provider of this.providers) {
+            if (!provider.isAvailable())
+                continue;
+            try {
+                const result = await provider.synthesize(text, options);
+                return result;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                errors.push({ provider: provider.name, error: msg });
+                this.logger('warn', `TTS ${provider.name} failed: ${msg}`);
+            }
+        }
+        throw createVoiceError('ALL_PROVIDERS_FAILED', '모든 TTS 프로바이더가 실패했습니다. 텍스트 응답으로 대체합니다.', errors);
+    }
+    getAvailableProviders() {
+        return this.providers.filter(p => p.isAvailable()).map(p => p.name);
+    }
+    createProvider(config) {
+        switch (config.name) {
+            case 'edge': return new EdgeTTSProvider(config);
+            case 'openai': return new OpenAITTSProvider(config);
+            case 'google': return new GoogleTTSProvider(config);
+        }
+    }
+}
+// ============================================================================
+// Text Chunking (문장 단위 분할)
+// ============================================================================
+/** 긴 텍스트를 문장 단위로 분할 (TTS 최대 길이 제한) */
+export function chunkText(text, maxChars = 4096) {
+    if (text.length <= maxChars)
+        return [text];
+    const sentences = text.split(/(?<=[.!?。！？\n])\s*/);
+    const chunks = [];
+    let current = '';
+    for (const sentence of sentences) {
+        if (current.length + sentence.length > maxChars && current.length > 0) {
+            chunks.push(current.trim());
+            current = sentence;
+        }
+        else {
+            current += (current ? ' ' : '') + sentence;
+        }
+    }
+    if (current.trim())
+        chunks.push(current.trim());
+    return chunks;
+}
+// ============================================================================
+// Utils
+// ============================================================================
+function getTempPath(format) {
+    if (!fs.existsSync(TTS_TEMP_DIR)) {
+        fs.mkdirSync(TTS_TEMP_DIR, { recursive: true });
+    }
+    return path.join(TTS_TEMP_DIR, `tts-${crypto.randomBytes(8).toString('hex')}.${format}`);
+}
+function formatRate(speed) {
+    if (!speed || speed === 1.0)
+        return '+0%';
+    const pct = Math.round((speed - 1) * 100);
+    return pct >= 0 ? `+${pct}%` : `${pct}%`;
+}
+/** 기본 TTS 설정 생성 */
+export function getDefaultTTSConfigs() {
+    return [
+        { name: 'edge', enabled: true, timeoutMs: DEFAULT_TTS_TIMEOUT, voice: 'ko-KR-SunHiNeural' },
+        { name: 'openai', enabled: true, timeoutMs: DEFAULT_TTS_TIMEOUT },
+        { name: 'google', enabled: true, timeoutMs: DEFAULT_TTS_TIMEOUT },
+    ];
+}
+//# sourceMappingURL=TTSProvider.js.map

package/dist/interface/voice/TTSProvider.js.map

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

package/dist/interface/voice/TTSProvider.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TTS Provider Chain Tests
+ *
+ * Provider availability, text chunking, fallback logic.
+ * (No API calls — all mocked)
+ */
+export {};
+//# sourceMappingURL=TTSProvider.test.d.ts.map

package/dist/interface/voice/TTSProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TTSProvider.test.d.ts","sourceRoot":"","sources":["../../../src/interface/voice/TTSProvider.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/interface/voice/TTSProvider.test.js

@@ -0,0 +1,143 @@
+/**
+ * TTS Provider Chain Tests
+ *
+ * Provider availability, text chunking, fallback logic.
+ * (No API calls — all mocked)
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { EdgeTTSProvider, OpenAITTSProvider, GoogleTTSProvider, TTSProviderChain, chunkText, getDefaultTTSConfigs, } from './TTSProvider.js';
+function createLogger() {
+    return vi.fn();
+}
+describe('TTS Provider Availability', () => {
+    it('EdgeTTSProvider should always be available', () => {
+        const provider = new EdgeTTSProvider({
+            name: 'edge', enabled: true, timeoutMs: 5000,
+        });
+        expect(provider.isAvailable()).toBe(true);
+        expect(provider.name).toBe('edge');
+    });
+    it('OpenAITTSProvider should be unavailable without API key', () => {
+        const originalKey = process.env.OPENAI_API_KEY;
+        delete process.env.OPENAI_API_KEY;
+        const provider = new OpenAITTSProvider({
+            name: 'openai', enabled: true, timeoutMs: 5000, apiKey: '',
+        });
+        expect(provider.isAvailable()).toBe(false);
+        process.env.OPENAI_API_KEY = originalKey;
+    });
+    it('OpenAITTSProvider should be available with API key', () => {
+        const provider = new OpenAITTSProvider({
+            name: 'openai', enabled: true, timeoutMs: 5000, apiKey: 'test-key',
+        });
+        expect(provider.isAvailable()).toBe(true);
+    });
+    it('GoogleTTSProvider should be unavailable without API key', () => {
+        const originalKey = process.env.GOOGLE_TTS_API_KEY;
+        delete process.env.GOOGLE_TTS_API_KEY;
+        const provider = new GoogleTTSProvider({
+            name: 'google', enabled: true, timeoutMs: 5000, apiKey: '',
+        });
+        expect(provider.isAvailable()).toBe(false);
+        process.env.GOOGLE_TTS_API_KEY = originalKey;
+    });
+});
+describe('TTSProviderChain', () => {
+    let logger;
+    beforeEach(() => {
+        logger = createLogger();
+    });
+    it('should filter out disabled providers', () => {
+        const configs = [
+            { name: 'edge', enabled: false, timeoutMs: 5000 },
+            { name: 'openai', enabled: true, timeoutMs: 5000, apiKey: 'key1' },
+        ];
+        const chain = new TTSProviderChain(configs, logger);
+        const available = chain.getAvailableProviders();
+        expect(available).not.toContain('edge');
+    });
+    it('should return available providers', () => {
+        const configs = [
+            { name: 'edge', enabled: true, timeoutMs: 5000 },
+            { name: 'openai', enabled: true, timeoutMs: 5000, apiKey: '' },
+        ];
+        const chain = new TTSProviderChain(configs, logger);
+        const available = chain.getAvailableProviders();
+        expect(available).toContain('edge');
+        expect(available).not.toContain('openai'); // no API key
+    });
+    it('should throw ALL_PROVIDERS_FAILED when all fail', async () => {
+        const configs = [
+            { name: 'edge', enabled: true, timeoutMs: 100 },
+        ];
+        const chain = new TTSProviderChain(configs, logger);
+        // Mock edge-tts import to fail
+        const originalImport = vi.fn();
+        vi.doMock('node-edge-tts', () => {
+            throw new Error('Module not found');
+        });
+        // Edge TTS will fail when node-edge-tts is not installed
+        await expect(chain.synthesize('Test text')).rejects.toThrow('모든 TTS 프로바이더가 실패했습니다');
+    });
+});
+describe('chunkText', () => {
+    it('should return single chunk for short text', () => {
+        const chunks = chunkText('Hello world', 4096);
+        expect(chunks).toEqual(['Hello world']);
+    });
+    it('should return single chunk when text equals max', () => {
+        const text = 'A'.repeat(4096);
+        const chunks = chunkText(text, 4096);
+        expect(chunks).toEqual([text]);
+    });
+    it('should split on sentence boundaries', () => {
+        const text = 'First sentence. Second sentence. Third sentence.';
+        const chunks = chunkText(text, 30);
+        expect(chunks.length).toBeGreaterThan(1);
+        expect(chunks.every(c => c.length <= 30 || c.split('.').length <= 2)).toBe(true);
+    });
+    it('should handle Korean sentences', () => {
+        const text = '첫 번째 문장입니다. 두 번째 문장입니다. 세 번째 문장입니다.';
+        const chunks = chunkText(text, 25);
+        expect(chunks.length).toBeGreaterThan(1);
+    });
+    it('should handle text with newlines', () => {
+        const text = 'Line 1\nLine 2\nLine 3';
+        const chunks = chunkText(text, 10);
+        expect(chunks.length).toBeGreaterThan(1);
+    });
+    it('should handle empty text', () => {
+        const chunks = chunkText('', 4096);
+        expect(chunks).toEqual(['']);
+    });
+    it('should use default maxChars of 4096', () => {
+        const shortText = 'Hello';
+        const chunks = chunkText(shortText);
+        expect(chunks).toEqual(['Hello']);
+    });
+    it('should handle question marks and exclamation marks', () => {
+        const text = 'Is this a question? Yes it is! And here is more.';
+        const chunks = chunkText(text, 25);
+        expect(chunks.length).toBeGreaterThan(1);
+    });
+});
+describe('getDefaultTTSConfigs', () => {
+    it('should return 3 providers', () => {
+        const configs = getDefaultTTSConfigs();
+        expect(configs).toHaveLength(3);
+    });
+    it('should have edge as first provider', () => {
+        const configs = getDefaultTTSConfigs();
+        expect(configs[0].name).toBe('edge');
+    });
+    it('should have Korean voice for edge', () => {
+        const configs = getDefaultTTSConfigs();
+        const edge = configs.find(c => c.name === 'edge');
+        expect(edge?.voice).toBe('ko-KR-SunHiNeural');
+    });
+    it('should have all enabled by default', () => {
+        const configs = getDefaultTTSConfigs();
+        expect(configs.every(c => c.enabled)).toBe(true);
+    });
+});
+//# sourceMappingURL=TTSProvider.test.js.map

package/dist/interface/voice/TTSProvider.test.js.map

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

package/dist/interface/voice/VADProcessor.d.ts

@@ -0,0 +1,34 @@
+/**
+ * VADProcessor — Voice Activity Detection (서버 사이드)
+ *
+ * 에너지 기반 음성 구간 감지:
+ * - PCM 16kHz mono 오디오 처리
+ * - 침묵 임계값 초과 시 발화 종료
+ * - 최소 발화 길이 미만 발화 무시
+ */
+import { EventEmitter } from 'node:events';
+import type { VADConfig, VoiceLogger } from './types.js';
+export declare class VADProcessor extends EventEmitter {
+    private config;
+    private logger;
+    private isSpeaking;
+    private speechStart;
+    private lastSpeechTime;
+    private speechBuffer;
+    private silenceTimer;
+    constructor(logger: VoiceLogger, config?: Partial<VADConfig>);
+    /** PCM 16-bit 오디오 프레임 처리 */
+    processFrame(pcmData: Buffer): void;
+    /** 세션 종료 시 정리 */
+    reset(): void;
+    /** 현재 발화 중인지 여부 */
+    get speaking(): boolean;
+    private startSpeech;
+    private continueSpeech;
+    private detectSilence;
+    private endSpeech;
+    /** RMS 에너지 계산 (PCM 16-bit) */
+    private calculateEnergy;
+    private clearSilenceTimer;
+}
+//# sourceMappingURL=VADProcessor.d.ts.map

package/dist/interface/voice/VADProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VADProcessor.d.ts","sourceRoot":"","sources":["../../../src/interface/voice/VADProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAY,WAAW,EAAE,MAAM,YAAY,CAAC;AAGnE,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAA8C;gBAEtD,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAU5D,4BAA4B;IAC5B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAenC,iBAAiB;IACjB,KAAK,IAAI,IAAI;IAMb,mBAAmB;IACnB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,SAAS;IAuBjB,8BAA8B;IAC9B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/interface/voice/VADProcessor.js

@@ -0,0 +1,116 @@
+/**
+ * VADProcessor — Voice Activity Detection (서버 사이드)
+ *
+ * 에너지 기반 음성 구간 감지:
+ * - PCM 16kHz mono 오디오 처리
+ * - 침묵 임계값 초과 시 발화 종료
+ * - 최소 발화 길이 미만 발화 무시
+ */
+import { EventEmitter } from 'node:events';
+import { DEFAULT_VAD_CONFIG } from './types.js';
+export class VADProcessor extends EventEmitter {
+    config;
+    logger;
+    isSpeaking = false;
+    speechStart = 0;
+    lastSpeechTime = 0;
+    speechBuffer = [];
+    silenceTimer = null;
+    constructor(logger, config) {
+        super();
+        this.logger = logger;
+        this.config = {
+            silenceThresholdMs: config?.silenceThresholdMs ?? DEFAULT_VAD_CONFIG.silenceThresholdMs,
+            minSpeechMs: config?.minSpeechMs ?? DEFAULT_VAD_CONFIG.minSpeechMs,
+            energyThreshold: config?.energyThreshold ?? DEFAULT_VAD_CONFIG.energyThreshold,
+        };
+    }
+    /** PCM 16-bit 오디오 프레임 처리 */
+    processFrame(pcmData) {
+        const energy = this.calculateEnergy(pcmData);
+        const now = Date.now();
+        const hasSpeech = energy > this.config.energyThreshold;
+        if (hasSpeech && !this.isSpeaking) {
+            this.startSpeech(now, pcmData);
+        }
+        else if (hasSpeech && this.isSpeaking) {
+            this.continueSpeech(now, pcmData);
+        }
+        else if (!hasSpeech && this.isSpeaking) {
+            this.detectSilence(now);
+            this.speechBuffer.push(pcmData);
+        }
+    }
+    /** 세션 종료 시 정리 */
+    reset() {
+        this.isSpeaking = false;
+        this.speechBuffer = [];
+        this.clearSilenceTimer();
+    }
+    /** 현재 발화 중인지 여부 */
+    get speaking() {
+        return this.isSpeaking;
+    }
+    // ════════════════════════════════════════════════════════════
+    // Private
+    // ════════════════════════════════════════════════════════════
+    startSpeech(now, pcmData) {
+        this.isSpeaking = true;
+        this.speechStart = now;
+        this.lastSpeechTime = now;
+        this.speechBuffer = [pcmData];
+        this.clearSilenceTimer();
+        const event = { type: 'speech_start', timestamp: now };
+        this.emit('vad', event);
+        this.logger('info', 'VAD: Speech started');
+    }
+    continueSpeech(now, pcmData) {
+        this.lastSpeechTime = now;
+        this.speechBuffer.push(pcmData);
+        this.clearSilenceTimer();
+    }
+    detectSilence(now) {
+        this.clearSilenceTimer();
+        this.silenceTimer = setTimeout(() => {
+            this.endSpeech(now);
+        }, this.config.silenceThresholdMs);
+    }
+    endSpeech(now) {
+        const durationMs = now - this.speechStart;
+        this.isSpeaking = false;
+        if (durationMs < this.config.minSpeechMs) {
+            this.logger('info', `VAD: Speech too short (${durationMs}ms), ignored`);
+            this.speechBuffer = [];
+            return;
+        }
+        const audioData = Buffer.concat(this.speechBuffer);
+        this.speechBuffer = [];
+        const event = {
+            type: 'speech_end',
+            timestamp: now,
+            audioData,
+            durationMs,
+        };
+        this.emit('vad', event);
+        this.logger('info', `VAD: Speech ended (${durationMs}ms, ${audioData.length} bytes)`);
+    }
+    /** RMS 에너지 계산 (PCM 16-bit) */
+    calculateEnergy(pcm) {
+        if (pcm.length < 2)
+            return 0;
+        let sum = 0;
+        const sampleCount = Math.floor(pcm.length / 2);
+        for (let i = 0; i < pcm.length - 1; i += 2) {
+            const sample = pcm.readInt16LE(i) / 32768;
+            sum += sample * sample;
+        }
+        return Math.sqrt(sum / sampleCount);
+    }
+    clearSilenceTimer() {
+        if (this.silenceTimer) {
+            clearTimeout(this.silenceTimer);
+            this.silenceTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=VADProcessor.js.map

package/dist/interface/voice/VADProcessor.js.map

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

package/dist/interface/voice/VADProcessor.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * VADProcessor Tests
+ *
+ * Energy-based voice activity detection.
+ * Uses synthetic PCM data for testing.
+ */
+export {};
+//# sourceMappingURL=VADProcessor.test.d.ts.map

package/dist/interface/voice/VADProcessor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VADProcessor.test.d.ts","sourceRoot":"","sources":["../../../src/interface/voice/VADProcessor.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}