@capgo/capacitor-twilio-voice 7.7.6 → 7.7.8

package/README.md

@@ -312,6 +312,54 @@ Keep in mind, this will make it so that you app can be accessed when the screen
  - [iOS Setup](https://www.twilio.com/docs/voice/sdks/ios/get-started)
  - [Android Setup](https://www.twilio.com/docs/voice/sdks/android/get-started)
 
+## Caller Name Display (CapacitorTwilioCallerName)
+
+By default, incoming calls display the caller's phone number or client ID. You can customize this by passing a `CapacitorTwilioCallerName` parameter from your TwiML backend to display a friendly name instead.
+
+### Backend Setup
+
+When generating your TwiML response for the `<Client>` dial, add the `CapacitorTwilioCallerName` parameter:
+
+```java
+// Java example (see exemple-backend for full implementation)
+Parameter callerNameParam = new Parameter.Builder()
+    .name("CapacitorTwilioCallerName")
+    .value("John Doe")
+    .build();
+
+Client client = new Client.Builder(identity)
+    .parameter(callerNameParam)
+    .build();
+
+Dial dial = new Dial.Builder()
+    .client(client)
+    .build();
+```
+
+```javascript
+// Node.js example
+const VoiceResponse = require('twilio').twiml.VoiceResponse;
+
+const response = new VoiceResponse();
+const dial = response.dial();
+dial.client({
+  name: 'CapacitorTwilioCallerName',
+  value: 'John Doe'
+}, identity);
+```
+
+### How It Works
+
+1. When your backend receives an incoming call, it generates TwiML to route the call
+2. Include the `CapacitorTwilioCallerName` parameter with the caller's display name
+3. The plugin automatically extracts this parameter and uses it for:
+   - iOS CallKit incoming call screen
+   - Android incoming call notification
+   - The `from` field in `callInviteReceived` events
+   - The `pendingInvites` array in `getCallStatus()`
+
+If `CapacitorTwilioCallerName` is not provided, the plugin falls back to the caller's phone number or client ID.
+
 ## Usage
 
 ### Authentication

package/android/src/main/java/ee/forgr/capacitor_twilio_voice/CapacitorTwilioVoicePlugin.java

@@ -75,7 +75,7 @@ import org.json.JSONObject;
 )
 public class CapacitorTwilioVoicePlugin extends Plugin {
 
-    private final String pluginVersion = "7.7.6";
+    private final String pluginVersion = "7.7.8";
 
     private static final String TAG = "CapacitorTwilioVoice";
     private static final String PREF_ACCESS_TOKEN = "twilio_access_token";

package/ios/Sources/CapacitorTwilioVoicePlugin/CapacitorTwilioVoicePlugin.swift

@@ -27,7 +27,7 @@ public protocol PushKitEventDelegate: AnyObject {
  */
 @objc(CapacitorTwilioVoicePlugin)
 public class CapacitorTwilioVoicePlugin: CAPPlugin, CAPBridgedPlugin, PushKitEventDelegate {
-    private let pluginVersion: String = "7.7.6"
+    private let pluginVersion: String = "7.7.8"
 
     public let identifier = "CapacitorTwilioVoicePlugin"
     public let jsName = "CapacitorTwilioVoice"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-twilio-voice",
-  "version": "7.7.6",
+  "version": "7.7.8",
   "description": "Integrates the Twilio Voice SDK into Capacitor",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",