@streamoji/aitwin 0.6.1 → 0.6.2

package/dist/index.d.ts

@@ -82,9 +82,12 @@ export declare type AiTwinProps = {
     authToken?: string;
     /** Avatar API base (TTS, session-value, voice). Default: package `DEFAULT_API_BASE`. */
     apiBase?: string;
-    /** TTS engine when using `assets` or `avatarId`/`faceId` (default: Cartesia). */
+    /** TTS engine when using `assets` or `avatarId`/`faceId` (default: Cartesia). Optional if `voiceId` is packed as `engine:voice`. */
     ttsEngineId?: TtsEngineId;
-    /** TTS voice id override (engine-specific). */
+    /**
+     * TTS voice id. May be a bare id (`eve`, Cartesia UUID) or packed
+     * `ttsEngineId:voiceId` (e.g. `visemetts:eve`).
+     */
     voiceId?: string;
     /** API speakingRate (default: 0.85). */
     speakingRate?: number;
@@ -410,6 +413,15 @@ export declare function normalizeStreamEmotion(raw: string | undefined | null, f
 /** Oculus viseme ids for Talking Lady stills and pair transitions (15 standard). */
 export declare const OCULUS_VISEME_IDS: readonly ["aa", "CH", "DD", "E", "FF", "I", "O", "PP", "RR", "SS", "TH", "U", "kk", "nn", "sil"];
 
+/**
+ * `voiceId` may be a bare id (`eve`) or packed `engine:voice` (`visemetts:eve`).
+ * Cartesia UUIDs have no colon, so they stay a plain voice id.
+ */
+export declare function parsePackedVoiceId(raw?: string): {
+    ttsEngineId?: TtsEngineId;
+    voiceId?: string;
+};
+
 export declare const PLAYBACK_SAMPLE_RATE = 16000;
 
 declare type RawVisemeTransition = {
@@ -510,6 +522,12 @@ export declare const SPEAKING_RATE_MAX = 1.5;
 
 export declare const SPEAKING_RATE_MIN = 0.5;
 
+/** Merge explicit `ttsEngineId` with a possibly packed `voiceId`. Packed engine wins only if engine is omitted. */
+export declare function splitVoiceIdSpec(ttsEngineId?: TtsEngineId, voiceId?: string): {
+    ttsEngineId?: TtsEngineId;
+    voiceId?: string;
+};
+
 export declare const TTS_ENGINE_CARTESIA = "eng_c9b1e6d4";
 
 /** Opaque TTS engine ids — must match backend TTS_ENGINE_MAP in main.py. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamoji/aitwin",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Embeddable React AI twin face with TTS lipsync",
   "type": "module",
   "main": "./dist/aitwin.cjs",