refactor: update LAError handling to include companionNotAvailable

Author: MykolaVasyk

Sources/LocalAuthenticationProvider/LocalAuthenticationError.swift

@@ -91,6 +91,9 @@ public enum LocalAuthenticationError: Error {
     /// The user tapped the fallback button in the authentication dialog, but no fallback is available for the authentication policy.
     case userFallback
 
+    /// The authentication failed because the companion device (e.g., Apple Watch) is not available.
+    case companionNotAvailable
+    
     /// An underlying error occurred.
     ///
     /// - Parameter error: The underlying error.

Sources/LocalAuthenticationProvider/LocalAuthenticationProvider.swift

@@ -199,9 +199,16 @@ public final class LocalAuthenticationProvider: LocalAuthenticationProviderProto
             logger.error("Biometric sensor data has invalid dimensions: \(localizedDescription)")
             return .invalidDimensions
 #endif
-        default:
+        case .companionNotAvailable:
+            logger.error("Companion device not available: \(localizedDescription)")
+            return .companionNotAvailable
+            
+        @unknown default:
             logger.error("Unknown LAError: \(localizedDescription)")
             return .error(laError)
+            // .touchIDLockout (depricated)
+            // .touchIDNotEnrolled (depricated)
+            // .touchIDNotAvailable (depricated)
         }
     }
 

Tests/LocalAuthenticationProviderTests/LocalAuthProviderLAErrorCasesTests.swift

@@ -165,6 +165,22 @@ final class LocalAuthProviderLAErrorCasesTests: XCTestCase {
         } catch {
         }
     }
+    
+    @available(iOS 18.0, *)
+        func testMapToLocalAuthenticationErrorCompanionNotAvailable() async {
+            let context = MockLAContext(
+                canEvaluatePolicies: [.deviceOwnerAuthenticationWithBiometrics],
+                biometryType: .faceID,
+                evaluatePolicyError: LAError(.companionNotAvailable)
+            )
+            let provider = LocalAuthenticationProvider(context: context)
+            do {
+                _ = try await provider.authenticate(localizedReason: "Test")
+                XCTFail("Error must be thrown")
+            } catch LocalAuthenticationError.companionNotAvailable {
+            } catch {
+            }
+        }
 #if os(macOS)
     func testMapToLocalAuthenticationErrorBiometryDisconnected() async {
         let context = MockLAContext(