rns-nativecall 1.3.1 → 1.3.2

package/README.md

@@ -1,11 +1,17 @@
 # rns-nativecall
 
-A professional VoIP incoming call handler for React Native. Features a "Single Call Gate" on Android to manage busy states and full CallKit integration for iOS.
+A **professional VoIP incoming call handler for React Native** with full **Android & iOS native UI integration**.  
+Designed for production-grade apps requiring **CallKit**, **lockscreen handling**, **headless execution**, and **single-call enforcement**.
+
+---
 
 ## 🚀 Highlights
-- **Expo Support**: Built-in config plugin handles all native setup.
-- **Single Call Gate**: Automatically detects if the user is in a call and flags secondary calls as "BUSY".
-- **Headless Mode**: Works even when the app is killed or the screen is locked.
+
+- 📦 **Expo Ready** – Zero manual native setup via config plugin  
+- ☎️ **Single Call Gate** – Automatically blocks concurrent calls and emits `BUSY` events  
+- 🧠 **Headless Mode** – Works when the app is killed, backgrounded, or screen locked  
+- 📱 **Native UI** – Full-screen Android Activity & iOS CallKit  
+- 🔔 **System-Level Reliability** – No JS race conditions, no ghost calls  
 
 ---
 
@@ -13,15 +19,20 @@ A professional VoIP incoming call handler for React Native. Features a "Single C
 
 ```bash
 npx expo install rns-nativecall expo-build-properties react-native-uuid
-
 ```
+
 or
+
 ```bash
 npm install rns-nativecall expo-build-properties react-native-uuid
-
 ```
---- 
-Add the plugin to your app.json or app.config.js:
+
+---
+
+## ⚙️ Expo Configuration
+
+Add the plugin to **app.json** or **app.config.js**:
+
 ```json
 {
   "expo": {
@@ -54,11 +65,15 @@ Add the plugin to your app.json or app.config.js:
   }
 }
 ```
+
 ---
-### 🛠 Usage
 
-1. Initialize Headless Task (index.js)
-Register the task at the very top of your entry file. This handles background calls and "Busy" signals for secondary callers.
+## 🛠 Usage
+
+### 1️⃣ Register Headless Task (index.js)
+
+This enables background handling, busy-state signaling, and cold-start execution.
+
 ```javascript
 import { AppRegistry } from 'react-native';
 import App from './App';
@@ -66,51 +81,41 @@ import { CallHandler } from 'rns-nativecall';
 
 CallHandler.registerHeadlessTask(async (data, eventType) => {
     if (eventType === 'BUSY') {
-        // User is already on a call. Notify the second caller via WebSocket/API.
-        console.log("System Busy for UUID:", data.callUuid);
+        console.log("User already in call:", data.callUuid);
         return;
     }
 
     if (eventType === 'INCOMING_CALL') {
-        // App is waking up for a new call. 
-        // Trigger your custom UI or logic here.
+        console.log("Incoming call payload:", data);
     }
 });
 
 AppRegistry.registerComponent('main', () => App);
 ```
-## Handling Events (Index.js)
+
+---
+
+## 🎧 Foreground Event Handling (index.js)
 
 ```javascript
-// Index.js Setup Foreground Listeners
 CallHandler.subscribe(
-
     async (data) => {
-        try {
-            console.log("APP IS OPEN", data)
-           // navigate here
-        } catch (error) {
-            console.log("pending_call_uuid", error)
-        }
+        console.log("CALL ACCEPTED", data);
     },
-
     async (data) => {
-        try {
-            console.log("CALL DECLINE", data)
-           // update the caller here call decline
-        } catch (error) {
-            console.log("Onreject/ cancel call error", error)
-        }
+        console.log("CALL REJECTED", data);
     },
-
-    (data) => { console.log("failded", data) }
+    (data) => {
+        console.log("CALL FAILED", data);
+    }
 );
-
 ```
-## Handling Events (App.js)
 
-```javascript
+---
 
+## 🎬 App-Level Integration (App.js)
+
+```javascript
 import React, { useEffect } from 'react';
 import { CallHandler } from 'rns-nativecall';
 
@@ -119,18 +124,15 @@ export default function App() {
     const unsubscribe = CallHandler.subscribe(
       (data) => {
         console.log("Call Accepted:", data.callUuid);
-        // Navigate to your call screen
       },
       (data) => {
         console.log("Call Rejected:", data.callUuid);
-        // Send 'Hangup' signal to your server
       }
     );
 
     return () => unsubscribe();
   }, []);
 
-  // To manually trigger the UI (e.g., from an FCM data message)
   const showCall = () => {
     CallHandler.displayCall("unique-uuid", "Caller Name", "video");
   };
@@ -138,51 +140,62 @@ export default function App() {
   return <YourUI />;
 }
 ```
+
 ---
-## 📖 rns-nativecall API Reference
 
+## 📖 API Reference
 
 ### Core Methods
+
 | Method | Platform | Description |
-| :--- | :--- | :--- |
-| **registerHeadlessTask(callback)** | All | Registers the background task. `eventType` is 'INCOMING_CALL', 'BUSY', or 'ABORTED_CALL'. |
-| **displayCall(uuid, name, type)** | All | Launches full-screen Activity (Android) or reports to CallKit (iOS). |
-| **destroyNativeCallUI(uuid)** | All | Stops ringtone/Activity (Android) or ends CallKit session (iOS). |
-| **subscribe(onAccept, onReject, onFailed)** | All | Listens for Answer/Decline actions and system-level bridge errors. |
-| **showMissedCall(uuid, name, type)** | Android | Posts a persistent notification in the device tray for missed calls. |
-| **showOnGoingCall(uuid, name, type)** | Android | Show a persistent notification in the device tray for on going calls. |
-
-### Data & State Management
+|------|---------|-------------|
+| `registerHeadlessTask(cb)` | All | Registers background task (`INCOMING_CALL`, `BUSY`, `ABORTED_CALL`) |
+| `displayCall(uuid, name, type)` | All | Shows native incoming call UI |
+| `destroyNativeCallUI(uuid)` | All | Ends native UI / CallKit session |
+| `subscribe(onAccept, onReject, onFail)` | All | Listen to call actions |
+| `showMissedCall(uuid, name, type)` | Android | Persistent missed call notification |
+| `showOnGoingCall(uuid, name, type)` | Android | Persistent ongoing call notification |
+
+---
+
+### Data & State
+
 | Method | Platform | Description |
-| :--- | :--- | :--- |
-| **getInitialCallData()** | All | Retrieves the call payload if the app was cold-started via a notification. |
-| **checkCallValidity(uuid)** | All | Returns `{isValid, isCanceled}` to prevent ghost or aborted calls. |
-| **checkCallStatus(uuid)** | All | Returns `{isCanceled, isActive, shouldDisplay}` for UI syncing. |
+|------|---------|-------------|
+| `getInitialCallData()` | All | Retrieve payload from cold start |
+| `checkCallValidity(uuid)` | All | Prevent ghost calls |
+| `checkCallStatus(uuid)` | All | Sync UI with native state |
+
+---
 
 ### Android Permissions
-| Method | Platform | Description |
-| :--- | :--- | :--- |
-| **checkOverlayPermission()** | Android | Returns `true` if app can draw over other apps (Heads-up UI). |
-| **checkFullScreenPermission()** | Android | (Android 14+) Checks if app can trigger full-screen intents. |
-| **requestOverlayPermission()** | Android | Navigates user to "Draw over other apps" system settings. |
-| **requestFullScreenSettings()** | Android | (Android 14+) Navigates user to "Full Screen Intent" settings. |
+
+| Method | Description |
+|------|-------------|
+| `checkOverlayPermission()` | Check lockscreen overlay permission |
+| `requestOverlayPermission()` | Open overlay settings |
+| `checkFullScreenPermission()` | Android 14+ full screen intent |
+| `requestFullScreenSettings()` | Android 14+ permission screen |
 
 ---
 
-# Implementation Notes
+## 🧠 Implementation Notes
 
-1. Android Overlay:
-For your React Native call screen to show up when the phone is locked, the user must grant the "Overlay Permission". Use 'checkOverlayPermission()' and 'requestOverlayPermission()' during your app's onboarding or call initiation.
+### Android Overlay
+Overlay permission is required to display calls on the lockscreen.  
+Request during onboarding or before first call.
 
-2. iOS CallKit:
-On iOS, 'displayCall' uses the native system CallKit UI. This works automatically in the background and on the lockscreen without extra overlay permissions.
+### iOS CallKit
+Uses system CallKit UI. Works automatically in background and lockscreen.
+
+### Single Call Gate
+If a call is active, all subsequent calls emit `BUSY` via headless task.
 
-3. Single Call Gate:
-The library automatically prevents multiple overlapping native UIs. If a call is already active, subsequent calls will trigger the 'BUSY' event in your Headless Task.
 ---
 
-## FULL Example Use Case
-```javascript
+## 🧪 Full Example
+
+```js
 import React, { useEffect, useState } from 'react';
 import { StyleSheet, Text, View, TouchableOpacity, Alert } from 'react-native';
 import { CallHandler } from 'rns-nativecall';
@@ -275,5 +288,13 @@ const styles = StyleSheet.create({
   btnText: { color: 'white', fontWeight: 'bold' }
 });
 ```
+
+---
+
 ## 🛡 License
+
+MIT License
+
 ---
+
+Built for **production VoIP apps**, not demos.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "rns-nativecall",
-    "version": "1.3.1",
+    "version": "1.3.2",
     "description": "High-performance React Native module for handling native VoIP call UI on Android and iOS.",
     "main": "index.js",
     "types": "index.d.ts",
@@ -20,7 +20,8 @@
         "url": "git+https://github.com/raiidr/rns-nativecall.git"
     },
     "scripts": {
-        "p": "npm publish --access public"
+        "p": "npm publish --access public",
+        "i": "npm publish --access public"
     },
     "keywords": [
         "react-native",

package/withNativeCallVoip.js

@@ -107,6 +107,7 @@ function withAndroidConfig(config) {
             'android.permission.POST_NOTIFICATIONS',
             'android.permission.WAKE_LOCK',
             'android.permission.DISABLE_KEYGUARD',
+            'android.permission.MANAGE_OWN_CALLS',
         ];
 
         manifest.manifest['uses-permission'] = manifest.manifest['uses-permission'] || [];