[CM-2452] Handle Logout, Login, AppID change | iOS SDK

Sources/Kommunicate/Classes/Kommunicate.swift

@@ -137,6 +137,9 @@ open class Kommunicate: NSObject, Localizable {
         case clientConversationIdNotPresent
         case conversationOpenFailed
         case zendeskKeyNotPresent
+        case logoutUserFailed
+        case loginUserFailed
+        case appIDIsMissing
     }
 
     // MARK: - Private properties
@@ -528,6 +531,83 @@ open class Kommunicate: NSObject, Localizable {
         }
     }
 
+    /// This is a Universal function handle login -> conversation building -> conversation launching
+    /// - Parameter appID: `AppID` is compulsory when the `KMUser` is not passed or If `kmUser` `applicationId` is not present.
+    /// - Parameter kmUser : A `KMUser` object which contains user details. If `kmUser` is not passed then it will create new Visitor Login everytime.
+    /// - Parameter viewController: `ViewController` from which the group chat will be launched.
+    /// - Parameter conversation: An instance of `KMConversation` object.
+    /// - Parameter shouldMaintainSession: Determines whether to maintain the session when `kmUser` is not provided and a random (visitor) user is used for login.
+    /// - Parameter completion: If successful the success callback will have a conversationId else it will be `KommunicateError` on failure.
+    open class func launchConversationWithUser(
+        appID: String?,
+        kmUser: KMUser?,
+        from viewController: UIViewController,
+        conversation: KMConversation = KMConversationBuilder().build(),
+        shouldMaintainSession: Bool = true,
+        completion: @escaping (Result<String, KommunicateError>) -> Void
+    ) {
+        let user = kmUser ?? createVisitorUser()
+        let isVisitorUser = (kmUser == nil)
+
+        // Derive and validate Application ID
+        guard let rawAppId = appID ?? user.applicationId,
+              !rawAppId.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {
+            completion(.failure(.appIDIsMissing))
+            return
+        }
+
+        let applicationID = rawAppId.trimmingCharacters(in: .whitespacesAndNewlines)
+
+        // Setup Application ID if missing or mismatched
+        if KMUserDefaultHandler.isAppIdEmpty || !KMUserDefaultHandler.matchesCurrentAppId(applicationID) {
+            KMUserDefaultHandler.setApplicationKey(applicationID)
+        }
+        setup(applicationId: applicationID)
+
+        /// This code will handle the create conversation functionality.
+        func proceedAfterLogin() {
+            createConversation(conversation: conversation) { result in
+                switch result {
+                case .success(let conversationId):
+                    showConversationWith(groupId: conversationId, from: viewController) { success in
+                        success
+                            ? completion(.success(conversationId))
+                            : completion(.failure(.conversationOpenFailed))
+                    }
+                case .failure:
+                    completion(.failure(.conversationCreateFailed))
+                }
+            }
+        }
+
+        /// This code will handle the Login Flow.
+        func loginAndProceed() {
+            if isVisitorUser {
+                Kommunicate.registerUserAsVisitor { _, error in
+                    error != nil
+                        ? completion(.failure(.loginUserFailed))
+                        : proceedAfterLogin()
+                }
+            } else {
+                Kommunicate.registerUser(user) { _, error in
+                    error != nil
+                        ? completion(.failure(.loginUserFailed))
+                        : proceedAfterLogin()
+                }
+            }
+        }
+
+        /// Here the main code execute :
+        let isSameUser = KMUserDefaultHandler.getUserId() == user.userId
+        let shouldProceedWithoutLogin = isLoggedIn && (isSameUser || (shouldMaintainSession && isVisitorUser))
+
+        if shouldProceedWithoutLogin {
+            proceedAfterLogin()
+        } else {
+            loginAndProceed()
+        }
+    }
+
     /// Creates a new conversation with the details passed.
     /// - Parameter conversation: An instance of `KMConversation` object.
     /// - Parameter completion: If successful the success callback will have a conversationId else it will be KMConversationError on failure.