@streamoji/aitwin 0.1.9 → 0.2.0

package/dist/index.d.ts

@@ -24,11 +24,21 @@ export declare class AiTwinNotFoundError extends Error {
 }
 
 export declare type AiTwinProps = {
-    /** Twin id for getAiTwin (e.g. `olivia`). Omit when `assets` is set. */
+    /** Twin id for getAiTwin (e.g. `olivia`). Omit when `assets` or `avatarId`/`faceId` is set. */
     id?: string;
+    /**
+     * 64-char hex R2 custom-faces id (pipeline `avatarId`).
+     * Loads encrypted CDN assets directly; skips getAiTwin.
+     * Alias: `faceId`.
+     */
+    avatarId?: string;
+    /**
+     * Same as `avatarId` — R2 custom-faces/{faceId}/ bundle id from getAiTwin or the pipeline.
+     */
+    faceId?: string;
     /**
      * Preconfigured asset URLs (e.g. local `twins/blondelady`).
-     * When set, skips getAiTwin.
+     * When set, skips getAiTwin and `avatarId`/`faceId`.
      */
     assets?: TwinAssetUrls;
     /**
@@ -36,7 +46,7 @@ export declare type AiTwinProps = {
      * When omitted, a dev token is fetched via getAuthToken.
      */
     authToken?: string;
-    /** TTS engine when using `assets` (default: Google engine id). */
+    /** TTS engine when using `assets` or `avatarId`/`faceId` (default: Cartesia). */
     ttsEngineId?: TtsEngineId;
     /** TTS voice id override (engine-specific). */
     voiceId?: string;
@@ -113,6 +123,8 @@ export declare function createRealtimeVoiceLipsyncController(onStatus: (status:
 
 export declare const DEFAULT_TTS_ENGINE_ID: TtsEngineId;
 
+export declare function faceAssetUrls(faceId: string, cdnBase?: string): TwinAssetUrls;
+
 export declare function fetchAiTwin(id: string, baseUrl?: string): Promise<AiTwinRecord>;
 
 /** Bearer token for /avatar_ttsWithPoses and /api/session-value. */
@@ -172,6 +184,9 @@ export declare type RealtimeVoiceOptions = VoiceConnectOptions & {
     onLipsyncDebug?: (snapshot: RealtimeLipsyncDebugSnapshot) => void;
 };
 
+/** Resolve optional `avatarId` / `faceId` props (same R2 custom-faces hex id). */
+export declare function resolveDirectFaceId(avatarId?: string, faceId?: string): string | undefined;
+
 /** Pick the active viseme at playback offset (latest vtime wins on overlap). */
 export declare function resolveVisemeAtTime(queue: VisemeQueueItem[], elapsedMs: number): string;
 
@@ -187,6 +202,8 @@ export declare interface SentenceEmotion {
     end_word: number;
 }
 
+export declare function setActiveTwinAssets(urls: TwinAssetUrls): void;
+
 export declare const SPEAKING_RATE_MAX = 1.5;
 
 export declare const SPEAKING_RATE_MIN = 0.5;

package/package.json

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