@zelloptt/react-native-zello-sdk 0.4.0 → 1.0.0

package/README.md

@@ -8,11 +8,13 @@ This repository contains both the React Native Bridge, as well as an example app
 
 To see an example of the React Native SDK, check out [the example folder](https://github.com/zelloptt/react-native-zello-sdk/tree/master/example).
 
-The following instructions are for the SDK, not for the example app.
+The following instructions are for the installation of the SDK into your application - **not** for the example app.
 
 ## Prerequisites
 A React Native application and environment.
 
+A thorough understanding of Zello. The best place to get started is our [documentation](https://sdk.zello.com/).
+
 
 ## Installation
 
@@ -23,7 +25,9 @@ npm install @zelloptt/react-native-zello-sdk
 
 ### iOS
 
-Before getting started, please reference the iOS Installation Guide.
+Before getting started, please reference the [iOS Installation Guide](https://sdk.zello.com/installation-guides/ios-installation-guide).
+
+The main amendment to the guide is that there is no need to add the `ZelloSDK` as a pod directly to your project.
 
 #### Troubleshooting
 
@@ -40,11 +44,11 @@ If you receive the above error, you should move the `Build Phases` phase named `
 
 ### Android
 
-Before getting started, please reference the Android Installation Guide.
+Before getting started, please reference the [Android Installation Guide](https://sdk.zello.com/installation-guides/android-installation-guide).
 
 #### Dependencies
 
-Add the repositories to your app's `build.gradle`:
+You may or may not need to add the repositories to your app's `build.gradle`:
 
 ```
 repositories {
@@ -113,6 +117,7 @@ class MainApplication : Application(), ReactApplication {
 
       override fun onCreate() {
         super.onCreate()
+        // Don't forget to start the SDK!
         zello.start()
       }
 }

package/android/build.gradle

@@ -102,7 +102,7 @@ repositories {
 
 def kotlin_version = getExtOrDefault("kotlinVersion")
 
-def zelloSdkVersion = "0.4.0"
+def zelloSdkVersion = "1.0.0"
 
 dependencies {
   // For < 0.71, this will be from the local maven repo

package/android/src/main/java/com/zellosdk/ZelloAndroidSdkModule.kt

@@ -14,6 +14,7 @@ import com.facebook.react.modules.core.DeviceEventManagerModule
 import com.zello.sdk.Zello
 import com.zello.sdk.ZelloAccountStatus
 import com.zello.sdk.ZelloAlertMessage
+import com.zello.sdk.ZelloChannel
 import com.zello.sdk.ZelloConnectionError
 import com.zello.sdk.ZelloContact
 import com.zello.sdk.ZelloCredentials
@@ -28,6 +29,7 @@ import com.zello.sdk.ZelloOutgoingEmergency
 import com.zello.sdk.ZelloOutgoingVoiceMessage
 import com.zello.sdk.ZelloRecentEntry
 import com.zello.sdk.ZelloConsoleSettings
+import com.zello.sdk.ZelloGroupConversation
 import com.zello.sdk.ZelloState
 import com.zello.sdk.ZelloTextMessage
 import javax.inject.Inject
@@ -187,6 +189,31 @@ class ZelloAndroidSdkModule @Inject constructor(
     zello.endDispatchCall(call, dispatchChannel)
   }
 
+  @ReactMethod
+  fun createGroupConversation(usernames: ReadableArray, displayName: String?) {
+    val users = usernames.toArrayList().mapNotNull { zello.getUser(it as String) }
+    zello.createGroupConversation(users, displayName)
+  }
+
+  @ReactMethod
+  fun addUsersToGroupConversation(conversationName: String, usernames: ReadableArray) {
+    val conversation = zello.getGroupConversation(conversationName) ?: return
+    val users = usernames.toArrayList().mapNotNull { zello.getUser(it as String) }
+    zello.addUsersToGroupConversation(conversation, users)
+  }
+
+  @ReactMethod
+  fun leaveGroupConversation(conversationName: String) {
+    val conversation = zello.getGroupConversation(conversationName) ?: return
+    zello.leaveGroupConversation(conversation)
+  }
+
+  @ReactMethod
+  fun renameGroupConversation(conversationName: String, newName: String) {
+    val conversation = zello.getGroupConversation(conversationName) ?: return
+    zello.renameGroupConversation(conversation, newName)
+  }
+
   override fun onStateChanged(sdk: Zello, state: ZelloState) {
   }
 
@@ -205,7 +232,7 @@ class ZelloAndroidSdkModule @Inject constructor(
   }
 
   override fun onContactListUpdated(zello: Zello) {
-    val map = ZelloAndroidSdkModuleHelper.contactListToWritableMap(this.zello.users, this.zello.channels)
+    val map = ZelloAndroidSdkModuleHelper.contactListToWritableMap(this.zello.users, this.zello.channels, this.zello.groupConversations)
     this.zello.emergencyChannel?.let {
       map.putMap("emergencyChannel", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(it))
     }
@@ -239,7 +266,7 @@ class ZelloAndroidSdkModule @Inject constructor(
   override fun onIncomingAlertMessage(zello: Zello, message: ZelloAlertMessage) {
     sendEvent(reactApplicationContext, "onIncomingAlertMessage", Arguments.createMap().apply {
       putMap("contact", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(contact = message.contact))
-      putString("channelUserName", message.channelUser?.name)
+      putMap("channelUser", ZelloAndroidSdkModuleHelper.channelUserToWritableMap(message.channelUser))
       putString("timestamp", message.timestamp.toString())
       putString("text", message.text)
     })
@@ -264,7 +291,7 @@ class ZelloAndroidSdkModule @Inject constructor(
   override fun onIncomingImageMessage(message: ZelloImageMessage) {
     sendEvent(reactApplicationContext, "onIncomingImageMessage", Arguments.createMap().apply {
       putMap("contact", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(contact = message.contact))
-      putString("channelUserName", message.channelUser?.name)
+      putMap("channelUser", ZelloAndroidSdkModuleHelper.channelUserToWritableMap(message.channelUser))
       putString("timestamp", message.timestamp.toString())
       putString("thumbnail", ZelloAndroidSdkModuleHelper.bitmapToBase64String(message.thumbnail))
       putString("image", ZelloAndroidSdkModuleHelper.bitmapToBase64String(message.image))
@@ -274,7 +301,7 @@ class ZelloAndroidSdkModule @Inject constructor(
   override fun onIncomingLocationMessage(zello: Zello, message: ZelloLocationMessage) {
     sendEvent(reactApplicationContext, "onIncomingLocationMessage", Arguments.createMap().apply {
       putMap("contact", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(contact = message.contact))
-      putString("channelUserName", message.channelUser?.name)
+      putMap("channelUser", ZelloAndroidSdkModuleHelper.channelUserToWritableMap(message.channelUser))
       putString("timestamp", message.timestamp.toString())
       putString("address", message.address)
       putDouble("latitude", message.latitude)
@@ -324,7 +351,7 @@ class ZelloAndroidSdkModule @Inject constructor(
   override fun onIncomingTextMessage(message: ZelloTextMessage) {
     sendEvent(reactApplicationContext, "onIncomingTextMessage", Arguments.createMap().apply {
       putMap("contact", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(contact = message.contact))
-      putString("channelUserName", message.channelUser?.name)
+      putMap("channelUser", ZelloAndroidSdkModuleHelper.channelUserToWritableMap(message.channelUser))
       putString("timestamp", message.timestamp.toString())
       putString("text", message.text)
     })
@@ -333,7 +360,7 @@ class ZelloAndroidSdkModule @Inject constructor(
   override fun onIncomingVoiceMessageStarted(zello: Zello, message: ZelloIncomingVoiceMessage) {
     sendEvent(reactApplicationContext, "onIncomingVoiceMessageStarted", Arguments.createMap().apply {
       putMap("contact", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(contact = message.contact))
-      putString("channelUserName", message.channelUser?.name)
+      putMap("channelUser", ZelloAndroidSdkModuleHelper.channelUserToWritableMap(message.channelUser))
       putString("timestamp", message.timestamp.toString())
     })
   }
@@ -341,7 +368,7 @@ class ZelloAndroidSdkModule @Inject constructor(
   override fun onIncomingVoiceMessageStopped(zello: Zello, message: ZelloIncomingVoiceMessage) {
     sendEvent(reactApplicationContext, "onIncomingVoiceMessageStopped", Arguments.createMap().apply {
       putMap("contact", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(contact = message.contact))
-      putString("channelUserName", message.channelUser?.name)
+      putMap("channelUser", ZelloAndroidSdkModuleHelper.channelUserToWritableMap(message.channelUser))
       putString("timestamp", message.timestamp.toString())
     })
   }
@@ -474,6 +501,44 @@ class ZelloAndroidSdkModule @Inject constructor(
     })
   }
 
+  override fun onGroupConversationLeft(sdk: Zello, conversation: ZelloGroupConversation) {
+    sendEvent(reactApplicationContext, "onGroupConversationLeft", Arguments.createMap().apply {
+      putMap("conversation", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(conversation))
+    })
+  }
+
+  override fun onGroupConversationInvite(sdk: Zello, conversation: ZelloGroupConversation) {
+    sendEvent(reactApplicationContext, "onGroupConversationInvite", Arguments.createMap().apply {
+      putMap("conversation", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(conversation))
+    })
+  }
+
+  override fun onGroupConversationCreated(sdk: Zello, conversation: ZelloGroupConversation) {
+    sendEvent(reactApplicationContext, "onGroupConversationCreated", Arguments.createMap().apply {
+      putMap("conversation", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(conversation))
+    })
+  }
+
+  override fun onGroupConversationRenamed(sdk: Zello, conversation: ZelloGroupConversation) {
+    sendEvent(reactApplicationContext, "onGroupConversationRenamed", Arguments.createMap().apply {
+      putMap("conversation", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(conversation))
+    })
+  }
+
+  override fun onGroupConversationUsersAdded(sdk: Zello, conversation: ZelloGroupConversation, users: List<ZelloChannel.User>) {
+    sendEvent(reactApplicationContext, "onGroupConversationUsersAdded", Arguments.createMap().apply {
+      putMap("conversation", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(conversation))
+      putArray("users", ZelloAndroidSdkModuleHelper.channelUsersToWritableArray(users))
+    })
+  }
+
+  override fun onGroupConversationUsersLeft(sdk: Zello, conversation: ZelloGroupConversation, users: List<ZelloChannel.User>) {
+    sendEvent(reactApplicationContext, "onGroupConversationUsersLeft", Arguments.createMap().apply {
+      putMap("conversation", ZelloAndroidSdkModuleHelper.sdkContactToWritableMap(conversation))
+      putArray("users", ZelloAndroidSdkModuleHelper.channelUsersToWritableArray(users))
+    })
+  }
+
   private fun sendEvent(reactContext: ReactContext, name: String, params: WritableMap?) {
     reactContext
       .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)

package/android/src/main/java/com/zellosdk/ZelloAndroidSdkModuleHelper.kt

@@ -10,6 +10,7 @@ import com.zello.sdk.ZelloChannel
 import com.zello.sdk.ZelloConsoleSettings
 import com.zello.sdk.ZelloContact
 import com.zello.sdk.ZelloDispatchChannel
+import com.zello.sdk.ZelloGroupConversation
 import com.zello.sdk.ZelloHistoryAlertMessage
 import com.zello.sdk.ZelloHistoryImageMessage
 import com.zello.sdk.ZelloHistoryLocationMessage
@@ -22,7 +23,7 @@ import com.zello.sdk.ZelloUser
 import java.io.ByteArrayOutputStream
 
 object ZelloAndroidSdkModuleHelper {
-	fun contactListToWritableMap(users: List<ZelloUser>, channels: List<ZelloChannel>): WritableMap {
+	fun contactListToWritableMap(users: List<ZelloUser>, channels: List<ZelloChannel>, groupConversation: List<ZelloGroupConversation>): WritableMap {
 		return Arguments.createMap().apply {
 			putArray("users", WritableNativeArray().apply {
 				users.forEach { user ->
@@ -34,6 +35,11 @@ object ZelloAndroidSdkModuleHelper {
 					pushMap(sdkContactToWritableMap(channel))
 				}
 			})
+			putArray("groupConversations", WritableNativeArray().apply {
+				groupConversation.forEach { conversation ->
+					pushMap(sdkContactToWritableMap(conversation))
+				}
+			})
 		}
 	}
 
@@ -48,6 +54,9 @@ object ZelloAndroidSdkModuleHelper {
 				putString("customStatusText", contact.customStatusText)
 				putString("profilePictureUrl", contact.profilePictureUrl)
 				putString("profilePictureThumbnailUrl", contact.profilePictureThumbnailUrl)
+				putMap("supportedFeatures", WritableNativeMap().apply {
+					putBoolean("groupConversations", contact.supportedFeatures.groupConversations)
+				})
 			}
 
 			is ZelloChannel -> WritableNativeMap().apply {
@@ -71,6 +80,19 @@ object ZelloAndroidSdkModuleHelper {
 					contact.currentCall?.let { call ->
 						putMap("currentCall", callToWritableMap(call))
 					}
+				} else if (contact is ZelloGroupConversation) {
+					putBoolean("isGroupConversation", true)
+					putString("displayName", contact.displayName)
+					putArray("users", WritableNativeArray().apply {
+						contact.users.forEach { user ->
+							pushMap(channelUserToWritableMap(user))
+						}
+					})
+					putArray("onlineUsers", WritableNativeArray().apply {
+						contact.onlineUsers.forEach { user ->
+							pushMap(channelUserToWritableMap(user))
+						}
+					})
 				}
 			}
 
@@ -89,7 +111,7 @@ object ZelloAndroidSdkModuleHelper {
 	fun incomingEmergencyToWritableMap(incomingEmergency: ZelloIncomingEmergency): WritableMap {
 		return Arguments.createMap().apply {
 			putMap("channel", sdkContactToWritableMap(contact = incomingEmergency.channel))
-			putString("channelUserName", incomingEmergency.channelUser.name)
+			putMap("channelUser", channelUserToWritableMap(incomingEmergency.channelUser))
 			putString("emergencyId", incomingEmergency.emergencyId)
 			putString("startTimestamp", incomingEmergency.startTimestamp.toString())
 			incomingEmergency.endTimestamp?.let {
@@ -114,7 +136,7 @@ object ZelloAndroidSdkModuleHelper {
 			recents.forEach {
 				pushMap(WritableNativeMap().apply {
 					putMap("contact", sdkContactToWritableMap(it.contact))
-					putString("channelUserName", it.channelUser?.name)
+					putMap("channelUser", channelUserToWritableMap(it.channelUser))
 					putString("type", it.type.toString())
 					putString("timestamp", it.timestamp.toString())
 					putBoolean("incoming", it.incoming)
@@ -146,7 +168,7 @@ object ZelloAndroidSdkModuleHelper {
 		return Arguments.createMap().apply {
 			putMap("contact", sdkContactToWritableMap(contact = message.contact))
 			putString("type", "voice")
-			putString("channelUserName", message.channelUser?.name)
+			putMap("channelUser", channelUserToWritableMap(message.channelUser))
 			putString("timestamp", message.timestamp.toString())
 			putString("historyId", message.historyId)
 			putBoolean("incoming", message.incoming)
@@ -158,7 +180,7 @@ object ZelloAndroidSdkModuleHelper {
 		return Arguments.createMap().apply {
 			putMap("contact", sdkContactToWritableMap(contact = message.contact))
 			putString("type", "image")
-			putString("channelUserName", message.channelUser?.name)
+			putMap("channelUser", channelUserToWritableMap(message.channelUser))
 			putString("timestamp", message.timestamp.toString())
 			putString("historyId", message.historyId)
 			putBoolean("incoming", message.incoming)
@@ -169,7 +191,7 @@ object ZelloAndroidSdkModuleHelper {
 		return Arguments.createMap().apply {
 			putMap("contact", sdkContactToWritableMap(contact = message.contact))
 			putString("type", "text")
-			putString("channelUserName", message.channelUser?.name)
+			putMap("channelUser", channelUserToWritableMap(message.channelUser))
 			putString("timestamp", message.timestamp.toString())
 			putString("historyId", message.historyId)
 			putBoolean("incoming", message.incoming)
@@ -181,7 +203,7 @@ object ZelloAndroidSdkModuleHelper {
 		return Arguments.createMap().apply {
 			putMap("contact", sdkContactToWritableMap(contact = message.contact))
 			putString("type", "alert")
-			putString("channelUserName", message.channelUser?.name)
+			putMap("channelUser", channelUserToWritableMap(message.channelUser))
 			putString("timestamp", message.timestamp.toString())
 			putString("historyId", message.historyId)
 			putBoolean("incoming", message.incoming)
@@ -193,7 +215,7 @@ object ZelloAndroidSdkModuleHelper {
 		return Arguments.createMap().apply {
 			putMap("contact", sdkContactToWritableMap(contact = message.contact))
 			putString("type", "location")
-			putString("channelUserName", message.channelUser?.name)
+			putMap("channelUser", channelUserToWritableMap(message.channelUser))
 			putString("timestamp", message.timestamp.toString())
 			putString("historyId", message.historyId)
 			putBoolean("incoming", message.incoming)
@@ -207,6 +229,11 @@ object ZelloAndroidSdkModuleHelper {
 	fun consoleSettingsToWritableMap(settings: ZelloConsoleSettings): WritableMap {
 		return Arguments.createMap().apply {
 			putBoolean("allowNonDispatchersToEndCalls", settings.allowNonDispatchersToEndCalls)
+			putBoolean("allowTextMessages", settings.allowTextMessages)
+			putBoolean("allowImageMessages", settings.allowImageMessages)
+			putBoolean("allowLocationMessages", settings.allowLocationMessages)
+			putBoolean("allowAlertMessages", settings.allowAlertMessages)
+			putBoolean("allowGroupConversations", settings.allowGroupConversations)
 		}
 	}
 
@@ -218,4 +245,22 @@ object ZelloAndroidSdkModuleHelper {
 			putString("timestamp", call.timestamp.toString())
 		}
 	}
+
+	fun channelUserToWritableMap(channelUser: ZelloChannel.User?): WritableMap? {
+		if (channelUser == null) {
+			return null
+		}
+		return Arguments.createMap().apply {
+			putString("name", channelUser.name)
+			putString("displayName", channelUser.displayName)
+		}
+	}
+
+	fun channelUsersToWritableArray(channelUsers: List<ZelloChannel.User>): WritableNativeArray {
+		return WritableNativeArray().apply {
+			channelUsers.forEach {
+				pushMap(channelUserToWritableMap(it))
+			}
+		}
+	}
 }

package/ios/Extensions/ZelloConsoleSettings+Extension.swift

@@ -3,7 +3,12 @@ import ZelloSDK
 extension ZelloConsoleSettings {
   var jsonDictionary: [AnyHashable: Any] {
     return [
-      "allowNonDispatchersToEndCalls": allowsNonDispatchersToEndCalls
+      "allowNonDispatchersToEndCalls": allowsNonDispatchersToEndCalls,
+      "allowImageMessages": allowsImageMessages,
+      "allowLocationMessages": allowsLocationMessages,
+      "allowTextMessages": allowsTextMessages,
+      "allowAlertMessages": allowsAlertMessages,
+      "allowGroupConversations": allowsGroupConversations
     ]
   }
 }

package/ios/Extensions/ZelloContact+Extension.swift

@@ -52,6 +52,55 @@ extension ZelloUser {
     if let url = profilePictureThumbnailURL?.absoluteString {
       body["profilePictureThumbnailUrl"] = url
     }
+    body["supportedFeatures"] = [
+      "groupConversations": supportedFeatures.groupConversations
+    ]
+    return body
+  }
+}
+
+extension ZelloGroupConversation {
+  var jsonDictionary: [AnyHashable: Any] {
+    let body: [AnyHashable: Any] = [
+      "name": name,
+      "isChannel": true,
+      "isMuted": isMuted,
+      "isConnected": status == .connected,
+      "isConnecting": status == .connecting,
+      "usersOnline": onlineUsers.count,
+      "options": [
+        "noDisconnect": false,
+        "hidePowerButton": false,
+        "listenOnly": false,
+        "allowAlerts": true,
+        "allowTextMessages": true,
+        "allowLocations": true
+      ],
+      "isGroupConversation": true,
+      "displayName": displayName,
+      "users": users.map { user in user.jsonDictionary },
+      "onlineUsers": onlineUsers.map { user in user.jsonDictionary }
+    ]
+    return body
+  }
+}
+
+extension ZelloGroupConversationUser {
+  var jsonDictionary: [AnyHashable: Any] {
+    let body: [AnyHashable: Any] = [
+      "name": name,
+      "displayName": displayName
+    ]
+    return body
+  }
+}
+
+extension ZelloChannel.User {
+  var jsonDictionary: [AnyHashable: Any] {
+    let body: [AnyHashable: Any] = [
+      "name": name,
+      "displayName": displayName
+    ]
     return body
   }
 }

package/ios/Extensions/ZelloIOSSdkModule+Extension.swift

@@ -20,9 +20,14 @@ extension ZelloIOSSdkModule: Zello.Delegate {
   func zelloDidUpdateContactList(_ zello: Zello) {
     let users = zello.users.map { ZelloContact.user($0).jsonDictionary }
     let channels = zello.channels.map { ZelloContact.channel($0).jsonDictionary }
+    // TODO It's not clear the asZelloGroupConversation is necessary - without it, the ZelloContact.jsonDictionary impl is used
+    let groupConversations = zello.groupConversations.compactMap {
+      ZelloContact.conversation($0).asZelloGroupConversation()?.jsonDictionary
+    }
     var body: [AnyHashable: Any] = [
       "users": users,
-      "channels": channels
+      "channels": channels,
+      "groupConversations": groupConversations
     ]
     if let emergencyChannel = zello.emergencyChannel {
       body["emergencyChannel"] = emergencyChannel.jsonDictionary
@@ -80,7 +85,7 @@ extension ZelloIOSSdkModule: Zello.Delegate {
       "timestamp": incomingVoiceMessage.timestamp.bridgeTimestamp
     ]
     if let channelUser = incomingVoiceMessage.channelUser {
-      body["channelUserName"] = channelUser.name
+      body["channelUser"] = channelUser.jsonDictionary
     }
     sendSdkEvent(withName: "onIncomingVoiceMessageStarted", body: body)
   }
@@ -91,7 +96,7 @@ extension ZelloIOSSdkModule: Zello.Delegate {
       "timestamp": incomingVoiceMessage.timestamp.bridgeTimestamp
     ]
     if let channelUser = incomingVoiceMessage.channelUser {
-      body["channelUserName"] = channelUser.name
+      body["channelUser"] = channelUser.jsonDictionary
     }
     sendSdkEvent(withName: "onIncomingVoiceMessageStopped", body: body)
   }
@@ -103,7 +108,7 @@ extension ZelloIOSSdkModule: Zello.Delegate {
       "timestamp": textMessage.timestamp.bridgeTimestamp
     ]
     if let channelUser = textMessage.channelUser {
-      body["channelUserName"] = channelUser.name
+      body["channelUser"] = channelUser.jsonDictionary
     }
     sendSdkEvent(withName: "onIncomingTextMessage", body: body)
   }
@@ -133,7 +138,7 @@ extension ZelloIOSSdkModule: Zello.Delegate {
     ]
 
     if let channelUser = imageMessage.channelUser {
-      body["channelUserName"] = channelUser.name
+      body["channelUser"] = channelUser.jsonDictionary
     }
 
     body["image"] = imageMessage.image.base64String
@@ -171,7 +176,7 @@ extension ZelloIOSSdkModule: Zello.Delegate {
       "accuracy": locationMessage.location.horizontalAccuracy,
     ]
     if let channelUser = locationMessage.channelUser {
-      body["channelUserName"] = channelUser.name
+      body["channelUser"] = channelUser.jsonDictionary
     }
     if let address = locationMessage.address {
       body["address"] = address
@@ -186,7 +191,7 @@ extension ZelloIOSSdkModule: Zello.Delegate {
       "timestamp": alertMessage.timestamp.bridgeTimestamp
     ]
     if let channelUser = alertMessage.channelUser {
-      body["channelUserName"] = channelUser.name
+      body["channelUser"] = channelUser.jsonDictionary
     }
     sendSdkEvent(withName: "onIncomingAlertMessage", body: body)
   }
@@ -318,4 +323,36 @@ extension ZelloIOSSdkModule: Zello.Delegate {
   func zello(_ zello: Zello, didUpdate consoleSettings: ZelloConsoleSettings) {
     sendSdkEvent(withName: "onConsoleSettingsChanged", body: consoleSettings.jsonDictionary)
   }
+
+  func zello(_ zello: Zello, didJoin conversation: ZelloGroupConversation) {
+    sendSdkEvent(withName: "onGroupConversationInvite", body: ["conversation": conversation.jsonDictionary])
+  }
+
+  func zello(_ zello: Zello, didLeave conversation: ZelloGroupConversation) {
+    sendSdkEvent(withName: "onGroupConversationLeft", body: ["conversation": conversation.jsonDictionary])
+  }
+
+  func zello(_ zello: Zello, didCreate conversation: ZelloGroupConversation) {
+    sendSdkEvent(withName: "onGroupConversationCreated", body: ["conversation": conversation.jsonDictionary])
+  }
+
+  func zello(_ zello: Zello, didRename conversation: ZelloGroupConversation) {
+    sendSdkEvent(withName: "onGroupConversationRenamed", body: ["conversation": conversation.jsonDictionary])
+  }
+
+  func zello(_ zello: Zello, didAdd users: [ZelloGroupConversationUser], to conversation: ZelloGroupConversation) {
+    let body: [AnyHashable: Any] = [
+      "conversation": conversation.jsonDictionary,
+      "users": users.map { user in user.jsonDictionary }
+    ]
+    sendSdkEvent(withName: "onGroupConversationUsersAdded", body: body)
+  }
+
+  func zello(_ zello: Zello, didRemove users: [ZelloGroupConversationUser], from conversation: ZelloGroupConversation) {
+    let body: [AnyHashable: Any] = [
+      "conversation": conversation.jsonDictionary,
+      "users": users.map { user in user.jsonDictionary }
+    ]
+    sendSdkEvent(withName: "onGroupConversationUsersLeft", body: body)
+  }
 }

package/ios/ZelloIOSSdkModule.swift

@@ -108,14 +108,28 @@ import ZelloSDK
     guard let channel = zello.channel(named: name) else {
       return
     }
-    zello.connectChannel(channel: channel)
+    zello.connect(to: channel)
   }
 
   @objc func disconnectChannel(_ name: String) {
     guard let channel = zello.channel(named: name) else {
       return
     }
-    zello.disconnectChannel(channel: channel)
+    zello.disconnect(from: channel)
+  }
+
+  @objc func connectGroupConversation(_ name: String) {
+    guard let conversation = zello.conversation(named: name) else {
+      return
+    }
+    zello.connect(to: conversation)
+  }
+
+  @objc func disconnectGroupConversation(_ name: String) {
+    guard let conversation = zello.conversation(named: name) else {
+      return
+    }
+    zello.disconnect(from: conversation)
   }
 
   @objc func submitProblemReport() {
@@ -169,7 +183,7 @@ import ZelloSDK
   }
 
   @objc func playHistoryMessage(_ historyId: String, contactName: String, isChannel: Bool) {
-    guard 
+    guard
       let contact = isChannel ? zello.channel(named: contactName).map(ZelloContact.channel) : zello.user(named: contactName).map(ZelloContact.user),
       let message = zello.getHistoryMessage(historyId, contact: contact) as? ZelloHistoryVoiceMessage
     else {
@@ -196,7 +210,7 @@ import ZelloSDK
   }
 
   @objc func endDispatchCall(_ channelName: String) {
-    guard 
+    guard
       let dispatchChannel = zello.channel(named: channelName),
       let call = dispatchChannel.dispatchInfo?.currentCall
     else {
@@ -204,6 +218,33 @@ import ZelloSDK
     }
     zello.end(call, on: dispatchChannel)
   }
+
+  @objc func createGroupConversation(_ usernames: [Any], displayName: String?) {
+    let users = usernames.compactMap { username in zello.user(named: username as? String ?? "") }
+    zello.createGroupConversation(users: users, displayName: displayName)
+  }
+
+  @objc func addUsersToGroupConversation(_ conversationName: String, usernames: [Any]) {
+    guard let conversation = zello.conversation(named: conversationName) else {
+      return
+    }
+    let users = usernames.compactMap { username in zello.user(named: username as? String ?? "") }
+    zello.add(users, to: conversation)
+  }
+
+  @objc func leaveGroupConversation(_ conversationName: String) {
+    guard let conversation = zello.conversation(named: conversationName) else {
+      return
+    }
+    zello.leave(conversation)
+  }
+
+  @objc func renameGroupConversation(_ conversationName: String, newName: String) {
+    guard let conversation = zello.conversation(named: conversationName) else {
+      return
+    }
+    zello.rename(conversation, to: newName)
+  }
 }
 
 extension ZelloIOSSdkModule {

package/ios/ZelloIOSSdkModuleBridge.m

@@ -25,6 +25,9 @@ RCT_EXTERN_METHOD(sendAlert:(NSString *)name isChannel:(BOOL)isChannel text:(NSS
 RCT_EXTERN_METHOD(connectChannel:(NSString *)name)
 RCT_EXTERN_METHOD(disconnectChannel:(NSString *)name)
 
+RCT_EXTERN_METHOD(connectGroupConversation:(NSString *)name)
+RCT_EXTERN_METHOD(disconnectGroupConversation:(NSString *)name)
+
 RCT_EXTERN_METHOD(submitProblemReport)
 
 RCT_EXTERN_METHOD(muteContact:(NSString *)name isChannel:(BOOL)isChannel)
@@ -43,4 +46,12 @@ RCT_EXTERN_METHOD(getHistoryImageData:(NSString *)historyId contactName:(NSStrin
 
 RCT_EXTERN_METHOD(endDispatchCall:(NSString *)channelName)
 
+RCT_EXTERN_METHOD(createGroupConversation:(NSArray *)usernames displayName:(NSString *)displayName)
+
+RCT_EXTERN_METHOD(addUsersToGroupConversation:(NSString *)conversationName usernames:(NSArray *)usernames)
+
+RCT_EXTERN_METHOD(leaveGroupConversation:(NSString *)conversationName)
+
+RCT_EXTERN_METHOD(renameGroupConversation:(NSString *)conversationName newName:(NSString *)newName)
+
 @end

package/lib/commonjs/docs/assets/navigation.js

@@ -1,4 +1,4 @@
 "use strict";
 
-window.navigationData = "data:application/octet-stream;base64,H4sIAAAAAAAAE52ZX2vbMBTFv4v3GrY2y9iat5EFVugorN0eVvJg7FvHxJaCrZSEke8+7PyxJV1JR3t1z/kd5cqSddWXv4mivUrmCb2RUG0ySbapWifzpJb5rqL2w+n5+7Wqq2SSbEqRJ/PpJMnWZZU3JJL5yxXxh6pKLjv9gCGxq6+QQaDzvhxXx8kVU4qc9vZA+sfQOHJ6TXeV8iHeDZoTanZ7N/t4MxsNox/s1yyTO6GeVKp2THFGQFbuZ1fUqB/UtmlBAFpXe8mLdSoEVWHoIER4/RAe6C2CrFmQjIUUgjJVSoHW3G1E8h63nQWPGfQI/VdLDYw+i/1cKV7LAkBedCHauWbLppHISC0DyO/mBHjJbUOI38qKnkipUhTIJFqGEF+lmX8jMYQI7/mwxWoxEvu5DeUkVJlWSA00sZf7rWy3qcrWi7QClryhhsnoQmc9WAq6H9oGL9/41rmoF5mX9b1slWwOcR8F3oTk3NdpQbE5hgnJeZBZ2q3n2Cjbh6TFpsTRn2kfPTW6B0n5LcssemYMkzcnbupj5vxeZLIuRbGsqSlIZAcAz1igjLgyOVzepOhXN/Kdhbkg73GnChlXfc4CZcRV3+GKTgJPKT5rdCZ4cvFZvZk/KSOhlkI1wHzpYpSLnTdsg5cftRlG7ILYkRk5K3ca9GyhaXXquDVt843NavMN3h4P9qxK2/Zs7/+kQ26nelesDltifkj/GI939LOnLv3EsnVms453hxbX0mJsd1foSjAdoRxXJ2TzdSXMNfYRD7dXhrl2J8ExL6oAz3cet7C2OEAH9nIrxOn5j6xQ7Z2eQJZzj7USDGWAy+1cFnIQBWh8S3HZfsaLfiS0N6PQHRMDPGtQlr71u3mdLsx03Q1wXF0bZPN9MQMeC3EqUFlDG2R7u0uGz+jRDL69cGeM9WiG82jujjEsaBJ7zHGnjORoAn+UdkeM9cEMeDKiZsHT53FoUw3z4dJwhmBKzEsU+/Z4ejGGbqlhPlwhzhBMYXsTBj7SBZnogopZScEPB/bFcPxHoOcwn6Gz0Dh839x9vv00Dd3b28xegLL0W2kO1ikwGnd3bBMHFUR13cdZYF0IscNQL211XP0DN2XGj/YcAAA=";
+window.navigationData = "data:application/octet-stream;base64,H4sIAAAAAAAAE52ZX2/TMBTFv0t4rWAbQ7C+oVJg0tAkNnhg2oOV3KXRUjtynGkV2ndHSdsljq/tY17bc37HseM/17n7mxl6NtkyoyeSps0WWSPMJltmW1V0NbXv9r+/3ZhtnS2yx0oW2fJskeWbqi40yWx594r4Q3Wt1r1+xJDstq+QUWDzPr3cvyxeMZUs6NltyPAz1I6CHkRXmxDizajZo85PL87fn5xPmjE09nOeq06aGyNMx3TOBMjKw+yatPlBbStKAtC2OkhebYSUVMehoxDhDU24oqcEsmVBMlZKSspNpSTa534jknfd9BY8ZtQj9F8taRh9EIe5Sj5UJYA86mK0Q5+ttVZISx0DyO/HBHjJXUOM36qabsiYSpbIIDqGGN+IPLyQzIQI73bXYH0xEYe5mgqSphI10geWOMj9UrWNMPlmJWpgys/UMBmd6KwHS0HXQ9cQ5M/2Oh/1KAuyvmnVNSsln0i3op8BcS5nCWZ8r1qj9C5t4+FNSM7lVpSUmjMzITlXKh8ePzXK9SFpqSlp9Ft6Th4a24Ok/FZVnjwyM1MwJ23oU8b8UuZqW8lyvSVdksx3AJ6xQBlp3eRxBZOSX93EdxbmgrzrzpQqrfc5C5SR1vseV3ISeBIKWZMzwdNRyBrM/Ek5SbOWRgPjZYtRLnamcQ1BftJimLAKYsdy5Dzea9Dzi6WNU7umUdpQ8ZWE6TShAYzNzpqW2m3x6GLb4hEv90d7Xou2PdiHv2zI6Zld5Ztdwz3T8DMe76nP97cOe5arm18+4NWuw3W0GNtf5foS5o5Yjq+yc/m2EubO1qwAd1DGuW5lxDGPqggvVF84WFccoQP7hhPi9fxHVqzvvZ5Ilnc9dxJmygiXWyUd5CiK0Pjy5bj8TCf9ROguRrE7MwZ40KAse5vx83pdlMnX4gx0KsSpwNPPtFF2oKJl6I46yg9Ws0wCo0cz+HLGnzHVoxneUsAfM7OgSeyxyp8ykaMJ/NHdHzHVRzPgwUgahUBdyaHnapgPdw1niKakvESpb0+g9mPojhrmwz3EGaIpbC3EwCe6KBOdUCkzKbp5QLtGpJLwYB0HuuM5X1MGMLPlHYSzg/7JxcfTD2exbx4ucxCgLP6LAQedKlG6/b2Ao/YKjMbd6rvEUQVRfbeYDtgWQuw4NEi7f7n/BzfZ2mCQHgAA";
 //# sourceMappingURL=navigation.js.map

package/lib/commonjs/docs/assets/navigation.js.map

@@ -1 +1 @@
-{"version":3,"names":["window","navigationData"],"sourceRoot":"../../../../src","sources":["docs/assets/navigation.js"],"mappings":";;AAAAA,MAAM,CAACC,cAAc,GAAG,uoCAAuoC","ignoreList":[]}
+{"version":3,"names":["window","navigationData"],"sourceRoot":"../../../../src","sources":["docs/assets/navigation.js"],"mappings":";;AAAAA,MAAM,CAACC,cAAc,GAAG,usCAAusC","ignoreList":[]}