omikit-plugin 3.3.29 → 4.0.2

package/src/omi_local_camera.tsx

@@ -1,11 +1,25 @@
 import type { HostComponent } from 'react-native';
 import { NativeModules, requireNativeComponent, ViewProps } from 'react-native';
 
-const FLLocalCamera = NativeModules.FLLocalCameraView;
+// Safe lazy loading — requireNativeComponent can throw in bridgeless mode
+// if the native view is not registered for Fabric
+let _localCameraView: HostComponent<ViewProps> | null = null;
+const getLocalCameraView = (): HostComponent<ViewProps> => {
+  if (!_localCameraView) {
+    _localCameraView = requireNativeComponent('FLLocalCameraView');
+  }
+  return _localCameraView;
+};
 
-export const OmiLocalCameraView: HostComponent<ViewProps> =
-  requireNativeComponent('FLLocalCameraView');
+export const OmiLocalCameraView = new Proxy({} as HostComponent<ViewProps>, {
+  get(_target, prop) {
+    return (getLocalCameraView() as any)[prop];
+  },
+});
 
+// Module name separated from ViewManager name to avoid name collision
+const FLLocalCamera = NativeModules.FLLocalCameraModule || NativeModules.FLLocalCameraView;
 export function refreshLocalCamera(): Promise<boolean> {
+  if (!FLLocalCamera) return Promise.resolve(false);
   return FLLocalCamera.refresh();
 }

package/src/omi_remote_camera.tsx

@@ -1,11 +1,25 @@
 import type { HostComponent } from 'react-native';
 import { NativeModules, requireNativeComponent, ViewProps } from 'react-native';
 
-const FLRemoteCamera = NativeModules.FLRemoteCameraView;
+// Safe lazy loading — requireNativeComponent can throw in bridgeless mode
+// if the native view is not registered for Fabric
+let _remoteCameraView: HostComponent<ViewProps> | null = null;
+const getRemoteCameraView = (): HostComponent<ViewProps> => {
+  if (!_remoteCameraView) {
+    _remoteCameraView = requireNativeComponent('FLRemoteCameraView');
+  }
+  return _remoteCameraView;
+};
 
-export const OmiRemoteCameraView: HostComponent<ViewProps> =
-  requireNativeComponent('FLRemoteCameraView');
+export const OmiRemoteCameraView = new Proxy({} as HostComponent<ViewProps>, {
+  get(_target, prop) {
+    return (getRemoteCameraView() as any)[prop];
+  },
+});
 
+// 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,22 +7,52 @@ 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(
-    {},
-    {
-      get() {
-        throw new Error(LINKING_ERROR);
-      },
-    }
-  );
+// Resolve native module: TurboModule (New Arch) → NativeModules (Old Arch) → null
+const resolvedModule: Spec | null = (() => {
+  try {
+    // Try TurboModule first (New Architecture / bridgeless mode)
+    const turboModule = TurboModuleRegistry.get<Spec>('OmikitPlugin');
+    if (turboModule) return turboModule;
+  } catch (_) {}
+
+  // Fallback to NativeModules (Old Architecture / bridge mode)
+  if (NativeModules.OmikitPlugin) {
+    return NativeModules.OmikitPlugin;
+  }
 
-// ✅ Setup omiEmitter cho iOS và Android
-const omiEmitter = Platform.OS === 'ios'
-  ? new NativeEventEmitter(OmikitPlugin)
-  : DeviceEventEmitter;
+  return null;
+})();
+
+// Wrap in Proxy that throws LINKING_ERROR only when SDK methods are actually called
+const OmikitPlugin: Spec = resolvedModule || new Proxy(
+  {} as Spec,
+  {
+    get(_target, prop) {
+      if (prop === 'addListener' || prop === 'removeListeners') {
+        return () => {};
+      }
+      throw new Error(LINKING_ERROR);
+    },
+  }
+);
+
+// Setup omiEmitter — safe for Old Arch, New Arch, and bridgeless mode
+const omiEmitter = (() => {
+  if (Platform.OS !== 'ios') {
+    return DeviceEventEmitter;
+  }
+  try {
+    // Best case: NativeEventEmitter with resolved native module
+    if (resolvedModule) {
+      return new NativeEventEmitter(resolvedModule as any);
+    }
+    // New Arch without interop: NativeEventEmitter without module arg (RN 0.74+)
+    return new NativeEventEmitter();
+  } catch (_) {
+    // Last resort fallback
+    return DeviceEventEmitter;
+  }
+})();
 
 /**
  * Starts the Omikit services.
@@ -41,14 +72,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 +104,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 +137,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 +153,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 +313,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 +369,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 +393,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;