@supertone/supertone 0.1.1 → 0.1.3

package/examples/voices/list_voices.ts

@@ -5,15 +5,11 @@
  * This example demonstrates how to list all available voices.
  */
 
-import { Supertone } from "../../src/index.js";
+import { Supertone } from "@supertone/supertone";
 import * as dotenv from "dotenv";
-import * as path from "path";
-import { fileURLToPath } from "url";
 
 // Load environment variables
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-dotenv.config({ path: path.join(__dirname, "../.env") });
+dotenv.config();
 
 const API_KEY = process.env.SUPERTONE_API_KEY;
 

package/examples/voices/search_voices.ts

@@ -5,15 +5,11 @@
  * This example demonstrates how to search for voices by language and gender.
  */
 
-import { Supertone } from "../../src/index.js";
+import { Supertone } from "@supertone/supertone";
 import * as dotenv from "dotenv";
-import * as path from "path";
-import { fileURLToPath } from "url";
 
 // Load environment variables
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-dotenv.config({ path: path.join(__dirname, "../.env") });
+dotenv.config();
 
 const API_KEY = process.env.SUPERTONE_API_KEY;
 
@@ -58,4 +54,3 @@ async function main() {
 }
 
 main();
-

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@supertone/supertone",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/openapi.json

@@ -1870,8 +1870,26 @@
               "en",
               "ko",
               "ja",
+              "bg",
+              "cs",
+              "da",
+              "el",
               "es",
-              "pt"
+              "et",
+              "fi",
+              "hu",
+              "it",
+              "nl",
+              "pl",
+              "pt",
+              "ro",
+              "ar",
+              "de",
+              "fr",
+              "hi",
+              "id",
+              "ru",
+              "vi"
             ]
           },
           "style": {
@@ -1881,6 +1899,12 @@
           "model": {
             "type": "string",
             "description": "The model type to use for the text-to-speech conversion",
+            "enum": [
+              "sona_speech_1",
+              "sona_speech_2",
+              "sona_speech_2t",
+              "supertonic_api_1"
+            ],
             "default": "sona_speech_1"
           },
           "output_format": {
@@ -1948,8 +1972,26 @@
               "en",
               "ko",
               "ja",
+              "bg",
+              "cs",
+              "da",
+              "el",
               "es",
-              "pt"
+              "et",
+              "fi",
+              "hu",
+              "it",
+              "nl",
+              "pl",
+              "pt",
+              "ro",
+              "ar",
+              "de",
+              "fr",
+              "hi",
+              "id",
+              "ru",
+              "vi"
             ]
           },
           "style": {
@@ -1959,6 +2001,12 @@
           "model": {
             "type": "string",
             "description": "The model type to use for the text-to-speech conversion",
+            "enum": [
+              "sona_speech_1",
+              "sona_speech_2",
+              "sona_speech_2t",
+              "supertonic_api_1"
+            ],
             "default": "sona_speech_1"
           },
           "output_format": {
@@ -1995,7 +2043,7 @@
           "model": {
             "type": "string",
             "description": "Model of the sample",
-            "example": "sona_speech_1"
+            "example": "supertonic_api_1"
           },
           "url": {
             "type": "string",
@@ -2057,9 +2105,29 @@
           "language": {
             "description": "Languages supported by the voice",
             "example": [
-              "ko",
+              "ar",
+              "bg",
+              "cs",
+              "da",
+              "de",
+              "el",
               "en",
-              "ja"
+              "es",
+              "et",
+              "fi",
+              "fr",
+              "hi",
+              "hu",
+              "id",
+              "it",
+              "ja",
+              "ko",
+              "nl",
+              "pl",
+              "pt",
+              "ro",
+              "ru",
+              "vi"
             ],
             "type": "array",
             "items": {
@@ -2081,7 +2149,9 @@
           "models": {
             "description": "Models available for the voice",
             "example": [
-              "sona_speech_1"
+              "sona_speech_1",
+              "sona_speech_2",
+              "supertonic_api_1"
             ],
             "type": "array",
             "items": {
@@ -2187,9 +2257,29 @@
           "language": {
             "description": "Languages supported by the voice",
             "example": [
-              "ko",
+              "ar",
+              "bg",
+              "cs",
+              "da",
+              "de",
+              "el",
               "en",
-              "ja"
+              "es",
+              "et",
+              "fi",
+              "fr",
+              "hi",
+              "hu",
+              "id",
+              "it",
+              "ja",
+              "ko",
+              "nl",
+              "pl",
+              "pt",
+              "ro",
+              "ru",
+              "vi"
             ],
             "type": "array",
             "items": {
@@ -2211,7 +2301,9 @@
           "models": {
             "description": "Models available for the voice",
             "example": [
-              "sona_speech_1"
+              "sona_speech_1",
+              "sona_speech_2",
+              "supertonic_api_1"
             ],
             "type": "array",
             "items": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supertone/supertone",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "author": "Supertone, Pillip Youn",
   "bugs": {
     "url": "https://github.com/supertone-inc/supertone-ts/issues"

package/src/lib/config.ts

@@ -11,58 +11,58 @@ import { Params, pathToFunc } from "./url.js";
  * Contains the list of servers available to the SDK
  */
 export const ServerList = [
-  /**
-   * Production
-   */
-  "https://supertoneapi.com",
+	/**
+	 * Production
+	 */
+	"https://supertoneapi.com",
 ] as const;
 
 export type SDKOptions = {
-  apiKey?: string | (() => Promise<string>) | undefined;
+	apiKey?: string | (() => Promise<string>) | undefined;
 
-  httpClient?: HTTPClient;
-  /**
-   * Allows overriding the default server used by the SDK
-   */
-  serverIdx?: number | undefined;
-  /**
-   * Allows overriding the default server URL used by the SDK
-   */
-  serverURL?: string | undefined;
-  /**
-   * Allows overriding the default user agent used by the SDK
-   */
-  userAgent?: string | undefined;
-  /**
-   * Allows overriding the default retry config used by the SDK
-   */
-  retryConfig?: RetryConfig;
-  timeoutMs?: number;
-  debugLogger?: Logger;
+	httpClient?: HTTPClient;
+	/**
+	 * Allows overriding the default server used by the SDK
+	 */
+	serverIdx?: number | undefined;
+	/**
+	 * Allows overriding the default server URL used by the SDK
+	 */
+	serverURL?: string | undefined;
+	/**
+	 * Allows overriding the default user agent used by the SDK
+	 */
+	userAgent?: string | undefined;
+	/**
+	 * Allows overriding the default retry config used by the SDK
+	 */
+	retryConfig?: RetryConfig;
+	timeoutMs?: number;
+	debugLogger?: Logger;
 };
 
 export function serverURLFromOptions(options: SDKOptions): URL | null {
-  let serverURL = options.serverURL;
+	let serverURL = options.serverURL;
 
-  const params: Params = {};
+	const params: Params = {};
 
-  if (!serverURL) {
-    const serverIdx = options.serverIdx ?? 0;
-    if (serverIdx < 0 || serverIdx >= ServerList.length) {
-      throw new Error(`Invalid server index ${serverIdx}`);
-    }
-    serverURL = ServerList[serverIdx] || "";
-  }
+	if (!serverURL) {
+		const serverIdx = options.serverIdx ?? 0;
+		if (serverIdx < 0 || serverIdx >= ServerList.length) {
+			throw new Error(`Invalid server index ${serverIdx}`);
+		}
+		serverURL = ServerList[serverIdx] || "";
+	}
 
-  const u = pathToFunc(serverURL)(params);
-  return new URL(u);
+	const u = pathToFunc(serverURL)(params);
+	return new URL(u);
 }
 
 export const SDK_METADATA = {
-  language: "typescript",
-  openapiDocVersion: "0.8.69",
-  sdkVersion: "0.1.1",
-  genVersion: "2.686.7",
-  userAgent:
-    "speakeasy-sdk/typescript 0.1.1 2.686.7 0.8.69 @supertone/supertone",
+	language: "typescript",
+	openapiDocVersion: "0.8.69",
+	sdkVersion: "0.1.3",
+	genVersion: "2.686.7",
+	userAgent:
+		"speakeasy-sdk/typescript 0.1.2 2.686.7 0.8.69 @supertone/supertone",
 } as const;

package/src/lib/custom_utils/index.ts

@@ -11,6 +11,13 @@ export * from "./constants.js";
 // Export text utilities
 export { chunkText, extractAudioFromNdjson } from "./text_utils.js";
 
+// Export pronunciation utilities
+export {
+	applyPronunciationDictionary,
+	PronunciationDictionaryValidationError,
+	type PronunciationDictionaryEntry,
+} from "./pronunciation_utils.js";
+
 // Export audio utilities
 export {
 	mergeWavBinary,

package/src/lib/custom_utils/pronunciation_utils.ts

@@ -0,0 +1,193 @@
+/**
+ * Pronunciation dictionary substitution utilities.
+ *
+ * Mirrors the Python implementation policy:
+ * - Apply rules in input order
+ * - partial_match=false: word-boundary exact matches only
+ * - partial_match=true: substring matches (no boundaries)
+ * - No re-substitution: replaced segments are shielded via opaque tokens
+ *
+ * Validation:
+ * - pronunciation_dictionary omitted/undefined/null -> return original text
+ * - pronunciation_dictionary must be an array of objects
+ * - each object must have: text (string, non-empty), pronunciation (string, non-empty), partial_match (boolean)
+ */
+
+export class PronunciationDictionaryValidationError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "PronunciationDictionaryValidationError";
+  }
+}
+
+export type PronunciationDictionaryEntry = {
+  text: string;
+  pronunciation: string;
+  partial_match: boolean;
+};
+
+export function applyPronunciationDictionary(
+  text: string,
+  pronunciation_dictionary?: unknown
+): string {
+  // Match Python behavior: return early for null, undefined, or empty array
+  if (
+    pronunciation_dictionary == null ||
+    (Array.isArray(pronunciation_dictionary) &&
+      pronunciation_dictionary.length === 0)
+  ) {
+    return text;
+  }
+
+  if (typeof text !== "string") {
+    throw new PronunciationDictionaryValidationError(
+      `\`text\` must be string, got ${typeof text}`
+    );
+  }
+
+  if (!Array.isArray(pronunciation_dictionary)) {
+    throw new PronunciationDictionaryValidationError(
+      "`pronunciation_dictionary` must be an array of objects"
+    );
+  }
+
+  // Prevent re-substitution:
+  // replace matches with unique opaque tokens first,
+  // then expand tokens to pronunciations at the end.
+  const tokenToPronunciation = new Map<string, string>();
+  let working = text;
+
+  for (let idx = 0; idx < pronunciation_dictionary.length; idx++) {
+    const entry = validateEntry(pronunciation_dictionary[idx], idx);
+    const src = entry.text;
+    const dst = entry.pronunciation;
+    const partial = entry.partial_match;
+
+    const token = makeUniqueToken(idx, working, tokenToPronunciation);
+
+    if (partial) {
+      const re = new RegExp(escapeRegExp(src), "g");
+      const newWorking = working.replace(re, token);
+      if (newWorking === working) continue; // No match found
+      tokenToPronunciation.set(token, dst);
+      working = newWorking;
+      continue;
+    }
+
+    // Exact match with word-boundary semantics (Unicode-aware-ish).
+    // Python uses Unicode \w; in JS, \w is ASCII-only. To mirror behavior better across scripts,
+    // we define "word char" as: letter or number or underscore.
+    //
+    // We avoid lookbehind for broader runtime compatibility by capturing the left boundary.
+    //
+    // Pattern: (^|[^WORD_CHARS]) (SRC) (?=[^WORD_CHARS]|$)
+    // (IMPORTANT) WORD_CHARS must not include surrounding [] because we embed it into other [].
+    const WORD_CHARS = "\\p{L}\\p{N}_";
+    const srcEsc = escapeRegExp(src);
+    const pattern = `(^|[^${WORD_CHARS}])(${srcEsc})(?=[^${WORD_CHARS}]|$)`;
+    const re = new RegExp(pattern, "gu");
+
+    // Replace keeping the left boundary (group 1)
+    const newWorking = working.replace(re, `$1${token}`);
+    if (newWorking === working) continue; // No match found
+    tokenToPronunciation.set(token, dst);
+    working = newWorking;
+  }
+
+  // Expand tokens into pronunciations.
+  for (const [token, pron] of tokenToPronunciation.entries()) {
+    working = working.split(token).join(pron);
+  }
+
+  return working;
+}
+
+function validateEntry(raw: unknown, idx: number): PronunciationDictionaryEntry {
+  if (raw == null || typeof raw !== "object" || Array.isArray(raw)) {
+    throw new PronunciationDictionaryValidationError(
+      `pronunciation_dictionary[${idx}] must be an object, got ${
+        raw === null ? "null" : Array.isArray(raw) ? "array" : typeof raw
+      }`
+    );
+  }
+
+  const obj = raw as Record<string, unknown>;
+  const missing: string[] = [];
+  if (!("text" in obj)) missing.push("text");
+  if (!("pronunciation" in obj)) missing.push("pronunciation");
+  if (!("partial_match" in obj)) missing.push("partial_match");
+  if (missing.length) {
+    throw new PronunciationDictionaryValidationError(
+      `pronunciation_dictionary[${idx}] missing required field(s): ${missing.join(", ")}`
+    );
+  }
+
+  const src = obj["text"];
+  const dst = obj["pronunciation"];
+  const partial = obj["partial_match"];
+
+  if (typeof src !== "string") {
+    throw new PronunciationDictionaryValidationError(
+      `pronunciation_dictionary[${idx}].text must be string, got ${typeof src}`
+    );
+  }
+  if (typeof dst !== "string") {
+    throw new PronunciationDictionaryValidationError(
+      `pronunciation_dictionary[${idx}].pronunciation must be string, got ${typeof dst}`
+    );
+  }
+  if (typeof partial !== "boolean") {
+    throw new PronunciationDictionaryValidationError(
+      `pronunciation_dictionary[${idx}].partial_match must be boolean, got ${typeof partial}`
+    );
+  }
+
+  if (src === "") {
+    throw new PronunciationDictionaryValidationError(
+      `pronunciation_dictionary[${idx}].text must not be empty`
+    );
+  }
+  if (dst === "") {
+    throw new PronunciationDictionaryValidationError(
+      `pronunciation_dictionary[${idx}].pronunciation must not be empty`
+    );
+  }
+
+  return { text: src, pronunciation: dst, partial_match: partial };
+}
+
+function escapeRegExp(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function makeUniqueToken(
+  idx: number,
+  working: string,
+  existing: Map<string, string>
+): string {
+  // Private Use Area markers to minimize collision with typical text.
+  const base = `\uE000PD${idx}\uE001`;
+  if (!working.includes(base) && !existing.has(base)) return base;
+
+  while (true) {
+    const suffix = safeRandomHex();
+    const token = `\uE000PD${idx}_${suffix}\uE001`;
+    if (!working.includes(token) && !existing.has(token)) return token;
+  }
+}
+
+function safeRandomHex(): string {
+  // Prefer crypto.randomUUID when available (browser / modern runtimes)
+  const c = (globalThis as any).crypto;
+  if (c && typeof c.randomUUID === "function") {
+    return String(c.randomUUID()).replace(/-/g, "");
+  }
+  // Fallback: not cryptographically strong, but fine for uniqueness tokenization.
+  return (
+    Math.random().toString(16).slice(2) +
+    Math.random().toString(16).slice(2) +
+    Date.now().toString(16)
+  );
+}
+
+