@100mslive/react-native-hms 1.5.0 → 1.6.0

package/ios/HMSRNSDK.swift

@@ -25,6 +25,8 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
     private var previewInProgress = false
     private var networkQualityUpdatesAttached = false
     private var eventsEnableStatus: [String: Bool] = [:]
+    private var sessionStore: HMSSessionStore?
+    private var sessionStoreChangeObservers = [String: NSObjectProtocol]()
 
     // MARK: - Setup
     init(data: NSDictionary?, delegate manager: HMSManager?, uid id: String) {
@@ -49,7 +51,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
 
         guard !previewInProgress else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 5000, "description": "Preview is in progress", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 5000, "description": "Preview is in progress", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
             }
             return
         }
@@ -101,7 +103,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
 
                 let decodedTracks = HMSDecoder.getAllTracks(tracks ?? [])
 
-                resolve?(["success": true, "tracks": decodedTracks])
+                resolve?(["success": true, "tracks": decodedTracks] as [String: Any])
                 return
             })
         }
@@ -115,7 +117,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
 
         guard !previewInProgress else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 5000, "description": "Preview is in progress", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 5000, "description": "Preview is in progress", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
             }
             return
         }
@@ -222,26 +224,28 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             reject?("Still in reconnecting stage", "Still in reconnecting stage", nil)
         } else {
             DispatchQueue.main.async { [weak self] in
-                guard let strongSelf = self else { return }
-                self?.config = nil
-                self?.recentRoleChangeRequest = nil
-                self?.systemBroadcastPicker = nil
-                self?.preferredExtension = nil
-                self?.stopScreenshareResolve = nil
-                self?.startScreenshareResolve = nil
-                self?.isScreenShared = false
-                self?.networkQualityUpdatesAttached = false
-                self?.hms?.leave({ success, error in
+                guard let strongSelf = self else {
+                    print(#function, "Could not find reference to self while executing Room leave")
+                    return
+                }
+
+                strongSelf.hms?.leave { [weak self] success, error in
+
+                    guard let strongSelf = self else {
+                        print(#function, "Could not find reference to self when callback is received while executing Room leave")
+                        return
+                    }
+
                     if success {
-                        HMSDecoder.clearRestrictDataStates()
                         resolve?(["success": success])
+                        strongSelf.cleanup() // resetting states and doing data cleanup
                     } else {
                         if strongSelf.eventsEnableStatus[HMSConstants.ON_ERROR] == true {
                             strongSelf.delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": HMSDecoder.getError(error), "id": strongSelf.id])
                         }
                         reject?("error in leave", "error in leave", nil)
                     }
-                })
+                }
             }
         }
     }
@@ -260,7 +264,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         DispatchQueue.main.async { [weak self] in
             self?.hms?.sendBroadcastMessage(type: type, message: message, completion: { message, error in
                 if error == nil {
-                    resolve?(["success": true, "data": ["sender": message?.sender?.name ?? "", "message": message?.message ?? "", "type": message?.type]])
+                    resolve?(["success": true, "data": ["sender": message?.sender?.name ?? "", "message": message?.message ?? "", "type": message?.type]] as [String: Any])
                     return
                 } else {
                     if self?.eventsEnableStatus[HMSConstants.ON_ERROR] == true {
@@ -288,7 +292,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             let encodedTargetedRoles = HMSHelper.getRolesFromRoleNames(targetedRoles, roles: self?.hms?.roles)
             self?.hms?.sendGroupMessage(type: type, message: message, roles: encodedTargetedRoles, completion: { message, error in
                 if error == nil {
-                    resolve?(["success": true, "data": ["sender": message?.sender?.name ?? "", "message": message?.message ?? "", "type": message?.type]])
+                    resolve?(["success": true, "data": ["sender": message?.sender?.name ?? "", "message": message?.message ?? "", "type": message?.type]] as [String: Any])
                     return
                 } else {
                     if self?.eventsEnableStatus[HMSConstants.ON_ERROR] == true {
@@ -316,7 +320,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             guard let peer = HMSHelper.getRemotePeerFromPeerId(peerId, remotePeers: self?.hms?.remotePeers) else { return }
             self?.hms?.sendDirectMessage(type: type, message: message, peer: peer, completion: { message, error in
                 if error == nil {
-                    resolve?(["success": true, "data": ["sender": message?.sender?.name ?? "", "message": message?.message ?? "", "type": message?.type]])
+                    resolve?(["success": true, "data": ["sender": message?.sender?.name ?? "", "message": message?.message ?? "", "type": message?.type]] as [String: Any])
                     return
                 } else {
                     if self?.eventsEnableStatus[HMSConstants.ON_ERROR] == true {
@@ -512,7 +516,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
                     let track = HMSHelper.getTrackFromTrackId(trackId, remotePeers)
                 else {
                     if strongSelf.eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                        strongSelf.delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Track not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": strongSelf.id])
+                        strongSelf.delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Track not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": strongSelf.id])
                     }
                     reject?("Track not found", "Track not found", nil)
                     return
@@ -575,6 +579,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             self?.hms?.endRoom(lock: lock, reason: reason, completion: { success, error in
                 if success {
                     resolve?(["success": success])
+                    self?.cleanup() // resetting states and doing data cleanup
                 } else {
                     if self?.eventsEnableStatus[HMSConstants.ON_ERROR] == true {
                         self?.delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": HMSDecoder.getError(error), "id": self?.id ?? "12345"])
@@ -684,7 +689,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             if remoteAudioTrack != nil {
                 remoteAudioTrack?.setVolume(volume)
             } else if strongSelf.eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                strongSelf.delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Track not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": strongSelf.id])
+                strongSelf.delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Track not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": strongSelf.id])
             }
         }
     }
@@ -706,7 +711,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             meetingUrl = meetLink
         } else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Invalid meeting url passed", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Invalid meeting url passed", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
             }
             reject?("Invalid meeting url passed", "Invalid meeting url passed", nil)
         }
@@ -838,7 +843,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
     func startScreenshare(_ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
         guard let preferredExtension = preferredExtension else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Could not start screen share, preferredExtension not passed in Build method", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Could not start screen share, preferredExtension not passed in Build method", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
             }
             reject?("Could not start screen share, preferredExtension not passed in Build method", "Could not start screen share, preferredExtension not passed in Build method", nil)
             return
@@ -862,7 +867,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
     func stopScreenshare(_ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
         guard let preferredExtension = preferredExtension else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Could not start screen share, preferredExtension not passed in Build method", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Could not start screen share, preferredExtension not passed in Build method", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
             }
             reject?("Could not start screen share, preferredExtension not passed in Build method", "Could not start screen share, preferredExtension not passed in Build method", nil)
             return
@@ -907,19 +912,19 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
                     resolve?(["success": true])
                 } catch {
                     if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                        delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": error.localizedDescription, "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                        delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": error.localizedDescription, "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
                     }
                     reject?(error.localizedDescription, error.localizedDescription, nil)
                 }
             } else {
                 if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                    delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Incorrect url", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                    delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "Incorrect url", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
                 }
                 reject?("Incorrect URL", "Incorrect URL", nil)
             }
         } else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
             }
             reject?("AudioFilePlayerNode not found", "AudioFilePlayerNode not found", nil)
         }
@@ -955,7 +960,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         if let audioFilePlayerNode = playerNode as? HMSAudioFilePlayerNode {
             audioFilePlayerNode.stop()
         } else if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-            delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+            delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
         }
     }
 
@@ -973,11 +978,11 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
                 try audioFilePlayerNode.resume()
             } catch {
                 if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                    delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": error.localizedDescription, "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                    delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": error.localizedDescription, "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
                 }
             }
         } else if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-            delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+            delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
         }
     }
 
@@ -993,7 +998,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         if let audioFilePlayerNode = playerNode as? HMSAudioFilePlayerNode {
             audioFilePlayerNode.pause()
         } else if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-            delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+            delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
         }
     }
 
@@ -1011,7 +1016,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             resolve?(audioFilePlayerNode.isPlaying)
         } else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
             }
             reject?("AudioFilePlayerNode not found", "AudioFilePlayerNode not found", nil)
         }
@@ -1031,7 +1036,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             resolve?(audioFilePlayerNode.currentTime)
         } else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any] as [String: Any], "id": id])
             }
             reject?("AudioFilePlayerNode not found", "AudioFilePlayerNode not found", nil)
         }
@@ -1051,7 +1056,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
             resolve?(audioFilePlayerNode.duration)
         } else {
             if eventsEnableStatus[HMSConstants.ON_ERROR] == true {
-                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]], "id": id])
+                delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 6002, "description": "AudioFilePlayerNode not found", "isTerminal": false, "canRetry": true, "params": ["function": #function]] as [String: Any], "id": id])
             }
             reject?("AudioFilePlayerNode not found", "AudioFilePlayerNode not found", nil)
         }
@@ -1107,7 +1112,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         }
 
         eventsEnableStatus[eventType] = true
-        resolve?(["success": true, "message": "function call executed successfully"])
+        resolve?(["success": true, "message": "function call executed successfully"] as [String: Any])
     }
 
     func disableEvent(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
@@ -1119,7 +1124,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         }
 
         eventsEnableStatus[eventType] = false
-        resolve?(["success": true, "message": "function call executed successfully"])
+        resolve?(["success": true, "message": "function call executed successfully"] as [String: Any])
     }
 
     func restrictData(_ data: NSDictionary) {
@@ -1446,7 +1451,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         if eventsEnableStatus[HMSConstants.RECONNECTING] != true {
             return
         }
-        self.delegate?.emitEvent(HMSConstants.RECONNECTING, ["event": HMSConstants.RECONNECTING, "error": ["code": 1003, "description": "Network connection lost ", "isTerminal": false, "canRetry": true], "id": self.id ])
+        self.delegate?.emitEvent(HMSConstants.RECONNECTING, ["event": HMSConstants.RECONNECTING, "error": ["code": 1003, "description": "Network connection lost ", "isTerminal": false, "canRetry": true] as [String: Any], "id": self.id ])
     }
 
     func onReconnected() {
@@ -1475,10 +1480,12 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
     }
 
     func on(removedFromRoom notification: HMSRemovedFromRoomNotification) {
-        HMSDecoder.clearRestrictDataStates()
+
         if eventsEnableStatus[HMSConstants.ON_REMOVED_FROM_ROOM] != true {
+            self.cleanup() // resetting states and doing data cleanup
             return
         }
+
         let requestedBy = notification.requestedBy as HMSPeer?
         var decodedRequestedBy: [String: Any]?
         if let requested = requestedBy {
@@ -1487,6 +1494,16 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         let reason = notification.reason
         let roomEnded = notification.roomEnded
         self.delegate?.emitEvent(HMSConstants.ON_REMOVED_FROM_ROOM, ["event": HMSConstants.ON_REMOVED_FROM_ROOM, "id": self.id, "requestedBy": decodedRequestedBy as Any, "reason": reason, "roomEnded": roomEnded ])
+
+        self.cleanup() // resetting states and doing data cleanup
+    }
+
+    func on(sessionStoreAvailable store: HMSSessionStore) {
+        self.sessionStore = store
+        if eventsEnableStatus[HMSConstants.ON_SESSION_STORE_AVAILABLE] != true {
+            return
+        }
+        self.delegate?.emitEvent(HMSConstants.ON_SESSION_STORE_AVAILABLE, ["id": self.id])
     }
 
     func on(rtcStats: HMSRTCStatsReport) {
@@ -1694,8 +1711,221 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         }
     }
 
+    // MARK: - Session Store
+
+    func getSessionMetadataForKey(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
+
+        DispatchQueue.main.async { [weak self] in
+
+            guard let store = self?.sessionStore
+            else {
+                let errorMessage = "\(#function) Session Store is null"
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            guard let data = data as? [AnyHashable: Any],
+                let key = data["key"] as? String
+            else {
+                let errorMessage = "\(#function) Key to be fetched from Session Store is null." + HMSHelper.getUnavailableRequiredKey(data, ["key"])
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            store.object(forKey: key) { value, error in
+
+                if let error = error {
+                    let errorMessage = "\(#function) Error in fetching key: \(key) from Session Store. Error: \(error.localizedDescription)"
+                    reject?("6004", errorMessage, nil)
+                    return
+                }
+
+                if let value = value {
+                    if let stringValue = value as? String {
+                        resolve?(stringValue)
+                    } else {
+                        let errorMessage = "\(#function) Session Store value for the key: \(key) is not of String Type. Value: \(value)"
+                        reject?("6004", errorMessage, nil)
+                    }
+                } else {
+                    resolve?(nil)
+                }
+            }
+        }
+    }
+
+    func setSessionMetadataForKey(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
+
+        DispatchQueue.main.async { [weak self] in
+
+            guard let store = self?.sessionStore
+            else {
+                let errorMessage = "\(#function) Session Store is null"
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            guard let data = data as? [AnyHashable: Any],
+                let key = data["key"] as? String
+            else {
+                let errorMessage = "\(#function) Key for the object to be set in Session Store is null." + HMSHelper.getUnavailableRequiredKey(data, ["key"])
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            let valueToBeSet = data["value"] as Any
+
+            store.set(valueToBeSet, forKey: key) { value, error in
+
+                if let error = error {
+                    let errorMessage = "\(#function) Error in setting value: \(valueToBeSet) for key: \(key) to the Session Store. Error: \(error.localizedDescription)"
+                    reject?("6004", errorMessage, nil)
+                    return
+                }
+                resolve?(["success": true, "finalValue": value])
+            }
+        }
+    }
+
+    func addKeyChangeListener(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
+
+        DispatchQueue.main.async { [weak self] in
+
+            guard let store = self?.sessionStore
+            else {
+                let errorMessage = "\(#function) Session Store is null"
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            guard let data = data as? [AnyHashable: Any]
+            else {
+                let errorMessage = "\(#function) No arguments passed which can be attached to Key Change Listener on the Session Store."
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            guard let keys = data["keys"] as? [String]
+            else {
+                let errorMessage = "\(#function) No keys passed which can be attached to Key Change Listener on the Session Store. Available arguments: \(data)"
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            guard let uniqueId = data["uniqueId"] as? String
+            else {
+                let errorMessage = "\(#function) No uniqueId passed which can be used to attach Key Change Listener on the Session Store. Available arguments: \(data)"
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            store.observeChanges(forKeys: keys, changeObserver: { [weak self] key, value in
+
+                var data = [String: Any]()
+
+                data["id"] = self?.id
+
+                data["key"] = key
+
+                if let value = value {
+                    if let stringValue = value as? String {
+                        data["value"] = stringValue
+                    } else {
+                        let errorMessage = "\(#function) Session Store value for the key: \(key) is not of String Type. Value: \(value)"
+                        print(errorMessage)
+                    }
+                }
+                self?.delegate?.emitEvent(HMSConstants.ON_SESSION_STORE_CHANGED, data)
+
+            }) { [weak self] observer, error in
+
+                    if let error = error {
+                        let errorMessage = "\(#function) Error in observing changes for key: \(keys) in the Session Store. Error: \(error.localizedDescription)"
+                        reject?("6004", errorMessage, nil)
+                        return
+                    }
+
+                    guard let observer = observer
+                    else {
+                        let errorMessage = "\(#function) Unknown Error in observing changes for key: \(keys) in the Session Store."
+                        reject?("6004", errorMessage, nil)
+                        return
+                    }
+
+                    guard let self = self
+                    else {
+                        let errorMessage = "\(#function) Could not find self instance while observing changes for key: \(keys) in the Session Store."
+                        reject?("6004", errorMessage, nil)
+                        return
+                    }
+
+                    self.sessionStoreChangeObservers[uniqueId] = observer
+
+                    resolve?(true)
+                }
+        }
+    }
+
+    func removeKeyChangeListener(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
+
+        DispatchQueue.main.async { [weak self] in
+
+            guard let store = self?.sessionStore
+            else {
+                let errorMessage = "\(#function) Session Store is null"
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            guard let data = data as? [AnyHashable: Any]
+            else {
+                let errorMessage = "\(#function) No arguments passed which can be used to remove Key Change Listener from the Session Store."
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            guard let uniqueId = data["uniqueId"] as? String
+            else {
+                let errorMessage = "\(#function) No uniqueId passed which can be used to remove Key Change Listener from the Session Store. Available arguments: \(data)"
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            guard let observerToBeRemoved = self?.sessionStoreChangeObservers[uniqueId]
+            else {
+                let errorMessage = "\(#function) No listener found to remove for the uniqueId passed. Available arguments: \(data)"
+                reject?("6004", errorMessage, nil)
+                return
+            }
+
+            self?.sessionStoreChangeObservers.removeValue(forKey: uniqueId)
+
+            store.removeObserver(observerToBeRemoved)
+
+            resolve?(true)
+        }
+    }
+
     // MARK: - Helper Functions
 
+    // Handle resetting states and data cleanup
+    private func cleanup() {
+        self.config = nil
+        self.recentRoleChangeRequest = nil
+        self.reconnectingStage = false
+        self.preferredExtension = nil
+        self.systemBroadcastPicker = nil
+        self.startScreenshareResolve = nil
+        self.stopScreenshareResolve = nil
+        self.isScreenShared = false
+        self.previewInProgress = false
+        self.networkQualityUpdatesAttached = false
+        self.eventsEnableStatus.removeAll()
+        self.sessionStore = nil
+        self.sessionStoreChangeObservers.removeAll()
+        HMSDecoder.clearRestrictDataStates()
+    }
+
     private func getString(from update: HMSPeerUpdate) -> String {
         switch update {
         case .peerJoined:
@@ -1763,7 +1993,7 @@ class HMSRNSDK: HMSUpdateListener, HMSPreviewListener {
         if eventsEnableStatus[HMSConstants.ON_ERROR] != true {
             return
         }
-        delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 7000, "description": error, "isTerminal": false, "canRetry": true], "id": id]) // DOUBT: Error code 6002 or 7000?
+        delegate?.emitEvent(HMSConstants.ON_ERROR, ["error": ["code": 7000, "description": error, "isTerminal": false, "canRetry": true] as [String: Any], "id": id])
     }
 
     static private func getDocumentsDirectory() -> URL {

package/lib/commonjs/classes/HMSAudioTrackSettings.js

@@ -7,6 +7,11 @@ exports.HMSAudioTrackSettings = void 0;
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
 function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
+ * Customize local peer's Audio track settings before Joining the Room.
+ *
+ * Checkout Track Settings docs for more details {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/track/track-settings}
+ */
 class HMSAudioTrackSettings {
   // ios only
 
@@ -15,9 +20,18 @@ class HMSAudioTrackSettings {
     _defineProperty(this, "useHardwareEchoCancellation", void 0);
     // android only
     _defineProperty(this, "audioSource", void 0);
+    // ios only
+    /**
+     * [iOS only] `audioMode` allows you to capture audio in its highest quality
+     * by disabling voice processing and increasing the maximum bandwidth limit
+     *
+     * Checkout Music Mode docs for more details {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/configure-your-device/microphone/music-mode}
+     */
+    _defineProperty(this, "audioMode", void 0);
     this.useHardwareEchoCancellation = params.useHardwareEchoCancellation;
     this.initialState = params.initialState;
     this.audioSource = params.audioSource;
+    this.audioMode = params.audioMode;
   }
 }
 exports.HMSAudioTrackSettings = HMSAudioTrackSettings;

package/lib/commonjs/classes/HMSAudioTrackSettings.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSAudioTrackSettings","constructor","params","_defineProperty","useHardwareEchoCancellation","initialState","audioSource","exports"],"sources":["HMSAudioTrackSettings.ts"],"sourcesContent":["import type { HMSTrackSettingsInitState } from './HMSTrackSettingsInitState';\n\nexport class HMSAudioTrackSettings {\n  initialState?: HMSTrackSettingsInitState;\n  useHardwareEchoCancellation?: boolean; // android only\n  audioSource?: string[]; // ios only\n\n  constructor(params: {\n    initialState?: HMSTrackSettingsInitState;\n    useHardwareEchoCancellation?: boolean;\n    audioSource?: string[];\n  }) {\n    this.useHardwareEchoCancellation = params.useHardwareEchoCancellation;\n    this.initialState = params.initialState;\n    this.audioSource = params.audioSource;\n  }\n}\n"],"mappings":";;;;;;;;;AAEO,MAAMA,qBAAqB,CAAC;EAGT;;EAExBC,WAAWA,CAACC,MAIX,EAAE;IAAAC,eAAA;IAAAA,eAAA;IAPoC;IAAAA,eAAA;IAQrC,IAAI,CAACC,2BAA2B,GAAGF,MAAM,CAACE,2BAA2B;IACrE,IAAI,CAACC,YAAY,GAAGH,MAAM,CAACG,YAAY;IACvC,IAAI,CAACC,WAAW,GAAGJ,MAAM,CAACI,WAAW;EACvC;AACF;AAACC,OAAA,CAAAP,qBAAA,GAAAA,qBAAA"}
+{"version":3,"names":["HMSAudioTrackSettings","constructor","params","_defineProperty","useHardwareEchoCancellation","initialState","audioSource","audioMode","exports"],"sources":["HMSAudioTrackSettings.ts"],"sourcesContent":["import type { HMSIOSAudioMode } from './HMSIOSAudioMode';\nimport type { HMSTrackSettingsInitState } from './HMSTrackSettingsInitState';\n\n/**\n * Customize local peer's Audio track settings before Joining the Room.\n *\n * Checkout Track Settings docs for more details {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/interact-with-room/track/track-settings}\n */\nexport class HMSAudioTrackSettings {\n  initialState?: HMSTrackSettingsInitState;\n  useHardwareEchoCancellation?: boolean; // android only\n  audioSource?: string[]; // ios only\n\n  /**\n   * [iOS only] `audioMode` allows you to capture audio in its highest quality\n   * by disabling voice processing and increasing the maximum bandwidth limit\n   *\n   * Checkout Music Mode docs for more details {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/configure-your-device/microphone/music-mode}\n   */\n  audioMode?: HMSIOSAudioMode; // ios only\n\n  constructor(params: {\n    initialState?: HMSTrackSettingsInitState;\n    useHardwareEchoCancellation?: boolean;\n    audioSource?: string[];\n    audioMode?: HMSIOSAudioMode;\n  }) {\n    this.useHardwareEchoCancellation = params.useHardwareEchoCancellation;\n    this.initialState = params.initialState;\n    this.audioSource = params.audioSource;\n    this.audioMode = params.audioMode;\n  }\n}\n"],"mappings":";;;;;;;;;AAGA;AACA;AACA;AACA;AACA;AACO,MAAMA,qBAAqB,CAAC;EAWJ;;EAE7BC,WAAWA,CAACC,MAKX,EAAE;IAAAC,eAAA;IAAAA,eAAA;IAhBoC;IAAAA,eAAA;IACf;IAExB;AACF;AACA;AACA;AACA;AACA;IALEA,eAAA;IAcE,IAAI,CAACC,2BAA2B,GAAGF,MAAM,CAACE,2BAA2B;IACrE,IAAI,CAACC,YAAY,GAAGH,MAAM,CAACG,YAAY;IACvC,IAAI,CAACC,WAAW,GAAGJ,MAAM,CAACI,WAAW;IACrC,IAAI,CAACC,SAAS,GAAGL,MAAM,CAACK,SAAS;EACnC;AACF;AAACC,OAAA,CAAAR,qBAAA,GAAAA,qBAAA"}

package/lib/commonjs/classes/HMSEncoder.js

@@ -162,7 +162,8 @@ class HMSEncoder {
   static encodeHmsAudioTrackSettings(settings) {
     const encodedObj = {
       useHardwareEchoCancellation: settings === null || settings === void 0 ? void 0 : settings.useHardwareAcousticEchoCanceler,
-      initialState: settings === null || settings === void 0 ? void 0 : settings.initialState
+      initialState: settings === null || settings === void 0 ? void 0 : settings.initialState,
+      audioMode: settings === null || settings === void 0 ? void 0 : settings.audioMode
     };
     return new _HMSAudioTrackSettings.HMSAudioTrackSettings(encodedObj);
   }