@streamoji/aitwin 0.1.9 → 0.2.1

package/dist/index.d.ts

@@ -2,6 +2,8 @@ import { CSSProperties } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { RefAttributes } from 'react';
 
+export declare const AI_TWIN_THUMBNAIL_FILENAME = "thumbnail.webp";
+
 export declare const AiTwin: ForwardRefExoticComponent<AiTwinProps & RefAttributes<AiTwinHandle>>;
 
 export declare type AiTwinHandle = {
@@ -24,11 +26,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 +48,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,11 +125,16 @@ 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. */
 export declare function fetchDevAuthToken(): Promise<string>;
 
+/** Public CDN thumbnail for custom-faces/{faceId}/ (same id as pipeline avatarId). */
+export declare function getAiTwinThumbnailUrl(faceId: string, cdnBase?: string): string;
+
 export declare const MIC_SAMPLE_RATE = 16000;
 
 /** Google TTS streams Oculus viseme symbols; normalize casing and unknown ids. */
@@ -172,6 +189,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 +207,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.1",
   "description": "Embeddable React AI twin face with TTS lipsync",
   "type": "module",
   "main": "./dist/aitwin.cjs",