omikit-plugin 3.3.28 → 4.0.1

package/src/omi_remote_camera.tsx

@@ -1,11 +1,20 @@
 import type { HostComponent } from 'react-native';
 import { NativeModules, requireNativeComponent, ViewProps } from 'react-native';
 
-const FLRemoteCamera = NativeModules.FLRemoteCameraView;
+// Camera Views always use Paper (requireNativeComponent) because:
+// - iOS native code doesn't have Fabric ComponentView implementation yet
+// - Paper components work fine even when New Architecture is enabled
+// - This avoids undefined symbol errors (_FLRemoteCameraViewCls)
+const OmiRemoteCameraViewPaper: HostComponent<ViewProps> = requireNativeComponent(
+  'FLRemoteCameraView'
+);
 
-export const OmiRemoteCameraView: HostComponent<ViewProps> =
-  requireNativeComponent('FLRemoteCameraView');
+// Export the Paper component
+export const OmiRemoteCameraView: HostComponent<ViewProps> = OmiRemoteCameraViewPaper;
 
+// Module name separated from ViewManager name to avoid name collision
+const FLRemoteCamera = NativeModules.FLRemoteCameraModule || NativeModules.FLRemoteCameraView;
 export function refreshRemoteCamera(): Promise<boolean> {
+  if (!FLRemoteCamera) return Promise.resolve(false);
   return FLRemoteCamera.refresh();
 }

package/src/omi_start_call_status.tsx

@@ -1,12 +1,31 @@
+/**
+ * Status codes returned by startCall() function
+ * Use these to handle different call initiation results
+ */
 export enum OmiStartCallStatus {
-  invalidUuid = 0,
-  invalidPhoneNumber = 1,
-  samePhoneNumber = 2,
-  maxRetry = 3,
-  permissionDenied = 4,
-  couldNotFindEndpoint = 5,
-  accountRegisterFailed = 6,
-  startCallFailed = 7,
-  startCallSuccess = 8,
-  haveAnotherCall = 9,
+  // Validation errors (0-3)
+  invalidUuid = 0,              // Invalid user UUID
+  invalidPhoneNumber = 1,       // Invalid phone number format
+  samePhoneNumber = 2,          // Cannot call same phone number
+  maxRetry = 3,                 // Maximum retry attempts reached
+
+  // Permission errors (4, 450-452)
+  permissionDenied = 4,         // Microphone/Camera permission denied
+  permissionMicrophone = 450,   // Microphone permission required (Android 15+)
+  permissionCamera = 451,       // Camera permission required (Android 15+)
+  permissionOverlay = 452,      // System alert window permission required (Android 15+)
+
+  // Call errors (5-7)
+  couldNotFindEndpoint = 5,     // Could not find endpoint
+  accountRegisterFailed = 6,    // Account registration failed
+  startCallFailed = 7,          // Start call failed
+
+  // Success statuses (8, 407)
+  startCallSuccess = 8,         // Call initiated successfully (Android)
+  startCallSuccessIOS = 407,    // Call initiated successfully (iOS)
+
+  // Other errors (9+)
+  haveAnotherCall = 9,          // Already have another call in progress
+  accountTurnOffNumberInternal = 10, // Internal number has been deactivated
+  noNetwork = 11,               // No network connection available
 }

package/src/omikit.tsx

@@ -1,4 +1,5 @@
-import { NativeModules, Platform, NativeEventEmitter, DeviceEventEmitter } from 'react-native';
+import { NativeModules, Platform, NativeEventEmitter, DeviceEventEmitter, TurboModuleRegistry } from 'react-native';
+import type { Spec } from './NativeOmikitPlugin';
 
 const LINKING_ERROR =
   `The package 'omikit-plugin' doesn't seem to be linked. Make sure: \n\n` +
@@ -6,10 +7,20 @@ const LINKING_ERROR =
   '- You rebuilt the app after installing the package\n' +
   '- You are not using Expo Go\n';
 
-// ✅ Khai báo chính xác Native Module
-const OmikitPlugin = NativeModules.OmikitPlugin
-  ? NativeModules.OmikitPlugin
-  : new Proxy(
+// Runtime detection: Try TurboModule first, fallback to NativeModule
+const isTurboModuleEnabled = (global as any).__turboModuleProxy != null;
+
+const OmikitPlugin: Spec = (() => {
+  if (isTurboModuleEnabled) {
+    // New Architecture - use TurboModule
+    const turboModule = TurboModuleRegistry.get<Spec>('OmikitPlugin');
+    if (turboModule) {
+      return turboModule;
+    }
+  }
+
+  // Old Architecture - fallback to NativeModule
+  return NativeModules.OmikitPlugin || new Proxy(
     {},
     {
       get() {
@@ -17,10 +28,17 @@ const OmikitPlugin = NativeModules.OmikitPlugin
       },
     }
   );
+})();
 
-// ✅ Setup omiEmitter cho iOS và Android
+// Setup omiEmitter for iOS and Android
+// In bridgeless mode, NativeModules is empty — use TurboModule instance instead
 const omiEmitter = Platform.OS === 'ios'
-  ? new NativeEventEmitter(OmikitPlugin)
+  ? new NativeEventEmitter(
+      (NativeModules.OmikitPlugin ?? OmikitPlugin ?? {
+        addListener: () => {},
+        removeListeners: () => {},
+      }) as any
+    )
   : DeviceEventEmitter;
 
 /**
@@ -41,14 +59,14 @@ export function configPushNotification(data: any): Promise<any> {
 }
 
 /**
- * Retrieves the initial call details when start call 
+ * Retrieves the initial call details when start call
  * @returns {Promise<any>} A promise containing the initial call details.
  */
 export function getInitialCall(): Promise<any> {
   if (Platform.OS == "ios") {
-    return OmikitPlugin.getInitialCall();
+    return OmikitPlugin.getInitialCall({ counter: 0 });
   } else {
-    return OmikitPlugin.getInitialCall(4);
+    return OmikitPlugin.getInitialCall({ counter: 4 });
   }
 }
 
@@ -73,9 +91,9 @@ export function initCallWithApiKey(data: any): Promise<boolean> {
 /**
  * Starts a new call with the given data.
  * @param {any} data - Call configuration data.
- * @returns {Promise<boolean>} A promise that resolves to `true` if the call starts successfully.
+ * @returns {Promise<any>} A promise that resolves with call details if successful.
  */
-export function startCall(data: any): Promise<boolean> {
+export function startCall(data: any): Promise<any> {
   return OmikitPlugin.startCall(data);
 }
 
@@ -106,9 +124,9 @@ export function endCall(): Promise<any> {
 
 /**
  * Toggles the mute status of the microphone.
- * @returns {Promise<boolean>} A promise that resolves to `true` if the microphone is muted, `false` otherwise.
+ * @returns {Promise<boolean | null>} A promise that resolves to `true` if the microphone is muted, `false` otherwise, or `null` if unavailable.
  */
-export function toggleMute(): Promise<boolean> {
+export function toggleMute(): Promise<boolean | null> {
   return OmikitPlugin.toggleMute();
 }
 
@@ -122,9 +140,9 @@ export function toggleSpeaker(): Promise<boolean> {
 
 /**
  * Toggles the hold call.
- * @returns {Promise<boolean>} A promise that resolves to `true` if when hold call success, `false` otherwise.
+ * @returns {Promise<void>} A promise that resolves when hold call is toggled.
  */
-export function toggleHold(): Promise<boolean> {
+export function toggleHold(): Promise<void> {
   return OmikitPlugin.toggleHold();
 }
 
@@ -282,7 +300,7 @@ export function hideSystemNotificationOnly(): Promise<boolean> {
 }
 
 export function hideSystemNotificationAndUnregister(reason: string): Promise<boolean> {
-  return OmikitPlugin.hideSystemNotificationAndUnregister(reason);
+  return OmikitPlugin.hideSystemNotificationAndUnregister({ reason });
 }
 
 export const OmiCallEvent = {
@@ -338,7 +356,7 @@ export function checkAndRequestPermissions(isVideo: boolean = false): Promise<bo
   if (Platform.OS !== 'android') {
     return Promise.resolve(true);
   }
-  return OmikitPlugin.checkAndRequestPermissions(isVideo);
+  return OmikitPlugin.checkAndRequestPermissions({ isVideo });
 }
 
 /**
@@ -362,6 +380,65 @@ export function requestPermissionsByCodes(codes: number[]): Promise<boolean> {
   if (Platform.OS !== 'android') {
     return Promise.resolve(true);
   }
-  return OmikitPlugin.requestPermissionsByCodes(codes);
+  return OmikitPlugin.requestPermissionsByCodes({ codes });
+}
+
+// MARK: - Getter Functions
+
+/**
+ * Retrieves user info by phone number.
+ * @param {string} phone - The phone number to look up.
+ * @returns {Promise<any>} User info object or null.
+ */
+export function getUserInfo(phone: string): Promise<any> {
+  return OmikitPlugin.getUserInfo({ phone });
+}
+
+/**
+ * Retrieves the project ID from OmiClient.
+ * @returns {Promise<string | null>} The project ID or null.
+ */
+export function getProjectId(): Promise<string | null> {
+  return OmikitPlugin.getProjectId();
+}
+
+/**
+ * Retrieves SIP connection info (user@realm).
+ * @returns {Promise<string | null>} SIP info string or null.
+ */
+export function getSipInfo(): Promise<string | null> {
+  return OmikitPlugin.getSipInfo();
+}
+
+/**
+ * Retrieves the app ID from OmiClient.
+ * @returns {Promise<string | null>} The app ID or null.
+ */
+export function getAppId(): Promise<string | null> {
+  return OmikitPlugin.getAppId();
+}
+
+/**
+ * Retrieves the device ID from OmiClient.
+ * @returns {Promise<string | null>} The device ID or null.
+ */
+export function getDeviceId(): Promise<string | null> {
+  return OmikitPlugin.getDeviceId();
+}
+
+/**
+ * Retrieves the FCM token from OmiClient.
+ * @returns {Promise<string | null>} The FCM token or null.
+ */
+export function getFcmToken(): Promise<string | null> {
+  return OmikitPlugin.getFcmToken();
+}
+
+/**
+ * Retrieves the VoIP token (iOS only, Android returns null).
+ * @returns {Promise<string | null>} The VoIP token or null.
+ */
+export function getVoipToken(): Promise<string | null> {
+  return OmikitPlugin.getVoipToken();
 }
 

package/src/types/index.d.ts

@@ -1,12 +1,30 @@
 declare module 'omikit-plugin' {
   import { NativeEventEmitter } from 'react-native';
 
+  // ============================================
+  // FUNCTIONS
+  // ============================================
+
   export function startServices(): Promise<any>;
   export function configPushNotification(data: any): Promise<any>;
   export function getInitialCall(): Promise<any>;
   export function initCallWithUserPassword(data: any): Promise<boolean>;
   export function initCallWithApiKey(data: any): Promise<boolean>;
-  export function startCall(data: any): Promise<boolean>;
+
+  /**
+   * Starts a new call
+   * @param data - Call configuration { phoneNumber: string, isVideo: boolean }
+   * @returns Promise with call result { status: OmiStartCallStatus, message?: string, _id?: string }
+   */
+  export function startCall(data: {
+    phoneNumber: string;
+    isVideo: boolean;
+  }): Promise<{
+    status: OmiStartCallStatus | number | string;
+    message?: string;
+    _id?: string;
+  }>;
+
   export function startCallWithUuid(data: any): Promise<boolean>;
   export function joinCall(): Promise<any>;
   export function endCall(): Promise<any>;
@@ -25,30 +43,112 @@ declare module 'omikit-plugin' {
   export function systemAlertWindow(): Promise<boolean>;
   export function openSystemAlertSetting(): Promise<void>;
   export function getAudio(): Promise<any>;
-  export function setAudio(data: any): Promise<void>;
+  export function setAudio(data: { portType: OmiAudioType | number }): Promise<void>;
   export function getCurrentAudio(): Promise<any>;
   export function transferCall(data: any): Promise<boolean>;
   export function rejectCall(): Promise<boolean>;
   export function dropCall(): Promise<boolean>;
-  export function testEventEmission(): Promise<boolean>;
   export function getKeepAliveStatus(): Promise<any>;
   export function triggerKeepAlivePing(): Promise<boolean>;
   export function checkPermissionStatus(): Promise<any>;
   export function checkAndRequestPermissions(isVideo?: boolean): Promise<boolean>;
   export function requestSystemAlertWindowPermission(): Promise<boolean>;
   export function requestPermissionsByCodes(codes: number[]): Promise<boolean>;
+  export function hideSystemNotificationSafely(): Promise<boolean>;
+  export function hideSystemNotificationOnly(): Promise<boolean>;
+  export function hideSystemNotificationAndUnregister(reason: string): Promise<boolean>;
+  export function checkCredentials(data: any): Promise<{
+    success: boolean;
+    statusCode?: number;
+    message?: string;
+  }>;
+  export function registerWithOptions(data: any): Promise<{
+    success: boolean;
+    statusCode?: number;
+    message?: string;
+  }>;
+
+  // User & Info
+  export function getUserInfo(phone: string): Promise<any>;
 
+  // Getter Functions
+  /** Get the current project ID */
+  export function getProjectId(): Promise<string | null>;
+  /** Get the current app ID */
+  export function getAppId(): Promise<string | null>;
+  /** Get the current device ID */
+  export function getDeviceId(): Promise<string | null>;
+  /** Get the FCM token (Android) or push token */
+  export function getFcmToken(): Promise<string | null>;
+  /** Get SIP registration info (format: user@realm) */
+  export function getSipInfo(): Promise<string | null>;
+  /** Get VoIP token (iOS only, returns null on Android) */
+  export function getVoipToken(): Promise<string | null>;
+
+  // ============================================
+  // ENUMS
+  // ============================================
+
+  /**
+   * Call state enum for tracking call lifecycle
+   */
   export enum OmiCallState {
-    unknown,
-    calling,
-    incoming,
-    early,
-    connecting,
-    confirmed,
-    disconnected,
-    hold,
+    unknown = 0,
+    calling = 1,
+    incoming = 2,
+    early = 3,
+    connecting = 4,
+    confirmed = 5,
+    disconnected = 6,
+    hold = 7,
   }
 
+  /**
+   * Status codes returned by startCall() function
+   * Use these to handle different call initiation results
+   */
+  export enum OmiStartCallStatus {
+    // Validation errors (0-3)
+    invalidUuid = 0,
+    invalidPhoneNumber = 1,
+    samePhoneNumber = 2,
+    maxRetry = 3,
+
+    // Permission errors (4, 450-452)
+    permissionDenied = 4,
+    permissionMicrophone = 450,
+    permissionCamera = 451,
+    permissionOverlay = 452,
+
+    // Call errors (5-7)
+    couldNotFindEndpoint = 5,
+    accountRegisterFailed = 6,
+    startCallFailed = 7,
+
+    // Success statuses (8, 407)
+    startCallSuccess = 8,
+    startCallSuccessIOS = 407,
+
+    // Other errors (9+)
+    haveAnotherCall = 9,
+    accountTurnOffNumberInternal = 10,
+    noNetwork = 11,
+  }
+
+  /**
+   * Audio output types for setAudio()
+   */
+  export enum OmiAudioType {
+    receiver = 0,
+    speaker = 1,
+    bluetooth = 2,
+    headphones = 3,
+  }
+
+  // ============================================
+  // CONSTANTS & EVENTS
+  // ============================================
+
   export const OmiCallEvent: {
     onCallStateChanged: string;
     onSpeaker: string;