Update Documentation and testing it in App Target

Author: sanchitmehtagit

App/AppDelegate.swift

@@ -1,7 +1,7 @@
 import UIKit
 import Auth0
 
-@UIApplicationMain
+@main
 class AppDelegate: UIResponder, UIApplicationDelegate {
 
     var window: UIWindow?

App/ViewController.swift

@@ -1,25 +1,49 @@
 import UIKit
 import Auth0
 
+// MARK: - Swift 6 Sendability Test: CredentialsManager in Actor
+actor AuthService {
+    let credentialsManager: CredentialsManager
+    
+    init() {
+        self.credentialsManager = CredentialsManager(authentication: Auth0.authentication())
+    }
+    
+    func fetchCredentials() async throws -> Credentials {
+        // This method can be called across concurrency contexts eg. Actor
+        return try await credentialsManager.credentials(withScope: "openid profile email",
+                                                        minTTL: 60,
+                                                        parameters: [:],
+                                                        headers: [:])
+    }
+}
+
 class ViewController: UIViewController {
+    
+    // Swift 6 test: CredentialsManager can be used within actors
+    private let authService = AuthService()
 
     @IBAction func login(_ sender: Any) {
         Auth0
             .webAuth()
             .logging(enabled: true)
-            .start {
-                switch $0 {
+            .start { [weak self] result in
+                switch result {
                 case .failure(let error):
                     DispatchQueue.main.async {
-                        self.alert(title: "Error", message: "\(error)")
+                        self?.alert(title: "Error", message: "\(error)")
                     }
                 case .success(let credentials):
                     DispatchQueue.main.async {
-                        self.alert(title: "Success",
+                        self?.alert(title: "Success",
                                    message: "Authorized and got a token \(credentials.accessToken)")
                     }
+  //                   Test: Fetch credentials from actor with custom scope
+                    Task {
+                        await self?.testFetchCredentials()
+                    }
                 }
-                print($0)
+                print(result)
             }
     }
 
@@ -34,6 +58,16 @@ class ViewController: UIViewController {
                 }
             }
     }
+    
+    // Additional test method to fetch credentials from actor
+    func testFetchCredentials() async {
+        do {
+            let credentials = try await authService.fetchCredentials()
+            print("Successfully fetched credentials within actor: \(credentials.accessToken)")
+        } catch {
+            print("Failed to fetch credentials: \(error)")
+        }
+    }
 
 }
 

Auth0.xcodeproj/project.pbxproj

@@ -3891,7 +3891,7 @@
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE = "";
 				PROVISIONING_PROFILE_SPECIFIER = "";
-				SWIFT_VERSION = 5.0;
+				SWIFT_VERSION = 6.0;
 			};
 			name = Debug;
 		};
@@ -3913,7 +3913,7 @@
 				PRODUCT_BUNDLE_IDENTIFIER = com.auth0.OAuth2;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
-				SWIFT_VERSION = 5.0;
+				SWIFT_VERSION = 6.0;
 			};
 			name = Release;
 		};

Auth0/CredentialsManager.swift

@@ -33,7 +33,7 @@ public struct CredentialsManager: Sendable {
     #if WEB_AUTH_PLATFORM
     var bioAuth: BioAuthentication?
     // Biometric session management - using a class to allow mutation in non-mutating methods
-    // @unchecked Sendable is fine here as we are using lock to read and update lastBiometricAuthTime which is safe acorss threads.
+    // @unchecked Sendable is fine here as we are using lock to read and update lastBiometricAuthTime which is safe across threads.
     private final class BiometricSession: @unchecked Sendable {
         let noSession: TimeInterval = -1
         var lastBiometricAuthTime: TimeInterval = -1

EXAMPLES.md

@@ -367,6 +367,16 @@ The Credentials Manager utility allows you to securely store and retrieve the us
 let credentialsManager = CredentialsManager(authentication: Auth0.authentication())
 ```
 
+> [!CAUTION]
+> The Credentials Manager is not thread-safe, except for the following methods: 
+> 
+> - `credentials()`
+> - `apiCredentials()`
+> - `ssoCredentials()`
+> - `renew()`
+> 
+> To avoid concurrency issues, do not call its non thread-safe methods and properties from different threads without proper synchronization.
+
 > [!NOTE]
 > **Swift 6 Concurrency Support**: The Credentials Manager conforms to `Sendable` and can be safely used across concurrency contexts, including within actors.
 >
@@ -389,16 +399,6 @@ let credentialsManager = CredentialsManager(authentication: Auth0.authentication
 > }
 > ```
 
-> [!CAUTION]
-> The Credentials Manager is not thread-safe, except for the following methods: 
-> 
-> - `credentials()`
-> - `apiCredentials()`
-> - `ssoCredentials()`
-> - `renew()`
-> 
-> To avoid concurrency issues, do not call its non thread-safe methods and properties from different threads without proper synchronization.
-
 ### Store credentials
 
 When your users log in, store their credentials securely in the Keychain. You can then check if their credentials are still valid when they open your app again.