SDK-470 Add CustomDebugStringConvertible to AuthFailureReason (#1073)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: sumeruchat

swift-sdk/Core/Utilities/AuthFailureReason.swift

@@ -20,3 +20,32 @@ import Foundation
     case authTokenGenerationError
     case authTokenMissing
 }
+
+extension AuthFailureReason: CustomDebugStringConvertible {
+    public var debugDescription: String {
+        switch self {
+        case .authTokenExpired:
+            return "authTokenExpired"
+        case .authTokenGenericError:
+            return "authTokenGenericError"
+        case .authTokenExpirationInvalid:
+            return "authTokenExpirationInvalid"
+        case .authTokenSignatureInvalid:
+            return "authTokenSignatureInvalid"
+        case .authTokenFormatInvalid:
+            return "authTokenFormatInvalid"
+        case .authTokenInvalidated:
+            return "authTokenInvalidated"
+        case .authTokenPayloadInvalid:
+            return "authTokenPayloadInvalid"
+        case .authTokenUserKeyInvalid:
+            return "authTokenUserKeyInvalid"
+        case .authTokenNull:
+            return "authTokenNull"
+        case .authTokenGenerationError:
+            return "authTokenGenerationError"
+        case .authTokenMissing:
+            return "authTokenMissing"
+        }
+    }
+}

tests/unit-tests/AuthTests.swift

@@ -17,6 +17,26 @@ class AuthTests: XCTestCase {
     override func setUp() {
         super.setUp()
     }
+
+    func testAuthFailureReasonDebugDescriptions() {
+        let expectedDescriptions: [(AuthFailureReason, String)] = [
+            (.authTokenExpired, "authTokenExpired"),
+            (.authTokenGenericError, "authTokenGenericError"),
+            (.authTokenExpirationInvalid, "authTokenExpirationInvalid"),
+            (.authTokenSignatureInvalid, "authTokenSignatureInvalid"),
+            (.authTokenFormatInvalid, "authTokenFormatInvalid"),
+            (.authTokenInvalidated, "authTokenInvalidated"),
+            (.authTokenPayloadInvalid, "authTokenPayloadInvalid"),
+            (.authTokenUserKeyInvalid, "authTokenUserKeyInvalid"),
+            (.authTokenNull, "authTokenNull"),
+            (.authTokenGenerationError, "authTokenGenerationError"),
+            (.authTokenMissing, "authTokenMissing")
+        ]
+
+        expectedDescriptions.forEach { reason, description in
+            XCTAssertEqual(String(describing: reason), description)
+        }
+    }
 
     func testEmailPersistence() {
         let internalAPI = InternalIterableAPI.initializeForTesting()