Generalize Error Handling (#28)

* added new errorhandling file, removed vertical space to clean swiftlint

* created more global error handling method to be reused

* added little documentation

* adds more generalized error enum

* Add Scribe to project dependecies

* Add a basic shared Scribe object

* Make Errors private and specific

* Use t.error for mock errors

* Use new ErrorHandler singleton

* Add ErrorHandler and ToastErrorPlugin

* Removed singleton ErrorHandler

* Add ScribeLogging protocol

* Move logging files to a folder

---------

Co-authored-by: Leif <[email protected]>

Author: haIIux

Diff for: base/App/Profile/ProfileScreen.swift

@@ -35,7 +35,7 @@ struct ProfileScreen: View {
                 RegisterScreen(
                     registerViewModel: RegisterViewModel(
                         // TODO: (base-Template) Update to Production
-                        registerNetworking: SuccessMockRegisterService()
+                        registerNetworking: NoDataFailureMockRegisterService()
                     )
                 )
             }

Diff for: base/App/Profile/Register/RegisterNetworking.swift

@@ -14,7 +14,7 @@
 //  RegisterNetworking.swift
 //
 
-import Foundation
+import t
 
 protocol RegisterNetworking {
    mutating func register(
@@ -65,7 +65,7 @@ struct NoDataFailureMockRegisterService: RegisterNetworking {
         password: String,
         passwordConfirmation: String
     ) async throws -> User {
-      throw AuthError.noData
+        throw t.error(description: "No Data")
     }
 }
 
@@ -77,6 +77,6 @@ struct ValidationFailureMockRegisterService: RegisterNetworking {
         password: String,
         passwordConfirmation: String
     ) async throws -> User {
-        throw AuthError.validation(reason: "Mock Failure")
+        throw t.error(description: "Validation")
     }
 }

Diff for: base/App/Profile/Register/RegisterViewModel.swift

@@ -20,17 +20,27 @@ import Foundation
  The `RegisterViewModel` conforms to type `ObservableObject`,
  and acts as mediator between the view and the networking layer.
  */
-class RegisterViewModel: ObservableObject {
+class RegisterViewModel: ObservableObject, ErrorHandling {
     private var registerNetworking: RegisterNetworking
     private var registerTask: Task<Void, Never>?
 
+    var errorHandler: ErrorHandler
+
     @Published var username = ""
     @Published var email = ""
     @Published var password = ""
     @Published var confirmationPassword = ""
 
-    init(registerNetworking: RegisterNetworking) {
+    init(
+        registerNetworking: RegisterNetworking,
+        errorHandler: ErrorHandler = ErrorHandler(
+            plugins: [
+                ToastErrorPlugin()
+            ]
+        )
+    ) {
         self.registerNetworking = registerNetworking
+        self.errorHandler = errorHandler
     }
 
     var areFieldsValidated: Bool {
@@ -63,29 +73,12 @@ class RegisterViewModel: ObservableObject {
                     )
                 }
             } catch {
-                handle(error: error)
+                errorHandler.handle(error: error)
             }
         }
 
         registerTask = task
 
         return task
     }
-
-    private func handle(error: Error) {
-        #if DEBUG
-        Navigation.path.toast(
-            title: "Error",
-            message: error.localizedDescription,
-            style: .error
-        )
-        #else
-        print("⚠️ Error! - \(error)")
-        Navigation.path.toast(
-            title: "Error",
-            message: "There was an error registering your account, please try again.",
-            style: .error
-        )
-        #endif
-    }
 }

Diff for: base/Networking/Implementation/AuthNetworking+Default.swift

@@ -16,6 +16,18 @@
 
 import Foundation
 
+private enum AuthNetworkingError: LocalizedError {
+    case noData
+    case validation(reason: String)
+
+    var errorDescription: String? {
+        switch self {
+        case .noData:                   return "\(#fileID): No Data"
+        case let .validation(reason):   return "\(#fileID): Validation: \(reason)"
+        }
+    }
+}
+
 extension AuthNetworking {
     var tokenFileName: String { "base.token" }
 
@@ -75,13 +87,13 @@ extension AuthNetworking {
         let httpResponse = dataResponse.response as? HTTPURLResponse
 
         guard httpResponse?.statusCode == 200 else {
-            throw AuthError.validation(
+            throw AuthNetworkingError.validation(
                 reason: "Status code was not 200, but was: '\(httpResponse?.statusCode ?? -1)'"
             )
         }
 
         guard let data = dataResponse.data else {
-            throw AuthError.noData
+            throw AuthNetworkingError.noData
         }
 
         let decoder = JSONDecoder()

Diff for: base/Networking/Interface/AuthNetworking+Models.swift

@@ -17,13 +17,11 @@
 import Foundation
 import t
 
-enum AuthError: LocalizedError {
-    case noData
+private enum RegisterPayloadError: LocalizedError {
     case validation(reason: String)
 
     var errorDescription: String? {
         switch self {
-        case .noData:                   return "\(#fileID): No Data"
         case let .validation(reason):   return "\(#fileID): Validation: \(reason)"
         }
     }
@@ -59,7 +57,7 @@ struct RegisterPayload: Codable {
                 try t.assert(email.matches(of: regex).isEmpty == false)
             }
         } catch {
-            throw AuthError.validation(reason: "Invalid Email Address")
+            throw RegisterPayloadError.validation(reason: "Invalid Email Address")
         }
     }
 
@@ -69,7 +67,7 @@ struct RegisterPayload: Codable {
                 try t.assert(name.count < 256)
             }
         } catch {
-            throw AuthError.validation(reason: "Username is too long")
+            throw RegisterPayloadError.validation(reason: "Username is too long")
         }
     }
 
@@ -83,7 +81,7 @@ struct RegisterPayload: Codable {
                 try t.assert(password.matches(of: regex).isEmpty == false)
             }
         } catch {
-            throw AuthError.validation(
+            throw RegisterPayloadError.validation(
                 reason: """
                         Passwords must contain:
                             - At least 10 characters

Diff for: base/Utilities/Errors/ErrorHandler.swift

@@ -0,0 +1,31 @@
+//
+//  base template generated by OpenBytes on 12/17/22.
+//  Copyright (c) 2023 OpenBytes
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the conditions found at the following link:
+//  https://github.com/0xOpenBytes/ios-BASE/blob/main/LICENSE
+//
+// Created by Rob Maltese.
+//  ErrorHandler.swift
+//
+
+import Plugin
+
+class ErrorHandler: Pluginable {
+    var plugins: [any Plugin]
+
+    init(plugins: [any Plugin]) {
+        self.plugins = plugins
+    }
+
+    func handle(error: Error) {
+        Task {
+            try? await handle(value: error)
+        }
+    }
+}

Diff for: base/Utilities/Errors/ErrorHandling.swift

@@ -0,0 +1,19 @@
+//
+//  base template generated by OpenBytes on 2/16/23.
+//  Copyright (c) 2023 OpenBytes
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the conditions found at the following link:
+//  https://github.com/0xOpenBytes/ios-BASE/blob/main/LICENSE
+//
+// Created by Leif.
+//  ErrorHandling.swift
+//
+
+protocol ErrorHandling {
+    var errorHandler: ErrorHandler { get set }
+}

Diff for: base/Utilities/Errors/Plugins/ToastErrorPlugin.swift

@@ -0,0 +1,40 @@
+//
+//  base template generated by OpenBytes on 2/16/23.
+//  Copyright (c) 2023 OpenBytes
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the conditions found at the following link:
+//  https://github.com/0xOpenBytes/ios-BASE/blob/main/LICENSE
+//
+// Created by Leif.
+//  ToastErrorPlugin.swift
+//
+
+import Plugin
+import Scribe
+
+struct ToastErrorPlugin: ImmutablePlugin {
+    func handle(value: Error) async throws {
+        baseScribe.shared.error(
+            Scribe.Message(stringLiteral: value.localizedDescription)
+        )
+
+        #if DEBUG
+        Navigation.path.toast(
+            title: "Error",
+            message: value.localizedDescription,
+            style: .error
+        )
+        #else
+        Navigation.path.toast(
+            title: "Error",
+            message: "Encountered an error, please try again.",
+            style: .error
+        )
+        #endif
+    }
+}

Diff for: base/Utilities/Logging/ScribeLogging.swift

@@ -0,0 +1,21 @@
+//
+//  base template generated by OpenBytes on 2/17/23.
+//  Copyright (c) 2023 OpenBytes
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the conditions found at the following link:
+//  https://github.com/0xOpenBytes/ios-BASE/blob/main/LICENSE
+//
+// Created by Leif.
+//  ScribeLogging.swift
+//
+
+import Scribe
+
+protocol ScribeLogging {
+    var scribe: Scribe { get set }
+}

Diff for: base/Utilities/Logging/baseScribe.swift

@@ -0,0 +1,26 @@
+//
+//  base template generated by OpenBytes on 2/16/23.
+//  Copyright (c) 2023 OpenBytes
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the conditions found at the following link:
+//  https://github.com/0xOpenBytes/ios-BASE/blob/main/LICENSE
+//
+// Created by Leif.
+//  baseScribe.swift
+//
+
+import Scribe
+
+class baseScribe: Scribe {
+    static var shared: baseScribe = baseScribe(
+        label: "base.scribe",
+        plugins: [
+
+        ]
+    )
+}

Diff for: project.yml

@@ -5,6 +5,9 @@ packages:
   Fork:
     url: https://github.com/0xLeif/Fork
     from: 1.0.0
+  Scribe:
+    url: https://github.com/0xLeif/Scribe
+    from: 1.2.0
   o:
     url: https://github.com/0xOpenBytes/o
     from: 2.0.0
@@ -48,6 +51,7 @@ targets:
             - "Swish"
     dependencies:
       - package: Fork
+      - package: Scribe
       - package: o
       - package: c
     postCompileScripts: