@pico-brief/speech-services 1.0.0

package/dist/providers/google/fetch-voices.d.ts

@@ -0,0 +1,3 @@
+import type { GoogleConfig, VoiceInfo } from "../../types.js";
+export declare function fetchVoices(config: GoogleConfig): Promise<VoiceInfo[]>;
+//# sourceMappingURL=fetch-voices.d.ts.map

package/dist/providers/google/fetch-voices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-voices.d.ts","sourceRoot":"","sources":["../../../src/providers/google/fetch-voices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK9D,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAmC5E"}

package/dist/providers/google/fetch-voices.js

@@ -0,0 +1,28 @@
+import { SpeechServiceError } from "../../errors.js";
+import { TTS_BASE_URL } from "./types.js";
+export async function fetchVoices(config) {
+    const response = await fetch(`${TTS_BASE_URL}/voices?key=${config.apiKey}`);
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new SpeechServiceError(`Google voice listing failed: ${errorText}`, "API_ERROR", "google", response.status);
+    }
+    const result = (await response.json());
+    // Google voices can have multiple languageCodes — create one entry per locale
+    const voices = [];
+    for (const v of result.voices ?? []) {
+        const gender = v.ssmlGender?.toLowerCase() === "male" ? "male"
+            : v.ssmlGender?.toLowerCase() === "female" ? "female"
+                : undefined;
+        for (const locale of v.languageCodes ?? []) {
+            voices.push({
+                id: v.name,
+                name: v.name,
+                gender,
+                locale,
+                provider: "google",
+            });
+        }
+    }
+    return voices;
+}
+//# sourceMappingURL=fetch-voices.js.map

package/dist/providers/google/fetch-voices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-voices.js","sourceRoot":"","sources":["../../../src/providers/google/fetch-voices.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB;IAClD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,kBAAkB,CACxB,gCAAgC,SAAS,EAAE,EAC3C,WAAW,EACX,QAAQ,EACR,QAAQ,CAAC,MAAM,CAClB,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmC,CAAC;IAEzE,8EAA8E;IAC9E,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAe;YACnE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAiB;gBAC9D,CAAC,CAAC,SAAS,CAAC;QAEhB,KAAK,MAAM,MAAM,IAAI,CAAC,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC;gBACR,EAAE,EAAE,CAAC,CAAC,IAAI;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM;gBACN,MAAM;gBACN,QAAQ,EAAE,QAAiB;aAC9B,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/providers/google/helpers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Parses Google Cloud duration values which can be either:
+ * - A string like "1.5s"
+ * - An object like { seconds: "1", nanos: 500000000 }
+ */
+export declare function parseGoogleDuration(duration: string | {
+    seconds?: string | number;
+    nanos?: number;
+} | undefined): number;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/providers/google/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/providers/google/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC7E,MAAM,CAQR"}

package/dist/providers/google/helpers.js

@@ -0,0 +1,15 @@
+/**
+ * Parses Google Cloud duration values which can be either:
+ * - A string like "1.5s"
+ * - An object like { seconds: "1", nanos: 500000000 }
+ */
+export function parseGoogleDuration(duration) {
+    if (typeof duration === "string") {
+        return parseFloat(duration.replace("s", "")) || 0;
+    }
+    if (typeof duration === "object" && duration !== null) {
+        return Number(duration.seconds ?? 0) + Number(duration.nanos ?? 0) / 1_000_000_000;
+    }
+    return 0;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/providers/google/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/providers/google/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAC/B,QAA4E;IAE5E,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,aAAa,CAAC;IACvF,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC"}

package/dist/providers/google/index.d.ts

@@ -0,0 +1,4 @@
+export { transcribe } from "./transcribe.js";
+export { synthesize } from "./synthesize.js";
+export { fetchVoices } from "./fetch-voices.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/google/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/google/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/providers/google/index.js

@@ -0,0 +1,4 @@
+export { transcribe } from "./transcribe.js";
+export { synthesize } from "./synthesize.js";
+export { fetchVoices } from "./fetch-voices.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/google/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/google/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/providers/google/synthesize.d.ts

@@ -0,0 +1,3 @@
+import type { GoogleConfig, GoogleSynthesizeOptions, SynthesizeResult } from "../../types.js";
+export declare function synthesize(config: GoogleConfig, text: string, voice: string, language: string | undefined, options?: GoogleSynthesizeOptions): Promise<SynthesizeResult>;
+//# sourceMappingURL=synthesize.d.ts.map

package/dist/providers/google/synthesize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/providers/google/synthesize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAK9F,wBAAsB,UAAU,CAC5B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE,uBAA4B,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAwC3B"}

package/dist/providers/google/synthesize.js

@@ -0,0 +1,35 @@
+import { SpeechServiceError } from "../../errors.js";
+import { detectFormatFromString } from "../../utils.js";
+import { TTS_BASE_URL } from "./types.js";
+export async function synthesize(config, text, voice, language, options = {}) {
+    const { audioEncoding = "MP3", speakingRate, pitch } = options;
+    // Infer language from voice name if not provided (e.g., "en-US-Neural2-A" → "en-US")
+    const lang = language ?? voice.split("-").slice(0, 2).join("-");
+    const audioConfig = { audioEncoding };
+    if (speakingRate !== undefined)
+        audioConfig.speakingRate = speakingRate;
+    if (pitch !== undefined)
+        audioConfig.pitch = pitch;
+    const body = {
+        input: { text },
+        voice: { languageCode: lang, name: voice },
+        audioConfig,
+    };
+    const response = await fetch(`${TTS_BASE_URL}/text:synthesize?key=${config.apiKey}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new SpeechServiceError(`Google TTS failed: ${errorText}`, "API_ERROR", "google", response.status);
+    }
+    const result = (await response.json());
+    const audioBuffer = Buffer.from(result.audioContent, "base64");
+    return {
+        audio: audioBuffer,
+        format: detectFormatFromString(audioEncoding),
+        voice,
+    };
+}
+//# sourceMappingURL=synthesize.js.map

package/dist/providers/google/synthesize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.js","sourceRoot":"","sources":["../../../src/providers/google/synthesize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,UAAU,CAC5B,MAAoB,EACpB,IAAY,EACZ,KAAa,EACb,QAA4B,EAC5B,UAAmC,EAAE;IAErC,MAAM,EAAE,aAAa,GAAG,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAE/D,qFAAqF;IACrF,MAAM,IAAI,GAAG,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhE,MAAM,WAAW,GAA4B,EAAE,aAAa,EAAE,CAAC;IAC/D,IAAI,YAAY,KAAK,SAAS;QAAE,WAAW,CAAC,YAAY,GAAG,YAAY,CAAC;IACxE,IAAI,KAAK,KAAK,SAAS;QAAE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;IAEnD,MAAM,IAAI,GAAG;QACT,KAAK,EAAE,EAAE,IAAI,EAAE;QACf,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;QAC1C,WAAW;KACd,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,wBAAwB,MAAM,CAAC,MAAM,EAAE,EAAE;QACjF,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC7B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,kBAAkB,CACxB,sBAAsB,SAAS,EAAE,EACjC,WAAW,EACX,QAAQ,EACR,QAAQ,CAAC,MAAM,CAClB,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6B,CAAC;IACnE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAE/D,OAAO;QACH,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,sBAAsB,CAAC,aAAa,CAAC;QAC7C,KAAK;KACR,CAAC;AACN,CAAC"}

package/dist/providers/google/transcribe.d.ts

@@ -0,0 +1,3 @@
+import type { GoogleConfig, GoogleTranscribeOptions, TranscribeResult } from "../../types.js";
+export declare function transcribe(config: GoogleConfig, audio: Buffer | string, languages: string[] | undefined, options?: GoogleTranscribeOptions): Promise<TranscribeResult>;
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/providers/google/transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../../../src/providers/google/transcribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAEnB,MAAM,gBAAgB,CAAC;AAOxB,wBAAsB,UAAU,CAC5B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,OAAO,GAAE,uBAA4B,GACtC,OAAO,CAAC,gBAAgB,CAAC,CA8D3B"}

package/dist/providers/google/transcribe.js

@@ -0,0 +1,117 @@
+import { SpeechServiceError } from "../../errors.js";
+import { isUrl, downloadAudio, poll } from "../../utils.js";
+import { STT_BASE_URL } from "./types.js";
+import { parseGoogleDuration } from "./helpers.js";
+export async function transcribe(config, audio, languages, options = {}) {
+    const { model = "latest_long", encoding, sampleRateHertz } = options;
+    const primaryLanguage = languages?.[0] ?? "en-US";
+    const altLanguages = languages?.slice(1, 4) ?? [];
+    const recognitionConfig = {
+        languageCode: primaryLanguage,
+        model,
+        enableWordTimeOffsets: true,
+        enableWordConfidence: true,
+        enableAutomaticPunctuation: true,
+    };
+    if (altLanguages.length > 0) {
+        recognitionConfig.alternativeLanguageCodes = altLanguages;
+    }
+    if (encoding)
+        recognitionConfig.encoding = encoding;
+    if (sampleRateHertz)
+        recognitionConfig.sampleRateHertz = sampleRateHertz;
+    // Determine if we should use async mode (GCS URIs)
+    if (typeof audio === "string" && audio.startsWith("gs://")) {
+        return transcribeAsync(config, audio, recognitionConfig);
+    }
+    // Sync mode: Buffer or HTTP URL
+    let audioBuffer;
+    if (Buffer.isBuffer(audio)) {
+        audioBuffer = audio;
+    }
+    else if (typeof audio === "string" && isUrl(audio)) {
+        audioBuffer = await downloadAudio(audio);
+    }
+    else {
+        throw new SpeechServiceError("audio must be a Buffer, HTTP URL, or gs:// URI", "INVALID_INPUT", "google");
+    }
+    const body = {
+        config: recognitionConfig,
+        audio: { content: audioBuffer.toString("base64") },
+    };
+    const response = await fetch(`${STT_BASE_URL}/speech:recognize?key=${config.apiKey}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new SpeechServiceError(`Google STT failed: ${errorText}`, "API_ERROR", "google", response.status);
+    }
+    const result = (await response.json());
+    return normalizeResponse(result, primaryLanguage);
+}
+async function transcribeAsync(config, gcsUri, recognitionConfig) {
+    const body = {
+        config: recognitionConfig,
+        audio: { uri: gcsUri },
+    };
+    const response = await fetch(`${STT_BASE_URL}/speech:longrunningrecognize?key=${config.apiKey}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new SpeechServiceError(`Google async STT failed: ${errorText}`, "API_ERROR", "google", response.status);
+    }
+    const operation = (await response.json());
+    const finalOp = await poll(async () => {
+        const res = await fetch(`${STT_BASE_URL}/operations/${operation.name}?key=${config.apiKey}`);
+        if (!res.ok) {
+            throw new SpeechServiceError(`Google STT polling failed: ${res.status}`, "API_ERROR", "google", res.status);
+        }
+        return res.json();
+    }, (op) => op.done === true, 5000, 300_000, "google");
+    if (finalOp.error) {
+        throw new SpeechServiceError(`Google STT failed: ${finalOp.error.message}`, "TRANSCRIPTION_FAILED", "google");
+    }
+    const primaryLanguage = recognitionConfig.languageCode ?? "en-US";
+    return normalizeResponse(finalOp.response ?? {}, primaryLanguage);
+}
+function normalizeResponse(result, primaryLanguage) {
+    const words = [];
+    const textParts = [];
+    let detectedLanguage = primaryLanguage;
+    let lastEndTime = 0;
+    for (const sttResult of result.results ?? []) {
+        if (sttResult.languageCode) {
+            detectedLanguage = sttResult.languageCode;
+        }
+        const alt = sttResult.alternatives?.[0];
+        if (!alt)
+            continue;
+        if (alt.transcript)
+            textParts.push(alt.transcript);
+        for (const w of alt.words ?? []) {
+            const startTime = parseGoogleDuration(w.startTime ?? w.startOffset);
+            const endTime = parseGoogleDuration(w.endTime ?? w.endOffset);
+            words.push({
+                text: w.word,
+                startTime,
+                endTime,
+                confidence: w.confidence,
+                speaker: w.speakerLabel ?? (w.speakerTag ? String(w.speakerTag) : undefined),
+            });
+            if (endTime > lastEndTime)
+                lastEndTime = endTime;
+        }
+    }
+    return {
+        text: textParts.join(" "),
+        words,
+        language: detectedLanguage,
+        duration: lastEndTime,
+    };
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/providers/google/transcribe.js.map

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

package/dist/providers/google/types.d.ts

@@ -0,0 +1,43 @@
+export declare const STT_BASE_URL = "https://speech.googleapis.com/v1";
+export declare const TTS_BASE_URL = "https://texttospeech.googleapis.com/v1";
+export interface GoogleRecognizeResponse {
+    results?: GoogleSttResult[];
+    totalBilledTime?: string;
+}
+export interface GoogleSttResult {
+    alternatives?: GoogleSttAlternative[];
+    channelTag?: number;
+    resultEndTime?: string;
+    languageCode?: string;
+}
+export interface GoogleSttAlternative {
+    transcript?: string;
+    confidence?: number;
+    words?: GoogleWordInfo[];
+}
+export interface GoogleWordInfo {
+    word: string;
+    startTime?: string;
+    endTime?: string;
+    startOffset?: string;
+    endOffset?: string;
+    confidence?: number;
+    speakerLabel?: string;
+    speakerTag?: number;
+}
+export interface GoogleVoiceEntry {
+    name: string;
+    languageCodes?: string[];
+    ssmlGender?: string;
+    naturalSampleRateHertz?: number;
+}
+export interface GoogleLongRunningOperation {
+    name: string;
+    done?: boolean;
+    error?: {
+        code: number;
+        message: string;
+    };
+    response?: GoogleRecognizeResponse;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/google/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/google/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,qCAAqC,CAAC;AAC/D,eAAO,MAAM,YAAY,2CAA2C,CAAC;AAErE,MAAM,WAAW,uBAAuB;IACpC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC5B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CACtC"}

package/dist/providers/google/types.js

@@ -0,0 +1,3 @@
+export const STT_BASE_URL = "https://speech.googleapis.com/v1";
+export const TTS_BASE_URL = "https://texttospeech.googleapis.com/v1";
+//# sourceMappingURL=types.js.map

package/dist/providers/google/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/providers/google/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAG,wCAAwC,CAAC"}

package/dist/providers/openai/fetch-voices.d.ts

@@ -0,0 +1,3 @@
+import type { OpenAIConfig, VoiceInfo } from "../../types.js";
+export declare function fetchVoices(_config: OpenAIConfig): Promise<VoiceInfo[]>;
+//# sourceMappingURL=fetch-voices.d.ts.map

package/dist/providers/openai/fetch-voices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-voices.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/fetch-voices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAa9D,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAE7E"}

package/dist/providers/openai/fetch-voices.js

@@ -0,0 +1,14 @@
+// OpenAI has no voice listing API — voices are hardcoded
+const OPENAI_VOICES = [
+    "alloy", "ash", "ballad", "coral", "echo", "fable",
+    "marin", "nova", "onyx", "sage", "shimmer", "verse", "cedar",
+].map((name) => ({
+    id: name,
+    name,
+    locale: "en",
+    provider: "openai",
+}));
+export async function fetchVoices(_config) {
+    return OPENAI_VOICES;
+}
+//# sourceMappingURL=fetch-voices.js.map

package/dist/providers/openai/fetch-voices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-voices.js","sourceRoot":"","sources":["../../../src/providers/openai/fetch-voices.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,MAAM,aAAa,GAAgB;IAC/B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IAClD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO;CAC/D,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACb,EAAE,EAAE,IAAI;IACR,IAAI;IACJ,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,QAAiB;CAC9B,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAqB;IACnD,OAAO,aAAa,CAAC;AACzB,CAAC"}

package/dist/providers/openai/index.d.ts

@@ -0,0 +1,4 @@
+export { transcribe } from "./transcribe.js";
+export { synthesize } from "./synthesize.js";
+export { fetchVoices } from "./fetch-voices.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/openai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/providers/openai/index.js

@@ -0,0 +1,4 @@
+export { transcribe } from "./transcribe.js";
+export { synthesize } from "./synthesize.js";
+export { fetchVoices } from "./fetch-voices.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/openai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/openai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/providers/openai/synthesize.d.ts

@@ -0,0 +1,3 @@
+import type { OpenAIConfig, OpenAISynthesizeOptions, SynthesizeResult } from "../../types.js";
+export declare function synthesize(config: OpenAIConfig, text: string, voice: string, _language: string | undefined, options?: OpenAISynthesizeOptions): Promise<SynthesizeResult>;
+//# sourceMappingURL=synthesize.d.ts.map

package/dist/providers/openai/synthesize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/synthesize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAK9F,wBAAsB,UAAU,CAC5B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,GAAE,uBAA4B,GACtC,OAAO,CAAC,gBAAgB,CAAC,CA+C3B"}

package/dist/providers/openai/synthesize.js

@@ -0,0 +1,37 @@
+import { SpeechServiceError } from "../../errors.js";
+import { detectFormatFromString } from "../../utils.js";
+import { BASE_URL } from "./types.js";
+export async function synthesize(config, text, voice, _language, options = {}) {
+    const { model = "tts-1", responseFormat = "mp3", speed, instructions, } = options;
+    const body = {
+        model,
+        input: text,
+        voice,
+        response_format: responseFormat,
+    };
+    if (speed !== undefined)
+        body.speed = speed;
+    // instructions only works with gpt-4o-mini-tts
+    if (instructions && model.includes("gpt-4o-mini-tts")) {
+        body.instructions = instructions;
+    }
+    const response = await fetch(`${BASE_URL}/audio/speech`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${config.apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new SpeechServiceError(`OpenAI TTS failed: ${errorText}`, "API_ERROR", "openai", response.status);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    return {
+        audio: Buffer.from(arrayBuffer),
+        format: detectFormatFromString(responseFormat),
+        voice,
+    };
+}
+//# sourceMappingURL=synthesize.js.map

package/dist/providers/openai/synthesize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.js","sourceRoot":"","sources":["../../../src/providers/openai/synthesize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC5B,MAAoB,EACpB,IAAY,EACZ,KAAa,EACb,SAA6B,EAC7B,UAAmC,EAAE;IAErC,MAAM,EACF,KAAK,GAAG,OAAO,EACf,cAAc,GAAG,KAAK,EACtB,KAAK,EACL,YAAY,GACf,GAAG,OAAO,CAAC;IAEZ,MAAM,IAAI,GAA4B;QAClC,KAAK;QACL,KAAK,EAAE,IAAI;QACX,KAAK;QACL,eAAe,EAAE,cAAc;KAClC,CAAC;IAEF,IAAI,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5C,+CAA+C;IAC/C,IAAI,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,eAAe,EAAE;QACrD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;YACxC,cAAc,EAAE,kBAAkB;SACrC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC7B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,kBAAkB,CACxB,sBAAsB,SAAS,EAAE,EACjC,WAAW,EACX,QAAQ,EACR,QAAQ,CAAC,MAAM,CAClB,CAAC;IACN,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEjD,OAAO;QACH,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QAC/B,MAAM,EAAE,sBAAsB,CAAC,cAAc,CAAC;QAC9C,KAAK;KACR,CAAC;AACN,CAAC"}

package/dist/providers/openai/transcribe.d.ts

@@ -0,0 +1,3 @@
+import type { OpenAIConfig, OpenAITranscribeOptions, TranscribeResult } from "../../types.js";
+export declare function transcribe(config: OpenAIConfig, audio: Buffer | string, languages: string[] | undefined, options?: OpenAITranscribeOptions): Promise<TranscribeResult>;
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/providers/openai/transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/transcribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAEnB,MAAM,gBAAgB,CAAC;AAKxB,wBAAsB,UAAU,CAC5B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,OAAO,GAAE,uBAA4B,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAwE3B"}

package/dist/providers/openai/transcribe.js

@@ -0,0 +1,58 @@
+import { SpeechServiceError } from "../../errors.js";
+import { BASE_URL } from "./types.js";
+export async function transcribe(config, audio, languages, options = {}) {
+    const { model = "whisper-1", prompt, temperature } = options;
+    // OpenAI STT requires a file upload via multipart/form-data
+    let audioBuffer;
+    if (Buffer.isBuffer(audio)) {
+        audioBuffer = audio;
+    }
+    else if (typeof audio === "string") {
+        // Download the URL first — OpenAI only accepts file uploads
+        const res = await fetch(audio);
+        if (!res.ok) {
+            throw new SpeechServiceError(`Failed to download audio from ${audio}: ${res.status}`, "DOWNLOAD_FAILED", "openai");
+        }
+        audioBuffer = Buffer.from(await res.arrayBuffer());
+    }
+    else {
+        throw new SpeechServiceError("audio must be a Buffer or a URL string", "INVALID_INPUT", "openai");
+    }
+    const formData = new FormData();
+    formData.append("file", new Blob([new Uint8Array(audioBuffer)]), "audio.mp3");
+    formData.append("model", model);
+    formData.append("response_format", "verbose_json");
+    // Word-level timestamps only available with whisper-1
+    if (model === "whisper-1") {
+        formData.append("timestamp_granularities[]", "word");
+    }
+    if (languages?.[0]) {
+        formData.append("language", languages[0].split("-")[0].toLowerCase());
+    }
+    if (prompt)
+        formData.append("prompt", prompt);
+    if (temperature !== undefined)
+        formData.append("temperature", String(temperature));
+    const response = await fetch(`${BASE_URL}/audio/transcriptions`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${config.apiKey}` },
+        body: formData,
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new SpeechServiceError(`OpenAI transcription failed: ${errorText}`, "API_ERROR", "openai", response.status);
+    }
+    const result = (await response.json());
+    const words = (result.words ?? []).map((w) => ({
+        text: w.word,
+        startTime: w.start,
+        endTime: w.end,
+    }));
+    return {
+        text: result.text ?? "",
+        words,
+        language: result.language ?? languages?.[0] ?? "",
+        duration: result.duration ?? 0,
+    };
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/providers/openai/transcribe.js.map

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

package/dist/providers/openai/types.d.ts

@@ -0,0 +1,18 @@
+export declare const BASE_URL = "https://api.openai.com/v1";
+export interface OpenAITranscriptionResponse {
+    text?: string;
+    language?: string;
+    duration?: number;
+    words?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    segments?: Array<{
+        id: number;
+        start: number;
+        end: number;
+        text: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/openai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,8BAA8B,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACN"}

package/dist/providers/openai/types.js

@@ -0,0 +1,2 @@
+export const BASE_URL = "https://api.openai.com/v1";
+//# sourceMappingURL=types.js.map

package/dist/providers/openai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/providers/openai/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,2BAA2B,CAAC"}

package/dist/providers/playht/fetch-voices.d.ts

@@ -0,0 +1,3 @@
+import type { PlayHTConfig, VoiceInfo } from "../../types.js";
+export declare function fetchVoices(config: PlayHTConfig): Promise<VoiceInfo[]>;
+//# sourceMappingURL=fetch-voices.d.ts.map

package/dist/providers/playht/fetch-voices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-voices.d.ts","sourceRoot":"","sources":["../../../src/providers/playht/fetch-voices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK9D,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA6B5E"}

package/dist/providers/playht/fetch-voices.js

@@ -0,0 +1,25 @@
+import { SpeechServiceError } from "../../errors.js";
+import { BASE_URL } from "./types.js";
+export async function fetchVoices(config) {
+    const response = await fetch(`${BASE_URL}/voices`, {
+        headers: {
+            "X-USER-ID": config.userId,
+            AUTHORIZATION: config.apiKey,
+        },
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new SpeechServiceError(`PlayHT voice listing failed: ${errorText}`, "API_ERROR", "playht", response.status);
+    }
+    const voices = (await response.json());
+    return voices.map((v) => ({
+        id: v.id,
+        name: v.name,
+        gender: v.gender?.toLowerCase() === "male" ? "male"
+            : v.gender?.toLowerCase() === "female" ? "female"
+                : undefined,
+        locale: v.language_code ?? v.language ?? "en",
+        provider: "playht",
+    }));
+}
+//# sourceMappingURL=fetch-voices.js.map

package/dist/providers/playht/fetch-voices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-voices.js","sourceRoot":"","sources":["../../../src/providers/playht/fetch-voices.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB;IAClD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,SAAS,EAAE;QAC/C,OAAO,EAAE;YACL,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,aAAa,EAAE,MAAM,CAAC,MAAM;SAC/B;KACJ,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,kBAAkB,CACxB,gCAAgC,SAAS,EAAE,EAC3C,WAAW,EACX,QAAQ,EACR,QAAQ,CAAC,MAAM,CAClB,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAExD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAe;YACxD,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAiB;gBAC1D,CAAC,CAAC,SAAS;QACf,MAAM,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI;QAC7C,QAAQ,EAAE,QAAiB;KAC9B,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/providers/playht/index.d.ts

@@ -0,0 +1,3 @@
+export { synthesize } from "./synthesize.js";
+export { fetchVoices } from "./fetch-voices.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/playht/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/playht/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/providers/playht/index.js

@@ -0,0 +1,3 @@
+export { synthesize } from "./synthesize.js";
+export { fetchVoices } from "./fetch-voices.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/playht/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/playht/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/providers/playht/synthesize.d.ts

@@ -0,0 +1,3 @@
+import type { PlayHTConfig, PlayHTSynthesizeOptions, SynthesizeResult } from "../../types.js";
+export declare function synthesize(config: PlayHTConfig, text: string, voice: string, language: string | undefined, options?: PlayHTSynthesizeOptions): Promise<SynthesizeResult>;
+//# sourceMappingURL=synthesize.d.ts.map