@neosapience/typecast-js 0.1.4 → 0.1.6

package/lib/index.cjs

@@ -1,13 +1,5 @@
 'use strict';
 
-var axios = require('axios');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var axios__default = /*#__PURE__*/_interopDefault(axios);
-
-// src/client.ts
-
 // src/errors.ts
 var TypecastAPIError = class _TypecastAPIError extends Error {
   constructor(message, statusCode, response) {
@@ -54,58 +46,134 @@ var TypecastAPIError = class _TypecastAPIError extends Error {
 // src/client.ts
 var TypecastClient = class {
   constructor(config = {}) {
-    this.config = {
+    const finalConfig = {
       baseHost: process.env.TYPECAST_API_HOST || "https://api.typecast.ai",
       apiKey: process.env.TYPECAST_API_KEY || "",
       ...config
     };
-    this.client = axios__default.default.create({
-      baseURL: this.config.baseHost,
-      headers: {
-        "X-API-KEY": this.config.apiKey,
-        "Content-Type": "application/json"
+    this.baseHost = finalConfig.baseHost;
+    this.headers = {
+      "X-API-KEY": finalConfig.apiKey,
+      "Content-Type": "application/json"
+    };
+  }
+  /**
+   * Handle HTTP error responses
+   */
+  async handleResponse(response) {
+    if (!response.ok) {
+      let errorData;
+      try {
+        errorData = await response.json();
+      } catch {
       }
-    });
-    this.client.interceptors.response.use(
-      (response) => response,
-      (error) => {
-        if (error.response) {
-          throw TypecastAPIError.fromResponse(
-            error.response.status,
-            error.response.statusText,
-            error.response.data
-          );
+      throw TypecastAPIError.fromResponse(
+        response.status,
+        response.statusText,
+        errorData
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Build URL with query parameters
+   */
+  buildUrl(path, params) {
+    const url = new URL(path, this.baseHost);
+    if (params) {
+      Object.entries(params).forEach(([key, value]) => {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.append(key, String(value));
         }
-        throw error;
-      }
-    );
+      });
+    }
+    return url.toString();
   }
+  /**
+   * Convert text to speech
+   * @param request - TTS request parameters including text, voice_id, model, and optional settings
+   * @returns TTSResponse containing audio data, duration, and format
+   */
   async textToSpeech(request) {
-    const response = await this.client.post("/v1/text-to-speech", request, {
-      responseType: "arraybuffer"
+    const response = await fetch(this.buildUrl("/v1/text-to-speech"), {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(request)
     });
-    const contentType = String(response.headers["content-type"] || "audio/wav");
+    if (!response.ok) {
+      let errorData;
+      try {
+        errorData = await response.json();
+      } catch {
+      }
+      throw TypecastAPIError.fromResponse(
+        response.status,
+        response.statusText,
+        errorData
+      );
+    }
+    const contentType = response.headers.get("content-type") || "audio/wav";
     const formatFromHeader = contentType.split("/")[1] || "wav";
     const format = formatFromHeader === "mp3" ? "mp3" : "wav";
-    const durationHeader = response.headers["x-audio-duration"];
-    const duration = typeof durationHeader === "string" ? Number(durationHeader) : 0;
+    const durationHeader = response.headers.get("x-audio-duration");
+    const duration = durationHeader ? Number(durationHeader) : 0;
+    const audioData = await response.arrayBuffer();
     return {
-      audioData: response.data,
+      audioData,
       duration,
       format
     };
   }
+  /**
+   * Get available voices (V1 API)
+   * @param model - Optional model filter (e.g., 'ssfm-v21', 'ssfm-v30')
+   * @returns List of available voices with their emotions
+   * @deprecated Use getVoicesV2() for enhanced metadata and filtering options
+   */
   async getVoices(model) {
-    const response = await this.client.get("/v1/voices", {
-      params: model ? { model } : void 0
-    });
-    return response.data;
+    const response = await fetch(
+      this.buildUrl("/v1/voices", model ? { model } : void 0),
+      { headers: this.headers }
+    );
+    return this.handleResponse(response);
   }
+  /**
+   * Get voice by ID (V1 API)
+   * @param voiceId - The voice ID (e.g., 'tc_62a8975e695ad26f7fb514d1')
+   * @param model - Optional model filter
+   * @returns Voice information including available emotions
+   * @deprecated Use getVoicesV2() for enhanced metadata
+   */
   async getVoiceById(voiceId, model) {
-    const response = await this.client.get(`/v1/voices/${voiceId}`, {
-      params: model ? { model } : void 0
-    });
-    return response.data;
+    const response = await fetch(
+      this.buildUrl(`/v1/voices/${voiceId}`, model ? { model } : void 0),
+      { headers: this.headers }
+    );
+    return this.handleResponse(response);
+  }
+  /**
+   * Get voices with enhanced metadata (V2 API)
+   * Returns voices with model-grouped emotions and additional metadata
+   * @param filter - Optional filter options (model, gender, age, use_cases)
+   */
+  async getVoicesV2(filter) {
+    const response = await fetch(
+      this.buildUrl("/v2/voices", filter),
+      { headers: this.headers }
+    );
+    return this.handleResponse(response);
+  }
+  /**
+   * Get a specific voice by ID with enhanced metadata (V2 API)
+   * @param voiceId - The voice ID (e.g., 'tc_62a8975e695ad26f7fb514d1')
+   * @returns Voice information with model-grouped emotions and metadata
+   */
+  async getVoiceV2(voiceId) {
+    const response = await fetch(
+      this.buildUrl(`/v2/voices/${voiceId}`),
+      { headers: this.headers }
+    );
+    return this.handleResponse(response);
   }
 };
 

package/lib/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":["axios"],"mappings":"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","file":"index.cjs","sourcesContent":["import { ApiErrorResponse } from './types';\n\nexport class TypecastAPIError extends Error {\n  public readonly statusCode: number;\n  public readonly response?: ApiErrorResponse;\n\n  constructor(message: string, statusCode: number, response?: ApiErrorResponse) {\n    super(message);\n    this.name = 'TypecastAPIError';\n    this.statusCode = statusCode;\n    this.response = response;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TypecastAPIError);\n    }\n  }\n\n  static fromResponse(statusCode: number, statusText: string, data?: ApiErrorResponse): TypecastAPIError {\n    let message: string;\n\n    switch (statusCode) {\n      case 400:\n        message = 'Bad Request - The request was invalid or cannot be served';\n        break;\n      case 401:\n        message = 'Unauthorized - Invalid or missing API key';\n        break;\n      case 402:\n        message = 'Payment Required - Insufficient credits to complete the request';\n        break;\n      case 404:\n        message = 'Not Found - The requested resource does not exist';\n        break;\n      case 422:\n        message = 'Validation Error - The request data failed validation';\n        break;\n      case 500:\n        message = 'Internal Server Error - Something went wrong on the server';\n        break;\n      default:\n        message = `API request failed with status ${statusCode}: ${statusText}`;\n    }\n\n    if (data?.detail) {\n      const detailStr = typeof data.detail === 'string' \n        ? data.detail \n        : JSON.stringify(data.detail);\n      message += ` - ${detailStr}`;\n    }\n\n    return new TypecastAPIError(message, statusCode, data);\n  }\n}\n\n","import axios, { AxiosInstance, AxiosError } from 'axios';\nimport { ClientConfig, TTSRequest, TTSResponse, ApiErrorResponse } from './types';\nimport { VoicesResponse } from './types/Voices';\nimport { TypecastAPIError } from './errors';\n\nexport class TypecastClient {\n  private client: AxiosInstance;\n  private config: ClientConfig;\n\n  constructor(config: Partial<ClientConfig> = {}) {\n    this.config = {\n      baseHost: process.env.TYPECAST_API_HOST || 'https://api.typecast.ai',\n      apiKey: process.env.TYPECAST_API_KEY || '',\n      ...config,\n    };\n    this.client = axios.create({\n      baseURL: this.config.baseHost,\n      headers: {\n        'X-API-KEY': this.config.apiKey,\n        'Content-Type': 'application/json',\n      },\n    });\n\n    // Add response interceptor for error handling\n    this.client.interceptors.response.use(\n      (response) => response,\n      (error: AxiosError<ApiErrorResponse>) => {\n        if (error.response) {\n          throw TypecastAPIError.fromResponse(\n            error.response.status,\n            error.response.statusText,\n            error.response.data\n          );\n        }\n        throw error;\n      }\n    );\n  }\n\n  async textToSpeech(request: TTSRequest): Promise<TTSResponse> {\n    const response = await this.client.post<ArrayBuffer>('/v1/text-to-speech', request, {\n      responseType: 'arraybuffer',\n    });\n\n    const contentType = String(response.headers['content-type'] || 'audio/wav');\n    const formatFromHeader = contentType.split('/')[1] || 'wav';\n    const format: 'wav' | 'mp3' = formatFromHeader === 'mp3' ? 'mp3' : 'wav';\n\n    const durationHeader: unknown = response.headers['x-audio-duration'];\n    const duration = typeof durationHeader === 'string' ? Number(durationHeader) : 0;\n\n    return {\n      audioData: response.data,\n      duration,\n      format,\n    };\n  }\n\n  async getVoices(model?: string): Promise<VoicesResponse[]> {\n    const response = await this.client.get<VoicesResponse[]>('/v1/voices', {\n      params: model ? { model } : undefined,\n    });\n    return response.data;\n  }\n\n  async getVoiceById(voiceId: string, model?: string): Promise<VoicesResponse[]> {\n    const response = await this.client.get<VoicesResponse[]>(`/v1/voices/${voiceId}`, {\n      params: model ? { model } : undefined,\n    });\n    return response.data;\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import { ApiErrorResponse } from './types';\n\nexport class TypecastAPIError extends Error {\n  public readonly statusCode: number;\n  public readonly response?: ApiErrorResponse;\n\n  constructor(message: string, statusCode: number, response?: ApiErrorResponse) {\n    super(message);\n    this.name = 'TypecastAPIError';\n    this.statusCode = statusCode;\n    this.response = response;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TypecastAPIError);\n    }\n  }\n\n  static fromResponse(statusCode: number, statusText: string, data?: ApiErrorResponse): TypecastAPIError {\n    let message: string;\n\n    switch (statusCode) {\n      case 400:\n        message = 'Bad Request - The request was invalid or cannot be served';\n        break;\n      case 401:\n        message = 'Unauthorized - Invalid or missing API key';\n        break;\n      case 402:\n        message = 'Payment Required - Insufficient credits to complete the request';\n        break;\n      case 404:\n        message = 'Not Found - The requested resource does not exist';\n        break;\n      case 422:\n        message = 'Validation Error - The request data failed validation';\n        break;\n      case 500:\n        message = 'Internal Server Error - Something went wrong on the server';\n        break;\n      default:\n        message = `API request failed with status ${statusCode}: ${statusText}`;\n    }\n\n    if (data?.detail) {\n      const detailStr = typeof data.detail === 'string' \n        ? data.detail \n        : JSON.stringify(data.detail);\n      message += ` - ${detailStr}`;\n    }\n\n    return new TypecastAPIError(message, statusCode, data);\n  }\n}\n\n","import { ClientConfig, TTSRequest, TTSResponse, ApiErrorResponse } from './types';\nimport { VoicesResponse, VoiceV2Response, VoicesV2Filter } from './types/Voices';\nimport { TypecastAPIError } from './errors';\n\nexport class TypecastClient {\n  private baseHost: string;\n  private headers: Record<string, string>;\n\n  constructor(config: Partial<ClientConfig> = {}) {\n    const finalConfig: ClientConfig = {\n      baseHost: process.env.TYPECAST_API_HOST || 'https://api.typecast.ai',\n      apiKey: process.env.TYPECAST_API_KEY || '',\n      ...config,\n    };\n    this.baseHost = finalConfig.baseHost;\n    this.headers = {\n      'X-API-KEY': finalConfig.apiKey,\n      'Content-Type': 'application/json',\n    };\n  }\n\n  /**\n   * Handle HTTP error responses\n   */\n  private async handleResponse<T>(response: Response): Promise<T> {\n    if (!response.ok) {\n      let errorData: ApiErrorResponse | undefined;\n      try {\n        errorData = (await response.json()) as ApiErrorResponse;\n      } catch {\n        // Response body is not JSON\n      }\n      throw TypecastAPIError.fromResponse(\n        response.status,\n        response.statusText,\n        errorData\n      );\n    }\n    return response.json() as Promise<T>;\n  }\n\n  /**\n   * Build URL with query parameters\n   */\n  private buildUrl(path: string, params?: Record<string, unknown>): string {\n    const url = new URL(path, this.baseHost);\n    if (params) {\n      Object.entries(params).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.append(key, String(value));\n        }\n      });\n    }\n    return url.toString();\n  }\n\n  /**\n   * Convert text to speech\n   * @param request - TTS request parameters including text, voice_id, model, and optional settings\n   * @returns TTSResponse containing audio data, duration, and format\n   */\n  async textToSpeech(request: TTSRequest): Promise<TTSResponse> {\n    const response = await fetch(this.buildUrl('/v1/text-to-speech'), {\n      method: 'POST',\n      headers: this.headers,\n      body: JSON.stringify(request),\n    });\n\n    if (!response.ok) {\n      let errorData: ApiErrorResponse | undefined;\n      try {\n        errorData = (await response.json()) as ApiErrorResponse;\n      } catch {\n        // Response body is not JSON\n      }\n      throw TypecastAPIError.fromResponse(\n        response.status,\n        response.statusText,\n        errorData\n      );\n    }\n\n    const contentType = response.headers.get('content-type') || 'audio/wav';\n    const formatFromHeader = contentType.split('/')[1] || 'wav';\n    const format: 'wav' | 'mp3' = formatFromHeader === 'mp3' ? 'mp3' : 'wav';\n\n    const durationHeader = response.headers.get('x-audio-duration');\n    const duration = durationHeader ? Number(durationHeader) : 0;\n\n    const audioData = await response.arrayBuffer();\n\n    return {\n      audioData,\n      duration,\n      format,\n    };\n  }\n\n  /**\n   * Get available voices (V1 API)\n   * @param model - Optional model filter (e.g., 'ssfm-v21', 'ssfm-v30')\n   * @returns List of available voices with their emotions\n   * @deprecated Use getVoicesV2() for enhanced metadata and filtering options\n   */\n  async getVoices(model?: string): Promise<VoicesResponse[]> {\n    const response = await fetch(\n      this.buildUrl('/v1/voices', model ? { model } : undefined),\n      { headers: this.headers }\n    );\n    return this.handleResponse<VoicesResponse[]>(response);\n  }\n\n  /**\n   * Get voice by ID (V1 API)\n   * @param voiceId - The voice ID (e.g., 'tc_62a8975e695ad26f7fb514d1')\n   * @param model - Optional model filter\n   * @returns Voice information including available emotions\n   * @deprecated Use getVoicesV2() for enhanced metadata\n   */\n  async getVoiceById(voiceId: string, model?: string): Promise<VoicesResponse[]> {\n    const response = await fetch(\n      this.buildUrl(`/v1/voices/${voiceId}`, model ? { model } : undefined),\n      { headers: this.headers }\n    );\n    return this.handleResponse<VoicesResponse[]>(response);\n  }\n\n  /**\n   * Get voices with enhanced metadata (V2 API)\n   * Returns voices with model-grouped emotions and additional metadata\n   * @param filter - Optional filter options (model, gender, age, use_cases)\n   */\n  async getVoicesV2(filter?: VoicesV2Filter): Promise<VoiceV2Response[]> {\n    const response = await fetch(\n      this.buildUrl('/v2/voices', filter as Record<string, unknown>),\n      { headers: this.headers }\n    );\n    return this.handleResponse<VoiceV2Response[]>(response);\n  }\n\n  /**\n   * Get a specific voice by ID with enhanced metadata (V2 API)\n   * @param voiceId - The voice ID (e.g., 'tc_62a8975e695ad26f7fb514d1')\n   * @returns Voice information with model-grouped emotions and metadata\n   */\n  async getVoiceV2(voiceId: string): Promise<VoiceV2Response> {\n    const response = await fetch(\n      this.buildUrl(`/v2/voices/${voiceId}`),\n      { headers: this.headers }\n    );\n    return this.handleResponse<VoiceV2Response>(response);\n  }\n}\n"]}

package/lib/index.d.cts

@@ -25,18 +25,44 @@ interface ClientConfig {
     apiKey: string;
 }
 
-type TTSModel = 'ssfm-v21';
+type TTSModel = 'ssfm-v21' | 'ssfm-v30';
 /**
  * Language code following ISO 639-3 standard
  * Supported languages for text-to-speech conversion
+ *
+ * ssfm-v21: 27 languages
+ * ssfm-v30: 37 languages (includes all v21 languages plus additional ones)
  */
-type LanguageCode = 'eng' | 'kor' | 'jpn' | 'spa' | 'deu' | 'fra' | 'ita' | 'pol' | 'nld' | 'rus' | 'ell' | 'tam' | 'tgl' | 'fin' | 'zho' | 'slk' | 'ara' | 'hrv' | 'ukr' | 'ind' | 'dan' | 'swe' | 'msa' | 'ces' | 'por' | 'bul' | 'ron';
+type LanguageCode = 'eng' | 'kor' | 'jpn' | 'spa' | 'deu' | 'fra' | 'ita' | 'pol' | 'nld' | 'rus' | 'ell' | 'tam' | 'tgl' | 'fin' | 'zho' | 'slk' | 'ara' | 'hrv' | 'ukr' | 'ind' | 'dan' | 'swe' | 'msa' | 'ces' | 'por' | 'bul' | 'ron' | 'ben' | 'hin' | 'hun' | 'nan' | 'nor' | 'pan' | 'tha' | 'tur' | 'vie' | 'yue';
 /**
- * Emotion and style settings for the generated speech
+ * Emotion preset types
+ * ssfm-v21: normal, happy, sad, angry
+ * ssfm-v30: normal, happy, sad, angry, whisper, toneup, tonedown
+ */
+type EmotionPreset = 'normal' | 'happy' | 'sad' | 'angry' | 'whisper' | 'toneup' | 'tonedown';
+/**
+ * Emotion and style settings for ssfm-v21 model
  */
 interface Prompt {
     /** Emotion preset for the voice (default: 'normal') */
-    emotion_preset?: 'happy' | 'sad' | 'normal' | 'angry' | 'tonemid' | 'toneup';
+    emotion_preset?: EmotionPreset;
+    /**
+     * Emotion intensity
+     * @min 0.0
+     * @max 2.0
+     * @default 1.0
+     */
+    emotion_intensity?: number;
+}
+/**
+ * Preset-based emotion control for ssfm-v30 model
+ * Use this when you want to specify a specific emotion preset
+ */
+interface PresetPrompt {
+    /** Must be 'preset' for preset-based emotion control */
+    emotion_type: 'preset';
+    /** Emotion preset to apply (default: 'normal') */
+    emotion_preset?: EmotionPreset;
     /**
      * Emotion intensity
      * @min 0.0
@@ -45,17 +71,44 @@ interface Prompt {
      */
     emotion_intensity?: number;
 }
+/**
+ * Context-aware emotion inference for ssfm-v30 model
+ * The model analyzes surrounding context to infer appropriate emotion
+ */
+interface SmartPrompt {
+    /** Must be 'smart' for context-aware emotion inference */
+    emotion_type: 'smart';
+    /** Text that comes BEFORE the main text (max 2000 chars) */
+    previous_text?: string;
+    /** Text that comes AFTER the main text (max 2000 chars) */
+    next_text?: string;
+}
+/**
+ * Union type for all prompt types
+ * - Prompt: Basic emotion control (ssfm-v21 compatible)
+ * - PresetPrompt: Explicit preset emotion control (ssfm-v30)
+ * - SmartPrompt: Context-aware emotion inference (ssfm-v30)
+ */
+type TTSPrompt = Prompt | PresetPrompt | SmartPrompt;
 /**
  * Audio output settings for controlling the final audio characteristics
  */
 interface Output {
     /**
-     * Output volume
+     * Relative volume scaling of the output audio.
+     * Cannot be used simultaneously with target_lufs.
      * @min 0
      * @max 200
      * @default 100
      */
     volume?: number;
+    /**
+     * Target loudness in LUFS for absolute loudness normalization.
+     * Cannot be used simultaneously with volume.
+     * @min -70
+     * @max 0
+     */
+    target_lufs?: number;
     /**
      * Audio pitch adjustment in semitones
      * @min -12
@@ -92,7 +145,7 @@ interface TTSRequest {
     /** Language code (ISO 639-3). If not provided, will be auto-detected based on text content */
     language?: LanguageCode;
     /** Emotion and style settings for the generated speech */
-    prompt?: Prompt;
+    prompt?: TTSPrompt;
     /** Audio output settings */
     output?: Output;
     /** Random seed for reproducible results (same seed + same parameters = same output) */
@@ -110,20 +163,112 @@ interface TTSResponse {
     format: 'wav' | 'mp3';
 }
 
+/**
+ * V1 Voices response (deprecated, use VoiceV2Response instead)
+ */
 interface VoicesResponse {
     voice_id: string;
     voice_name: string;
     model: TTSModel;
     emotions: string[];
 }
+/**
+ * Gender classification for voices
+ */
+type GenderEnum = 'male' | 'female';
+/**
+ * Age group classification for voices
+ */
+type AgeEnum = 'child' | 'teenager' | 'young_adult' | 'middle_age' | 'elder';
+/**
+ * Use case categories for voices
+ */
+type UseCaseEnum = 'Announcer' | 'Anime' | 'Audiobook' | 'Conversational' | 'Documentary' | 'E-learning' | 'Rapper' | 'Game' | 'Tiktok/Reels' | 'News' | 'Podcast' | 'Voicemail' | 'Ads';
+/**
+ * Model information with supported emotions
+ */
+interface ModelInfo {
+    /** TTS model version (e.g., ssfm-v21, ssfm-v30) */
+    version: TTSModel;
+    /** List of supported emotions for this model */
+    emotions: string[];
+}
+/**
+ * V2 Voice response with enhanced metadata
+ */
+interface VoiceV2Response {
+    /** Unique voice identifier */
+    voice_id: string;
+    /** Human-readable name of the voice */
+    voice_name: string;
+    /** List of supported TTS models with their available emotions */
+    models: ModelInfo[];
+    /** Voice gender classification */
+    gender?: GenderEnum | null;
+    /** Voice age group classification */
+    age?: AgeEnum | null;
+    /** List of use case categories this voice is suitable for */
+    use_cases?: string[];
+}
+/**
+ * Filter options for V2 voices endpoint
+ */
+interface VoicesV2Filter {
+    /** Filter by TTS model */
+    model?: TTSModel;
+    /** Filter by gender */
+    gender?: GenderEnum;
+    /** Filter by age group */
+    age?: AgeEnum;
+    /** Filter by use case */
+    use_cases?: UseCaseEnum;
+}
 
 declare class TypecastClient {
-    private client;
-    private config;
+    private baseHost;
+    private headers;
     constructor(config?: Partial<ClientConfig>);
+    /**
+     * Handle HTTP error responses
+     */
+    private handleResponse;
+    /**
+     * Build URL with query parameters
+     */
+    private buildUrl;
+    /**
+     * Convert text to speech
+     * @param request - TTS request parameters including text, voice_id, model, and optional settings
+     * @returns TTSResponse containing audio data, duration, and format
+     */
     textToSpeech(request: TTSRequest): Promise<TTSResponse>;
+    /**
+     * Get available voices (V1 API)
+     * @param model - Optional model filter (e.g., 'ssfm-v21', 'ssfm-v30')
+     * @returns List of available voices with their emotions
+     * @deprecated Use getVoicesV2() for enhanced metadata and filtering options
+     */
     getVoices(model?: string): Promise<VoicesResponse[]>;
+    /**
+     * Get voice by ID (V1 API)
+     * @param voiceId - The voice ID (e.g., 'tc_62a8975e695ad26f7fb514d1')
+     * @param model - Optional model filter
+     * @returns Voice information including available emotions
+     * @deprecated Use getVoicesV2() for enhanced metadata
+     */
     getVoiceById(voiceId: string, model?: string): Promise<VoicesResponse[]>;
+    /**
+     * Get voices with enhanced metadata (V2 API)
+     * Returns voices with model-grouped emotions and additional metadata
+     * @param filter - Optional filter options (model, gender, age, use_cases)
+     */
+    getVoicesV2(filter?: VoicesV2Filter): Promise<VoiceV2Response[]>;
+    /**
+     * Get a specific voice by ID with enhanced metadata (V2 API)
+     * @param voiceId - The voice ID (e.g., 'tc_62a8975e695ad26f7fb514d1')
+     * @returns Voice information with model-grouped emotions and metadata
+     */
+    getVoiceV2(voiceId: string): Promise<VoiceV2Response>;
 }
 
 declare class TypecastAPIError extends Error {
@@ -133,4 +278,4 @@ declare class TypecastAPIError extends Error {
     static fromResponse(statusCode: number, statusText: string, data?: ApiErrorResponse): TypecastAPIError;
 }
 
-export { type ApiErrorResponse, type ClientConfig, type LanguageCode, type Output, type Prompt, type TTSModel, type TTSRequest, type TTSResponse, TypecastAPIError, TypecastClient, type ValidationError, type ValidationErrorResponse, type VoicesResponse };
+export { type AgeEnum, type ApiErrorResponse, type ClientConfig, type EmotionPreset, type GenderEnum, type LanguageCode, type ModelInfo, type Output, type PresetPrompt, type Prompt, type SmartPrompt, type TTSModel, type TTSPrompt, type TTSRequest, type TTSResponse, TypecastAPIError, TypecastClient, type UseCaseEnum, type ValidationError, type ValidationErrorResponse, type VoiceV2Response, type VoicesResponse, type VoicesV2Filter };

package/lib/index.d.ts

@@ -25,18 +25,44 @@ interface ClientConfig {
     apiKey: string;
 }
 
-type TTSModel = 'ssfm-v21';
+type TTSModel = 'ssfm-v21' | 'ssfm-v30';
 /**
  * Language code following ISO 639-3 standard
  * Supported languages for text-to-speech conversion
+ *
+ * ssfm-v21: 27 languages
+ * ssfm-v30: 37 languages (includes all v21 languages plus additional ones)
  */
-type LanguageCode = 'eng' | 'kor' | 'jpn' | 'spa' | 'deu' | 'fra' | 'ita' | 'pol' | 'nld' | 'rus' | 'ell' | 'tam' | 'tgl' | 'fin' | 'zho' | 'slk' | 'ara' | 'hrv' | 'ukr' | 'ind' | 'dan' | 'swe' | 'msa' | 'ces' | 'por' | 'bul' | 'ron';
+type LanguageCode = 'eng' | 'kor' | 'jpn' | 'spa' | 'deu' | 'fra' | 'ita' | 'pol' | 'nld' | 'rus' | 'ell' | 'tam' | 'tgl' | 'fin' | 'zho' | 'slk' | 'ara' | 'hrv' | 'ukr' | 'ind' | 'dan' | 'swe' | 'msa' | 'ces' | 'por' | 'bul' | 'ron' | 'ben' | 'hin' | 'hun' | 'nan' | 'nor' | 'pan' | 'tha' | 'tur' | 'vie' | 'yue';
 /**
- * Emotion and style settings for the generated speech
+ * Emotion preset types
+ * ssfm-v21: normal, happy, sad, angry
+ * ssfm-v30: normal, happy, sad, angry, whisper, toneup, tonedown
+ */
+type EmotionPreset = 'normal' | 'happy' | 'sad' | 'angry' | 'whisper' | 'toneup' | 'tonedown';
+/**
+ * Emotion and style settings for ssfm-v21 model
  */
 interface Prompt {
     /** Emotion preset for the voice (default: 'normal') */
-    emotion_preset?: 'happy' | 'sad' | 'normal' | 'angry' | 'tonemid' | 'toneup';
+    emotion_preset?: EmotionPreset;
+    /**
+     * Emotion intensity
+     * @min 0.0
+     * @max 2.0
+     * @default 1.0
+     */
+    emotion_intensity?: number;
+}
+/**
+ * Preset-based emotion control for ssfm-v30 model
+ * Use this when you want to specify a specific emotion preset
+ */
+interface PresetPrompt {
+    /** Must be 'preset' for preset-based emotion control */
+    emotion_type: 'preset';
+    /** Emotion preset to apply (default: 'normal') */
+    emotion_preset?: EmotionPreset;
     /**
      * Emotion intensity
      * @min 0.0
@@ -45,17 +71,44 @@ interface Prompt {
      */
     emotion_intensity?: number;
 }
+/**
+ * Context-aware emotion inference for ssfm-v30 model
+ * The model analyzes surrounding context to infer appropriate emotion
+ */
+interface SmartPrompt {
+    /** Must be 'smart' for context-aware emotion inference */
+    emotion_type: 'smart';
+    /** Text that comes BEFORE the main text (max 2000 chars) */
+    previous_text?: string;
+    /** Text that comes AFTER the main text (max 2000 chars) */
+    next_text?: string;
+}
+/**
+ * Union type for all prompt types
+ * - Prompt: Basic emotion control (ssfm-v21 compatible)
+ * - PresetPrompt: Explicit preset emotion control (ssfm-v30)
+ * - SmartPrompt: Context-aware emotion inference (ssfm-v30)
+ */
+type TTSPrompt = Prompt | PresetPrompt | SmartPrompt;
 /**
  * Audio output settings for controlling the final audio characteristics
  */
 interface Output {
     /**
-     * Output volume
+     * Relative volume scaling of the output audio.
+     * Cannot be used simultaneously with target_lufs.
      * @min 0
      * @max 200
      * @default 100
      */
     volume?: number;
+    /**
+     * Target loudness in LUFS for absolute loudness normalization.
+     * Cannot be used simultaneously with volume.
+     * @min -70
+     * @max 0
+     */
+    target_lufs?: number;
     /**
      * Audio pitch adjustment in semitones
      * @min -12
@@ -92,7 +145,7 @@ interface TTSRequest {
     /** Language code (ISO 639-3). If not provided, will be auto-detected based on text content */
     language?: LanguageCode;
     /** Emotion and style settings for the generated speech */
-    prompt?: Prompt;
+    prompt?: TTSPrompt;
     /** Audio output settings */
     output?: Output;
     /** Random seed for reproducible results (same seed + same parameters = same output) */
@@ -110,20 +163,112 @@ interface TTSResponse {
     format: 'wav' | 'mp3';
 }
 
+/**
+ * V1 Voices response (deprecated, use VoiceV2Response instead)
+ */
 interface VoicesResponse {
     voice_id: string;
     voice_name: string;
     model: TTSModel;
     emotions: string[];
 }
+/**
+ * Gender classification for voices
+ */
+type GenderEnum = 'male' | 'female';
+/**
+ * Age group classification for voices
+ */
+type AgeEnum = 'child' | 'teenager' | 'young_adult' | 'middle_age' | 'elder';
+/**
+ * Use case categories for voices
+ */
+type UseCaseEnum = 'Announcer' | 'Anime' | 'Audiobook' | 'Conversational' | 'Documentary' | 'E-learning' | 'Rapper' | 'Game' | 'Tiktok/Reels' | 'News' | 'Podcast' | 'Voicemail' | 'Ads';
+/**
+ * Model information with supported emotions
+ */
+interface ModelInfo {
+    /** TTS model version (e.g., ssfm-v21, ssfm-v30) */
+    version: TTSModel;
+    /** List of supported emotions for this model */
+    emotions: string[];
+}
+/**
+ * V2 Voice response with enhanced metadata
+ */
+interface VoiceV2Response {
+    /** Unique voice identifier */
+    voice_id: string;
+    /** Human-readable name of the voice */
+    voice_name: string;
+    /** List of supported TTS models with their available emotions */
+    models: ModelInfo[];
+    /** Voice gender classification */
+    gender?: GenderEnum | null;
+    /** Voice age group classification */
+    age?: AgeEnum | null;
+    /** List of use case categories this voice is suitable for */
+    use_cases?: string[];
+}
+/**
+ * Filter options for V2 voices endpoint
+ */
+interface VoicesV2Filter {
+    /** Filter by TTS model */
+    model?: TTSModel;
+    /** Filter by gender */
+    gender?: GenderEnum;
+    /** Filter by age group */
+    age?: AgeEnum;
+    /** Filter by use case */
+    use_cases?: UseCaseEnum;
+}
 
 declare class TypecastClient {
-    private client;
-    private config;
+    private baseHost;
+    private headers;
     constructor(config?: Partial<ClientConfig>);
+    /**
+     * Handle HTTP error responses
+     */
+    private handleResponse;
+    /**
+     * Build URL with query parameters
+     */
+    private buildUrl;
+    /**
+     * Convert text to speech
+     * @param request - TTS request parameters including text, voice_id, model, and optional settings
+     * @returns TTSResponse containing audio data, duration, and format
+     */
     textToSpeech(request: TTSRequest): Promise<TTSResponse>;
+    /**
+     * Get available voices (V1 API)
+     * @param model - Optional model filter (e.g., 'ssfm-v21', 'ssfm-v30')
+     * @returns List of available voices with their emotions
+     * @deprecated Use getVoicesV2() for enhanced metadata and filtering options
+     */
     getVoices(model?: string): Promise<VoicesResponse[]>;
+    /**
+     * Get voice by ID (V1 API)
+     * @param voiceId - The voice ID (e.g., 'tc_62a8975e695ad26f7fb514d1')
+     * @param model - Optional model filter
+     * @returns Voice information including available emotions
+     * @deprecated Use getVoicesV2() for enhanced metadata
+     */
     getVoiceById(voiceId: string, model?: string): Promise<VoicesResponse[]>;
+    /**
+     * Get voices with enhanced metadata (V2 API)
+     * Returns voices with model-grouped emotions and additional metadata
+     * @param filter - Optional filter options (model, gender, age, use_cases)
+     */
+    getVoicesV2(filter?: VoicesV2Filter): Promise<VoiceV2Response[]>;
+    /**
+     * Get a specific voice by ID with enhanced metadata (V2 API)
+     * @param voiceId - The voice ID (e.g., 'tc_62a8975e695ad26f7fb514d1')
+     * @returns Voice information with model-grouped emotions and metadata
+     */
+    getVoiceV2(voiceId: string): Promise<VoiceV2Response>;
 }
 
 declare class TypecastAPIError extends Error {
@@ -133,4 +278,4 @@ declare class TypecastAPIError extends Error {
     static fromResponse(statusCode: number, statusText: string, data?: ApiErrorResponse): TypecastAPIError;
 }
 
-export { type ApiErrorResponse, type ClientConfig, type LanguageCode, type Output, type Prompt, type TTSModel, type TTSRequest, type TTSResponse, TypecastAPIError, TypecastClient, type ValidationError, type ValidationErrorResponse, type VoicesResponse };
+export { type AgeEnum, type ApiErrorResponse, type ClientConfig, type EmotionPreset, type GenderEnum, type LanguageCode, type ModelInfo, type Output, type PresetPrompt, type Prompt, type SmartPrompt, type TTSModel, type TTSPrompt, type TTSRequest, type TTSResponse, TypecastAPIError, TypecastClient, type UseCaseEnum, type ValidationError, type ValidationErrorResponse, type VoiceV2Response, type VoicesResponse, type VoicesV2Filter };