@pico-brief/speech-services 1.0.0

package/dist/voice-resolver.js

@@ -0,0 +1,82 @@
+import { SpeechServiceError } from "./errors.js";
+export function resolveVoice(voices, params) {
+    if (params.voice) {
+        return resolveByVoice(voices, params.voice, params.gender);
+    }
+    return resolveByLanguage(voices, params.language, params.gender);
+}
+function resolveByVoice(voices, voice, gender) {
+    const voiceLower = voice.toLowerCase();
+    // 1. Exact match by id
+    const byId = voices.find((v) => v.id.toLowerCase() === voiceLower);
+    if (byId)
+        return byId;
+    // 2. Exact match by name
+    const byName = voices.find((v) => v.name.toLowerCase() === voiceLower);
+    if (byName)
+        return byName;
+    // 3. Fuzzy fallback: try to extract locale from the voice string and match on that
+    const locale = extractLocale(voice);
+    if (locale) {
+        const match = pickByLocale(voices, locale, gender);
+        if (match)
+            return match;
+    }
+    // 4. Broader fallback: try base language
+    if (locale) {
+        const baseLang = locale.split("-")[0].toLowerCase();
+        const match = pickByBaseLanguage(voices, baseLang, gender);
+        if (match)
+            return match;
+    }
+    throw new SpeechServiceError(`Voice "${voice}" not found and no similar voice available`, "VOICE_NOT_FOUND");
+}
+function resolveByLanguage(voices, language, gender) {
+    if (!language) {
+        throw new SpeechServiceError("Either voice or languages must be provided for speech synthesis", "INVALID_INPUT");
+    }
+    // 1. Exact locale match
+    const match = pickByLocale(voices, language, gender);
+    if (match)
+        return match;
+    // 2. Base language match
+    const baseLang = language.split("-")[0].toLowerCase();
+    const baseMatch = pickByBaseLanguage(voices, baseLang, gender);
+    if (baseMatch)
+        return baseMatch;
+    throw new SpeechServiceError(`No voice found for language "${language}"`, "VOICE_NOT_FOUND");
+}
+/** Try to extract a BCP-47 locale from a voice name (e.g. "en-US-JennyNeural" → "en-US") */
+function extractLocale(voice) {
+    const match = voice.match(/^([a-z]{2,3}-[A-Z]{2})/i);
+    if (match) {
+        const parts = match[1].split("-");
+        return `${parts[0].toLowerCase()}-${parts[1].toUpperCase()}`;
+    }
+    return undefined;
+}
+/** Pick the best voice matching an exact locale. Prefer matching gender, but don't require it. */
+function pickByLocale(voices, locale, gender) {
+    const localeLower = locale.toLowerCase();
+    const matches = voices.filter((v) => v.locale.toLowerCase() === localeLower);
+    if (matches.length === 0)
+        return undefined;
+    return preferGender(matches, gender);
+}
+/** Pick the best voice matching a base language (e.g. "en"). Prefer matching gender. */
+function pickByBaseLanguage(voices, baseLang, gender) {
+    const matches = voices.filter((v) => v.locale.split("-")[0].toLowerCase() === baseLang);
+    if (matches.length === 0)
+        return undefined;
+    return preferGender(matches, gender);
+}
+/** From a list of candidates, prefer one matching the requested gender. If none match, return the first. */
+function preferGender(voices, gender) {
+    if (gender) {
+        const genderMatch = voices.find((v) => v.gender === gender);
+        if (genderMatch)
+            return genderMatch;
+    }
+    return voices[0];
+}
+//# sourceMappingURL=voice-resolver.js.map

package/dist/voice-resolver.js.map

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

package/package.json

@@ -0,0 +1,100 @@
+{
+    "name": "@pico-brief/speech-services",
+    "version": "1.0.0",
+    "type": "module",
+    "description": "Unified speech-to-text and text-to-speech library wrapping AssemblyAI, Azure, Cartesia, Deepgram, ElevenLabs, Google, OpenAI, PlayHT, Rev.ai, and Speechmatics",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./providers/assemblyai": {
+            "types": "./dist/providers/assemblyai/index.d.ts",
+            "import": "./dist/providers/assemblyai/index.js"
+        },
+        "./providers/azure": {
+            "types": "./dist/providers/azure/index.d.ts",
+            "import": "./dist/providers/azure/index.js"
+        },
+        "./providers/cartesia": {
+            "types": "./dist/providers/cartesia/index.d.ts",
+            "import": "./dist/providers/cartesia/index.js"
+        },
+        "./providers/deepgram": {
+            "types": "./dist/providers/deepgram/index.d.ts",
+            "import": "./dist/providers/deepgram/index.js"
+        },
+        "./providers/elevenlabs": {
+            "types": "./dist/providers/elevenlabs/index.d.ts",
+            "import": "./dist/providers/elevenlabs/index.js"
+        },
+        "./providers/google": {
+            "types": "./dist/providers/google/index.d.ts",
+            "import": "./dist/providers/google/index.js"
+        },
+        "./providers/openai": {
+            "types": "./dist/providers/openai/index.d.ts",
+            "import": "./dist/providers/openai/index.js"
+        },
+        "./providers/playht": {
+            "types": "./dist/providers/playht/index.d.ts",
+            "import": "./dist/providers/playht/index.js"
+        },
+        "./providers/revai": {
+            "types": "./dist/providers/revai/index.d.ts",
+            "import": "./dist/providers/revai/index.js"
+        },
+        "./providers/speechmatics": {
+            "types": "./dist/providers/speechmatics/index.d.ts",
+            "import": "./dist/providers/speechmatics/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "pretest": "tsc -p tsconfig.test.json",
+        "test": "node --test dist-test/tests/unit/*.test.js dist-test/tests/unit/providers/*.test.js",
+        "pretest:integration": "tsc -p tsconfig.test.json && mkdir -p tests/results",
+        "test:integration": "node --test --test-reporter=spec --test-reporter-destination=stdout --test-reporter=tap --test-reporter-destination=tests/results/integration.tap dist-test/tests/integration/*.test.js",
+        "prepublishOnly": "npm run build"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/PicoBrief/speech-services.git"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "keywords": [
+        "speech-to-text",
+        "text-to-speech",
+        "stt",
+        "tts",
+        "assemblyai",
+        "azure",
+        "cartesia",
+        "deepgram",
+        "elevenlabs",
+        "google",
+        "openai",
+        "playht",
+        "revai",
+        "speechmatics",
+        "transcription",
+        "speech-synthesis"
+    ],
+    "license": "MIT",
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "dotenv": "^17.3.1",
+        "typescript": "^5.0.0"
+    },
+    "dependencies": {
+        "@pico-brief/audio-duration": "^1.0.0"
+    }
+}