Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

2.5 KB
Raw Blame
import { describe, it, expect } from 'vitest';
import {
	createTTS,
	createSTT,
	BrowserTTS,
	BrowserSTT,
	ElevenLabsTTS,
} from '../src/runtime/speech.js';

describe('createTTS', () => {
	it('returns a BrowserTTS for provider "browser"', () => {
		const tts = createTTS({ provider: 'browser' });
		expect(tts).toBeInstanceOf(BrowserTTS);
	});

	it('returns an ElevenLabsTTS for provider "elevenlabs"', () => {
		const tts = createTTS({ provider: 'elevenlabs', voiceId: 'test-voice' });
		expect(tts).toBeInstanceOf(ElevenLabsTTS);
	});

	it('returns null for provider "none"', () => {
		expect(createTTS({ provider: 'none' })).toBeNull();
	});

	it('defaults to BrowserTTS when no provider is given', () => {
		expect(createTTS({})).toBeInstanceOf(BrowserTTS);
	});

	it('throws an honest error for an unknown provider', () => {
		expect(() => createTTS({ provider: 'azure' })).toThrowError(
			/Unknown TTS provider "azure"\..*browser.*elevenlabs/,
		);
	});
});

describe('ElevenLabsTTS defaults', () => {
	it('requires a voiceId', () => {
		expect(() => new ElevenLabsTTS({})).toThrowError(/requires voiceId/);
	});

	it('defaults to the low-latency flash model', () => {
		expect(new ElevenLabsTTS({ voiceId: 'v' }).modelId).toBe('eleven_flash_v2_5');
	});

	it('uses ElevenLabs recommended voice-setting defaults', () => {
		const tts = new ElevenLabsTTS({ voiceId: 'v' });
		expect(tts.stability).toBe(0.5);
		expect(tts.similarityBoost).toBe(0.75);
		expect(tts.useSpeakerBoost).toBe(true);
	});

	it('lets callers override model and settings per instance', () => {
		const tts = new ElevenLabsTTS({
			voiceId: 'v',
			modelId: 'eleven_multilingual_v2',
			stability: 0.2,
			similarityBoost: 0.9,
			useSpeakerBoost: false,
		});
		expect(tts.modelId).toBe('eleven_multilingual_v2');
		expect(tts.stability).toBe(0.2);
		expect(tts.similarityBoost).toBe(0.9);
		expect(tts.useSpeakerBoost).toBe(false);
	});
});

describe('createSTT', () => {
	it('returns a BrowserSTT for provider "browser"', () => {
		expect(createSTT({ provider: 'browser' })).toBeInstanceOf(BrowserSTT);
	});

	it('returns null for provider "none"', () => {
		expect(createSTT({ provider: 'none' })).toBeNull();
	});

	it('defaults to BrowserSTT when no provider is given', () => {
		expect(createSTT({})).toBeInstanceOf(BrowserSTT);
	});

	it('throws an honest error for an unknown provider', () => {
		expect(() => createSTT({ provider: 'deepgram' })).toThrowError(
			/Unknown STT provider "deepgram"\..*browser/,
		);
	});
});