@facepe/widget-mobile-app 1.0.0 → 1.2.0

package/dist/FacePeMobileProvider.d.ts

@@ -1,4 +1,4 @@
-import React, { type ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import type { FacePeMobileConfig, TokenProvider } from './types';
 interface FacePeContextValue {
     config: FacePeMobileConfig;
@@ -14,6 +14,6 @@ export interface FacePeMobileProviderProps {
     apiBaseUrl?: string;
     config?: FacePeMobileConfig;
 }
-export declare function FacePeMobileProvider({ children, getToken, apiBaseUrl, config, }: FacePeMobileProviderProps): React.JSX.Element;
+export declare function FacePeMobileProvider({ children, getToken, apiBaseUrl, config, }: FacePeMobileProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useFacePeMobileContext(): FacePeContextValue;
 export {};

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 export type AvatarGender = 'female' | 'male';
-export type StreamMode = 'native' | 'webview' | 'auto';
+export type FacePeConnectionStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected' | 'error';
 export interface FacePeMobileTheme {
     primaryColor?: string;
     backgroundColor?: string;
@@ -23,11 +23,9 @@ export interface FacePeMobileConfig {
     avatarKey?: string;
     /** Default language code (e.g., 'en', 'es', 'hi') */
     language?: string;
-    /** Integration mode: 'auto', 'native', or 'webview' */
-    mode?: StreamMode;
     /** Theme styling overrides */
     theme?: FacePeMobileTheme;
-    /** Optional audio autoplay unblocking flag */
+    /** Auto start streaming when component mounts (default: true) */
     autoStart?: boolean;
 }
 export interface TokenProviderParams {
@@ -35,12 +33,22 @@ export interface TokenProviderParams {
 }
 export type TokenProvider = (params: TokenProviderParams) => Promise<string>;
 export interface FacePeMobileAvatarProps {
-    /** Optional avatar key override */
+    /** Specific avatar identifier or key override */
     avatarKey?: string;
     /** Language to converse in ('en', 'es', 'hi', etc.) */
     language?: string;
-    /** Custom style object */
+    /** Custom container style */
     style?: any;
+    /** Custom video style */
+    videoStyle?: any;
+    /** Video scaling: 'cover' or 'contain' (default: 'cover') */
+    objectFit?: 'cover' | 'contain';
+    /** Whether to mirror the video stream (default: false) */
+    mirror?: boolean;
+    /** Auto start streaming when component mounts (default: true) */
+    autoStart?: boolean;
+    /** Whether microphone should be automatically enabled on stream start (default: true) */
+    enableMic?: boolean;
     /** Called when real-time speech transcription arrives */
     onTranscript?: (event: {
         payload: TranscriptPayload;
@@ -49,7 +57,7 @@ export interface FacePeMobileAvatarProps {
     onSpeakStart?: () => void;
     /** Called when avatar finishes speaking */
     onSpeakEnd?: () => void;
-    /** Called when user starts speaking (detected by VAD) */
+    /** Called when user starts speaking (detected by server VAD) */
     onUserSpeakStart?: () => void;
     /** Called when user finishes speaking */
     onUserSpeakEnd?: () => void;
@@ -59,9 +67,29 @@ export interface FacePeMobileAvatarProps {
     }) => void;
     /** Called when customer says checkout / pay */
     onCheckout?: () => void;
+    /** Called when stream connection status changes */
+    onStatusChange?: (status: FacePeConnectionStatus) => void;
     /** Called when an error occurs */
     onError?: (event: {
         code: string;
         message: string;
     }) => void;
 }
+export interface FacePeMobileAvatarRef {
+    /** Start avatar streaming session */
+    start: () => Promise<void>;
+    /** Stop streaming and close session */
+    stop: () => Promise<void>;
+    /** Toggle user microphone on/off, returning new enabled state */
+    toggleMic: () => Promise<boolean>;
+    /** Explicitly set microphone state */
+    setMicEnabled: (enabled: boolean) => Promise<void>;
+    /** Programmatically make avatar speak a phrase */
+    speak: (text: string) => Promise<void>;
+    /** Interrupt avatar speech immediately */
+    interrupt: () => Promise<void>;
+    /** Current connection status */
+    readonly status: FacePeConnectionStatus;
+    /** Whether microphone is currently enabled */
+    readonly isMicEnabled: boolean;
+}

package/dist/useFacePeAvatar.d.ts

@@ -1,13 +1,15 @@
-import type { TranscriptPayload, OrderItem } from './types';
+import type { TranscriptPayload, OrderItem, FacePeConnectionStatus, FacePeMobileAvatarProps } from './types';
 export interface UseFacePeAvatarResult {
     token: string | null;
     loading: boolean;
     error: Error | null;
+    status: FacePeConnectionStatus;
     transcripts: TranscriptPayload[];
     isAvatarSpeaking: boolean;
     isUserSpeaking: boolean;
     orderItems: OrderItem[];
     refreshToken: (force?: boolean) => Promise<string | null>;
     clearTranscripts: () => void;
+    avatarProps: Pick<FacePeMobileAvatarProps, 'onTranscript' | 'onSpeakStart' | 'onSpeakEnd' | 'onUserSpeakStart' | 'onUserSpeakEnd' | 'onOrderUpdate' | 'onStatusChange'>;
 }
 export declare function useFacePeAvatar(): UseFacePeAvatarResult;

package/dist/useFacePeAvatar.js

@@ -1,7 +1,8 @@
-import { useState, useCallback } from 'react';
+import { useState, useCallback, useMemo } from 'react';
 import { useFacePeMobileContext } from './FacePeMobileProvider';
 export function useFacePeAvatar() {
     const { token, loading, error, refreshToken } = useFacePeMobileContext();
+    const [status, setStatus] = useState('idle');
     const [transcripts, setTranscripts] = useState([]);
     const [isAvatarSpeaking, setIsAvatarSpeaking] = useState(false);
     const [isUserSpeaking, setIsUserSpeaking] = useState(false);
@@ -9,15 +10,55 @@ export function useFacePeAvatar() {
     const clearTranscripts = useCallback(() => {
         setTranscripts([]);
     }, []);
+    const handleTranscript = useCallback((event) => {
+        setTranscripts((prev) => [...prev, event.payload]);
+    }, []);
+    const handleSpeakStart = useCallback(() => {
+        setIsAvatarSpeaking(true);
+    }, []);
+    const handleSpeakEnd = useCallback(() => {
+        setIsAvatarSpeaking(false);
+    }, []);
+    const handleUserSpeakStart = useCallback(() => {
+        setIsUserSpeaking(true);
+    }, []);
+    const handleUserSpeakEnd = useCallback(() => {
+        setIsUserSpeaking(false);
+    }, []);
+    const handleOrderUpdate = useCallback((event) => {
+        setOrderItems(event.items);
+    }, []);
+    const handleStatusChange = useCallback((newStatus) => {
+        setStatus(newStatus);
+    }, []);
+    const avatarProps = useMemo(() => ({
+        onTranscript: handleTranscript,
+        onSpeakStart: handleSpeakStart,
+        onSpeakEnd: handleSpeakEnd,
+        onUserSpeakStart: handleUserSpeakStart,
+        onUserSpeakEnd: handleUserSpeakEnd,
+        onOrderUpdate: handleOrderUpdate,
+        onStatusChange: handleStatusChange,
+    }), [
+        handleTranscript,
+        handleSpeakStart,
+        handleSpeakEnd,
+        handleUserSpeakStart,
+        handleUserSpeakEnd,
+        handleOrderUpdate,
+        handleStatusChange,
+    ]);
     return {
         token,
         loading,
         error,
+        status,
         transcripts,
         isAvatarSpeaking,
         isUserSpeaking,
         orderItems,
         refreshToken,
         clearTranscripts,
+        avatarProps,
     };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@facepe/widget-mobile-app",
-  "version": "1.0.0",
-  "description": "FacePe AI 3D Video Avatar Live Streaming SDK for React Native (iOS & Android)",
+  "version": "1.2.0",
+  "description": "FacePe AI 3D Video Avatar Native Live Streaming SDK for React Native (iOS & Android)",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,7 +21,8 @@
     "ios",
     "android",
     "webrtc",
-    "streaming"
+    "streaming",
+    "digital-human"
   ],
   "author": "FacePe AI",
   "license": "MIT",
@@ -30,8 +31,12 @@
     "build": "tsc"
   },
   "peerDependencies": {
+    "@livekit/react-native": ">=2.0.0",
+    "@livekit/react-native-webrtc": ">=124.0.0",
+    "livekit-client": ">=2.0.0",
     "react": ">=18.0.0",
-    "react-native": ">=0.70.0"
+    "react-native": ">=0.70.0",
+    "@anam-ai/js-sdk": ">=4.27.0"
   },
   "peerDependenciesMeta": {
     "@livekit/react-native": {
@@ -40,7 +45,10 @@
     "@livekit/react-native-webrtc": {
       "optional": true
     },
-    "react-native-webview": {
+    "livekit-client": {
+      "optional": true
+    },
+    "@anam-ai/js-sdk": {
       "optional": true
     }
   },