@nkirit/ai-voice 0.1.0

package/README.md

@@ -0,0 +1,124 @@
+# @neelkirit/ai-voice
+
+Isomorphic TypeScript TTS library for OpenAI, ElevenLabs, and Google Cloud TTS. **BYOK** — bring your own API key. Works in Node 18+ and modern browsers (no vendor SDKs, just `fetch`).
+
+## Install
+
+```bash
+npm install @neelkirit/ai-voice
+```
+
+## Quick start
+
+```ts
+import { synthesize } from "@neelkirit/ai-voice";
+
+const bytes = await synthesize({
+  provider: "openai",
+  apiKey: "sk-...",
+  text: "Hello, world!",
+});
+// bytes is a Uint8Array of MP3 audio
+```
+
+## Streaming
+
+```ts
+import { synthesizeStream } from "@neelkirit/ai-voice";
+
+const stream = await synthesizeStream({
+  provider: "elevenlabs",
+  apiKey: "xi-...",
+  text: "Hello from ElevenLabs!",
+});
+// stream is a ReadableStream<Uint8Array>
+```
+
+## Providers
+
+### OpenAI
+
+```ts
+await synthesize({
+  provider: "openai",
+  apiKey: "sk-...",         // sk-...
+  text: "Hello",
+  voice: {
+    gender: "female",       // male | female | neutral (default)
+    speed: 1.2,             // 0.25–4.0
+    voiceId: "shimmer",     // overrides gender
+  },
+});
+```
+
+Default voices: `male → onyx`, `female → nova`, `neutral → alloy`.
+
+### ElevenLabs
+
+```ts
+await synthesize({
+  provider: "elevenlabs",
+  apiKey: "xi-...",
+  text: "Hello",
+  voice: {
+    gender: "female",
+    speed: 1.0,              // 0.7–1.2 (clamped per ElevenLabs limits)
+    voiceId: "EXAVITQu4vr4xnSDxMaL", // overrides gender
+  },
+});
+```
+
+Default voices: `male → Josh`, `female → Bella`, `neutral → Rachel`.
+
+### Google Cloud TTS
+
+```ts
+await synthesize({
+  provider: "google",
+  apiKey: "AIza...",         // Google API key (must have Cloud TTS enabled)
+  text: "Hello",
+  voice: {
+    language: "en-US",       // BCP-47 tag
+    gender: "female",
+    speed: 1.0,              // 0.25–4.0
+    pitch: 2.0,              // -20.0 to +20.0 semitones
+    voiceId: "en-US-Neural2-A", // overrides gender (sets voice.name)
+  },
+});
+```
+
+## Voice parameters by provider
+
+| Param | OpenAI | ElevenLabs | Google |
+|---|---|---|---|
+| `voiceId` | ✓ | ✓ | ✓ (mapped to `name`) |
+| `gender` | ✓ (default) | ✓ (default) | ✓ (default) |
+| `speed` | ✓ 0.25–4.0 | ✓ 0.7–1.2 | ✓ 0.25–4.0 |
+| `pitch` | — | — | ✓ -20–+20 |
+| `language` | — | — | ✓ |
+
+## Error handling
+
+```ts
+import { synthesize, InvalidApiKeyError, ProviderError, VoiceAppError } from "@neelkirit/ai-voice";
+
+try {
+  const bytes = await synthesize({ provider: "openai", apiKey: "bad", text: "hi" });
+} catch (e) {
+  if (e instanceof InvalidApiKeyError) {
+    console.error("Check your API key for:", e.provider);
+  } else if (e instanceof ProviderError) {
+    console.error("Provider returned an error:", e.message);
+  } else if (e instanceof VoiceAppError) {
+    console.error("Library error:", e.message);
+  }
+}
+```
+
+## Security note
+
+This is a BYOK library — API keys are used directly in HTTP calls from wherever the library runs. In browser contexts (e.g. the demo site), the key is visible in DevTools network requests. **Do not use production keys in browser demos.** For server-side use (Node.js), keys stay server-side and are safe.
+
+## License
+
+MIT

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+export declare class VoiceAppError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode?: number);
+}
+export declare class InvalidApiKeyError extends VoiceAppError {
+    readonly provider: string;
+    constructor(provider: string);
+}
+export declare class ProviderError extends VoiceAppError {
+    constructor(provider: string, cause: unknown, statusCode?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;aACO,UAAU,EAAE,MAAM;gBAAnD,OAAO,EAAE,MAAM,EAAkB,UAAU,GAAE,MAAY;CAItE;AAED,qBAAa,kBAAmB,SAAQ,aAAa;aACvB,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAI7C;AAED,qBAAa,aAAc,SAAQ,aAAa;gBAClC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,SAAM;CAK/D"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+export class VoiceAppError extends Error {
+    constructor(message, statusCode = 500) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "VoiceAppError";
+    }
+}
+export class InvalidApiKeyError extends VoiceAppError {
+    constructor(provider) {
+        super(`Invalid or unauthorized API key for provider: ${provider}`, 401);
+        this.provider = provider;
+        this.name = "InvalidApiKeyError";
+    }
+}
+export class ProviderError extends VoiceAppError {
+    constructor(provider, cause, statusCode = 502) {
+        const detail = cause instanceof Error ? cause.message : String(cause);
+        super(`${provider} provider error: ${detail}`, statusCode);
+        this.name = "ProviderError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe,EAAkB,aAAqB,GAAG;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,eAAU,GAAV,UAAU,CAAc;QAEnE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAA4B,QAAgB;QAC1C,KAAK,CAAC,iDAAiD,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;QAD9C,aAAQ,GAAR,QAAQ,CAAQ;QAE1C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,QAAgB,EAAE,KAAc,EAAE,UAAU,GAAG,GAAG;QAC5D,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,KAAK,CAAC,GAAG,QAAQ,oBAAoB,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { synthesize, synthesizeStream } from "./synthesize.js";
+export type { Provider, VoiceParams, SynthesizeOptions } from "./types.js";
+export { VoiceAppError, InvalidApiKeyError, ProviderError } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { synthesize, synthesizeStream } from "./synthesize.js";
+export { VoiceAppError, InvalidApiKeyError, ProviderError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/elevenlabs.d.ts

@@ -0,0 +1,3 @@
+import type { SynthesizeOptions } from "../types.js";
+export declare function elevenlabsStream(opts: SynthesizeOptions): Promise<ReadableStream<Uint8Array>>;
+//# sourceMappingURL=elevenlabs.d.ts.map

package/dist/providers/elevenlabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.d.ts","sourceRoot":"","sources":["../../src/providers/elevenlabs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUrD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CA6BnG"}

package/dist/providers/elevenlabs.js

@@ -0,0 +1,47 @@
+import { InvalidApiKeyError, ProviderError } from "../errors.js";
+import { clamp } from "../util/clamp.js";
+const DEFAULT_VOICES = {
+    male: "TxGEqnHWrfWFTfGW9XjX", // Josh
+    female: "EXAVITQu4vr4xnSDxMaL", // Bella
+    neutral: "21m00Tcm4TlvDq8ikWAM", // Rachel
+};
+export async function elevenlabsStream(opts) {
+    const f = opts.fetch ?? fetch;
+    const v = opts.voice ?? {};
+    const voiceId = v.voiceId ?? DEFAULT_VOICES[v.gender ?? "neutral"];
+    const url = `https://api.elevenlabs.io/v1/text-to-speech/${encodeURIComponent(voiceId)}/stream?output_format=mp3_44100_128`;
+    const res = await f(url, {
+        method: "POST",
+        headers: {
+            "xi-api-key": opts.apiKey,
+            "Content-Type": "application/json",
+            Accept: "audio/mpeg",
+        },
+        body: JSON.stringify({
+            text: opts.text,
+            model_id: "eleven_turbo_v2_5",
+            voice_settings: {
+                stability: 0.5,
+                similarity_boost: 0.75,
+                speed: clamp(v.speed ?? 1.0, 0.7, 1.2),
+            },
+        }),
+        signal: opts.signal,
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new InvalidApiKeyError("elevenlabs");
+    if (!res.ok)
+        throw new ProviderError("elevenlabs", new Error(`HTTP ${res.status}: ${await safeText(res)}`));
+    if (!res.body)
+        throw new ProviderError("elevenlabs", new Error("empty response body"));
+    return res.body;
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return res.statusText;
+    }
+}
+//# sourceMappingURL=elevenlabs.js.map

package/dist/providers/elevenlabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.js","sourceRoot":"","sources":["../../src/providers/elevenlabs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,MAAM,cAAc,GAAG;IACrB,IAAI,EAAK,sBAAsB,EAAE,OAAO;IACxC,MAAM,EAAG,sBAAsB,EAAE,QAAQ;IACzC,OAAO,EAAE,sBAAsB,EAAE,SAAS;CAClC,CAAC;AAEX,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAuB;IAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;IACnE,MAAM,GAAG,GAAG,+CAA+C,kBAAkB,CAAC,OAAO,CAAC,qCAAqC,CAAC;IAE5H,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE;QACvB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,YAAY;SACrB;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,mBAAmB;YAC7B,cAAc,EAAE;gBACd,SAAS,EAAE,GAAG;gBACd,gBAAgB,EAAE,IAAI;gBACtB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;aACvC;SACF,CAAC;QACF,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACzF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5G,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACvF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QAAC,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,GAAG,CAAC,UAAU,CAAC;IAAC,CAAC;AACnE,CAAC"}

package/dist/providers/google.d.ts

@@ -0,0 +1,3 @@
+import type { SynthesizeOptions } from "../types.js";
+export declare function googleStream(opts: SynthesizeOptions): Promise<ReadableStream<Uint8Array>>;
+//# sourceMappingURL=google.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,wBAAsB,YAAY,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAsC/F"}

package/dist/providers/google.js

@@ -0,0 +1,51 @@
+import { InvalidApiKeyError, ProviderError } from "../errors.js";
+import { clamp } from "../util/clamp.js";
+import { base64ToBytes } from "../util/base64.js";
+const GENDER_MAP = { male: "MALE", female: "FEMALE", neutral: "NEUTRAL" };
+export async function googleStream(opts) {
+    const f = opts.fetch ?? fetch;
+    const v = opts.voice ?? {};
+    const language = v.language ?? "en-US";
+    const ssmlGender = GENDER_MAP[v.gender ?? "neutral"];
+    const url = `https://texttospeech.googleapis.com/v1/text:synthesize?key=${encodeURIComponent(opts.apiKey)}`;
+    const res = await f(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            input: { text: opts.text },
+            voice: {
+                languageCode: language,
+                ...(v.voiceId ? { name: v.voiceId } : { ssmlGender }),
+            },
+            audioConfig: {
+                audioEncoding: "MP3",
+                speakingRate: clamp(v.speed ?? 1.0, 0.25, 4.0),
+                pitch: clamp(v.pitch ?? 0.0, -20, 20),
+            },
+        }),
+        signal: opts.signal,
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new InvalidApiKeyError("google");
+    if (!res.ok)
+        throw new ProviderError("google", new Error(`HTTP ${res.status}: ${await safeText(res)}`));
+    const json = (await res.json());
+    if (!json.audioContent)
+        throw new ProviderError("google", new Error("missing audioContent in response"));
+    const bytes = base64ToBytes(json.audioContent);
+    return new ReadableStream({
+        start(controller) {
+            controller.enqueue(bytes);
+            controller.close();
+        },
+    });
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return res.statusText;
+    }
+}
+//# sourceMappingURL=google.js.map

package/dist/providers/google.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.js","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAW,CAAC;AAEnF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAuB;IACxD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC;IACvC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,8DAA8D,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAE5G,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE;QACvB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YAC1B,KAAK,EAAE;gBACL,YAAY,EAAE,QAAQ;gBACtB,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;aACtD;YACD,WAAW,EAAE;gBACX,aAAa,EAAE,KAAK;gBACpB,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC;gBAC9C,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;aACtC;SACF,CAAC;QACF,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAExG,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA8B,CAAC;IAC7D,IAAI,CAAC,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC;IACzG,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAE/C,OAAO,IAAI,cAAc,CAAa;QACpC,KAAK,CAAC,UAAU;YACd,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1B,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QAAC,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,GAAG,CAAC,UAAU,CAAC;IAAC,CAAC;AACnE,CAAC"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,3 @@
+import type { SynthesizeOptions } from "../types.js";
+export declare function openaiStream(opts: SynthesizeOptions): Promise<ReadableStream<Uint8Array>>;
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,wBAAsB,YAAY,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CA0B/F"}

package/dist/providers/openai.js

@@ -0,0 +1,41 @@
+import { InvalidApiKeyError, ProviderError } from "../errors.js";
+import { clamp } from "../util/clamp.js";
+const VOICES = { male: "onyx", female: "nova", neutral: "alloy" };
+const TTS_URL = "https://api.openai.com/v1/audio/speech";
+export async function openaiStream(opts) {
+    const f = opts.fetch ?? fetch;
+    const v = opts.voice ?? {};
+    const voice = v.voiceId ?? VOICES[v.gender ?? "neutral"];
+    const res = await f(TTS_URL, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${opts.apiKey}`,
+            "Content-Type": "application/json",
+            Accept: "audio/mpeg",
+        },
+        body: JSON.stringify({
+            model: "tts-1-hd",
+            voice,
+            input: opts.text,
+            response_format: "mp3",
+            speed: clamp(v.speed ?? 1.0, 0.25, 4.0),
+        }),
+        signal: opts.signal,
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new InvalidApiKeyError("openai");
+    if (!res.ok)
+        throw new ProviderError("openai", new Error(`HTTP ${res.status}: ${await safeText(res)}`));
+    if (!res.body)
+        throw new ProviderError("openai", new Error("empty response body"));
+    return res.body;
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return res.statusText;
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC;AAC3E,MAAM,OAAO,GAAG,wCAAwC,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAuB;IACxD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;IAEzD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,YAAY;SACrB;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,UAAU;YACjB,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,eAAe,EAAE,KAAK;YACtB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC;SACxC,CAAC;QACF,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACxG,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACnF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QAAC,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,GAAG,CAAC,UAAU,CAAC;IAAC,CAAC;AACnE,CAAC"}

package/dist/synthesize.d.ts

@@ -0,0 +1,4 @@
+import type { SynthesizeOptions } from "./types.js";
+export declare function synthesizeStream(opts: SynthesizeOptions): Promise<ReadableStream<Uint8Array>>;
+export declare function synthesize(opts: SynthesizeOptions): Promise<Uint8Array<ArrayBuffer>>;
+//# sourceMappingURL=synthesize.d.ts.map

package/dist/synthesize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../src/synthesize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,YAAY,CAAC;AAQ9D,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAOnG;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAG1F"}

package/dist/synthesize.js

@@ -0,0 +1,48 @@
+import { VoiceAppError } from "./errors.js";
+import { openaiStream } from "./providers/openai.js";
+import { elevenlabsStream } from "./providers/elevenlabs.js";
+import { googleStream } from "./providers/google.js";
+const SUPPORTED = ["openai", "elevenlabs", "google"];
+export async function synthesizeStream(opts) {
+    validate(opts);
+    switch (opts.provider) {
+        case "openai": return openaiStream(opts);
+        case "elevenlabs": return elevenlabsStream(opts);
+        case "google": return googleStream(opts);
+    }
+}
+export async function synthesize(opts) {
+    const stream = await synthesizeStream(opts);
+    return collect(stream);
+}
+function validate(opts) {
+    if (!opts.text?.trim())
+        throw new VoiceAppError("text is required and must be non-empty", 400);
+    if (!SUPPORTED.includes(opts.provider)) {
+        throw new VoiceAppError(`provider must be one of: ${SUPPORTED.join(", ")}`, 400);
+    }
+    if (!opts.apiKey)
+        throw new VoiceAppError("apiKey is required", 400);
+}
+async function collect(stream) {
+    const reader = stream.getReader();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        if (value) {
+            chunks.push(value);
+            total += value.byteLength;
+        }
+    }
+    const out = new Uint8Array(total);
+    let off = 0;
+    for (const c of chunks) {
+        out.set(c, off);
+        off += c.byteLength;
+    }
+    return out;
+}
+//# sourceMappingURL=synthesize.js.map

package/dist/synthesize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.js","sourceRoot":"","sources":["../src/synthesize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,SAAS,GAAwB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAuB;IAC5D,QAAQ,CAAC,IAAI,CAAC,CAAC;IACf,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,QAAQ,CAAC,CAAK,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC7C,KAAK,YAAY,CAAC,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACjD,KAAK,QAAQ,CAAC,CAAK,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAuB;IACtD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAuB;IACvC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE;QAAE,MAAM,IAAI,aAAa,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAC;IAC/F,IAAI,CAAE,SAA+B,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,aAAa,CAAC,4BAA4B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,aAAa,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,MAAkC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,CAAC;QACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAChB,IAAI,KAAK,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;QAAC,CAAC;IAC/D,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAA4B,CAAC;IAC7D,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAAC,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC;IAAC,CAAC;IACjE,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+export type Provider = "openai" | "elevenlabs" | "google";
+export interface VoiceParams {
+    /** Provider-specific voice identifier. If omitted, a gender-based default is used. */
+    voiceId?: string;
+    /** Playback rate. Clamped per-provider; canonical input range 0.25–4.0. */
+    speed?: number;
+    /** Semitones; Google only. -20.0 to +20.0. Silently ignored by OpenAI and ElevenLabs. */
+    pitch?: number;
+    /** BCP-47 language tag (e.g. "en-US"). Google uses this; OpenAI/ElevenLabs ignore it. */
+    language?: string;
+    /** Fallback for default voice selection when voiceId is absent. */
+    gender?: "male" | "female" | "neutral";
+}
+export interface SynthesizeOptions {
+    provider: Provider;
+    /** User-supplied provider API key (sk-... for OpenAI, xi-... for ElevenLabs, AIza... for Google). */
+    apiKey: string;
+    /** Text to synthesize. Must be non-empty after trim. */
+    text: string;
+    /** Voice configuration. Provider-specific defaults applied when omitted. */
+    voice?: VoiceParams;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+    /** Override the fetch implementation (useful for testing or custom runtimes). */
+    fetch?: typeof fetch;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,qGAAqG;IACrG,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/util/base64.d.ts

@@ -0,0 +1,3 @@
+/** Decode a base64 string to Uint8Array — works in Node 18+ (atob is global) and browsers. */
+export declare function base64ToBytes(b64: string): Uint8Array;
+//# sourceMappingURL=base64.d.ts.map

package/dist/util/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/util/base64.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAKrD"}

package/dist/util/base64.js

@@ -0,0 +1,9 @@
+/** Decode a base64 string to Uint8Array — works in Node 18+ (atob is global) and browsers. */
+export function base64ToBytes(b64) {
+    const bin = atob(b64);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return out;
+}
+//# sourceMappingURL=base64.js.map

package/dist/util/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/util/base64.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/util/clamp.d.ts

@@ -0,0 +1,2 @@
+export declare const clamp: (v: number, min: number, max: number) => number;
+//# sourceMappingURL=clamp.d.ts.map

package/dist/util/clamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../../src/util/clamp.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAC3B,CAAC"}

package/dist/util/clamp.js

@@ -0,0 +1,2 @@
+export const clamp = (v, min, max) => Math.min(Math.max(v, min), max);
+//# sourceMappingURL=clamp.js.map

package/dist/util/clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../src/util/clamp.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE,CACnE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@nkirit/ai-voice",
+  "version": "0.1.0",
+  "description": "Isomorphic TypeScript TTS client for OpenAI, ElevenLabs, and Google Cloud TTS. BYOK.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "dependencies": {},
+  "peerDependencies": {},
+  "engines": { "node": ">=18.18" },
+  "publishConfig": { "access": "public" },
+  "keywords": ["tts", "openai", "elevenlabs", "google-cloud-tts", "isomorphic", "byok"],
+  "repository": { "type": "git", "url": "https://github.com/neelkirit/ai-voice" },
+  "homepage": "https://github.com/neelkirit/ai-voice#readme"
+}