@rentlydev/rently-tuya 0.1.0

package/ios/listener/RentlyTuya.swift

@@ -0,0 +1,544 @@
+import SwiftUI
+import ThingSmartBaseKit
+import ThingSmartCameraKit
+import ThingSmartActivatorKit
+import ThingSmartActivatorCoreKit
+
+@objc(RentlyTuya)
+class RentlyTuya: NSObject {
+    
+    private var activatorResolve: RCTPromiseResolveBlock?
+    private var activatorReject: RCTPromiseRejectBlock?
+
+    @objc(initAirbrake:resolver:rejecter:)
+    func initAirbrake(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let projectId = params["id"] as? String,
+              let projectKey = params["key"] as? String else {
+            let message = "Missing required parameters."
+            rejecter("invalid_params", message, nil)
+            return
+        }
+
+        Airbrake.initialize(apiKey: projectKey, projectID: projectId)
+        resolver(true)
+    }
+    
+    @objc(getCurrentWifi:rejecter:)
+    func getCurrentWifi(
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        let ssid = ThingSmartActivator.currentWifiSSID()
+        if (ssid.isEmpty) {
+            let message = "Unable to retrieve the current Wi-Fi SSID."
+            print("Tuya: \(message)")
+            rejecter("wifi_error", message, nil)
+            return
+        }
+        print("Tuya: Successfully retrieved current Wi-Fi SSID - \(ssid)")
+        resolver(ssid)
+    }
+    
+    // Currently this is not being used in Smart Home app
+    @objc(getDeviceData:resolver:rejecter:)
+    func getDeviceData(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let deviceId = params["devId"] as? String else {
+            let message = "Device ID is missing in the params."
+            print("Tuya: \(message)")
+            rejecter("invalid_params", message, nil)
+            return
+        }
+        
+        print("Tuya: Fetch device data for device ID - \(deviceId)")
+    }
+    
+    // TODO:: Change the function name to make it consistent with Android
+    // Currently this is not being used in Smart Home app
+    @objc(getHomeDetail:resolver:rejecter:)
+    func getHomeDetail(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let homeIdString = params["homeId"] as? String,
+              let homeId = Int64(homeIdString) else {
+            let message = "Home ID is missing or invalid."
+            print("Tuya: \(message)")
+            rejecter("invalid_params", message, nil)
+            return
+        }
+        
+        let currentHome = ThingSmartHome(homeId: homeId)
+        
+        guard let home = currentHome else {
+            let message = "Failed to retrieve home details for home ID \(homeId)."
+            print("Tuya: \(message)")
+            rejecter("home_error", message, nil)
+            return
+        }
+        
+        let homeDetails: [String: Any] = [
+            "deviceList": home.deviceList ?? [],
+            "groupList": home.groupList ?? [],
+            "sharedDeviceList": home.sharedDeviceList ?? [],
+            "sharedGroupList": home.sharedGroupList ?? []
+        ]
+        
+        print("Tuya: Successfully retrieved home details - Home Details: \(homeDetails)")
+        resolver(homeDetails)
+    }
+    
+    @objc(getTokenForQRCode:resolver:rejecter:)
+    func getTokenForQRCode(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let homeIdString = params["homeId"] as? String,
+              let homeId = Int64(homeIdString) else {
+            let message = "Home ID is missing or invalid."
+            print("Tuya: \(message)")
+            rejecter("invalid_params", message, nil)
+            return
+        }
+        
+        ThingSmartActivator.sharedInstance()?.getTokenWithHomeId(
+            homeId,
+            success: { token in
+                print("Tuya: Successfully retrieved token for QR code - \(token ?? "nil").")
+                resolver(token)
+            },
+            failure: { error in
+                let errorMessage = error?.localizedDescription ?? "An unknown error occurred while retrieving the token."
+                print("Tuya: \(errorMessage)")
+                rejecter("get_token_error", errorMessage, error)
+            }
+        )
+    }
+    
+    @objc(initActivatorForQRCode:resolver:rejecter:)
+    func initActivatorForQRCode(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let ssid = params["ssid"] as? String,
+              let password = params["password"] as? String,
+              let timeout = params["time"] as? Int,
+              let token = params["token"] as? String else {
+            let message = "SSID, password, time, or token is missing in the params."
+            print("Tuya: \(message)")
+            ThingSmartActivator.sharedInstance()?.stopConfigWiFi()
+            rejecter("invalid_params", message, nil)
+            return
+        }
+        
+        activatorResolve = resolver
+        activatorReject = rejecter
+        
+        ThingSmartActivator.sharedInstance()?.delegate = self
+        ThingSmartActivator.sharedInstance()?.startConfigWiFi(
+            .qrCode,
+            ssid: ssid,
+            password: password,
+            token: token,
+            timeout: TimeInterval(timeout)
+        )
+        print("Tuya: Successfully initiated Wi-Fi configuration using QR code.")
+    }
+    
+    @objc(loginWithUid:resolver:rejecter:)
+    func loginWithUid(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let uid = params["uid"] as? String,
+              let password = params["password"] as? String,
+              let countryCode = params["countryCode"] as? String else {
+            let message = "UID, password, or country code is missing in the params."
+            print("Tuya: \(message)")
+            rejecter("invalid_params", message, nil)
+            return
+        }
+        
+        ThingSmartUser.sharedInstance().loginOrRegister(
+            withCountryCode: countryCode,
+            uid: uid,
+            password: password,
+            createHome: false,
+            success: { result in
+                print("Tuya: Successfully logged in user.")
+                resolver(true)
+            },
+            failure: { error in
+                let errorMessage = error?.localizedDescription ?? "An unknown error occurred during login."
+                print("Tuya: \(errorMessage)")
+                rejecter("login_error", errorMessage, error)
+            }
+        )
+    }
+    
+    @objc(logout:rejecter:)
+    func logout(
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        ThingSmartUser.sharedInstance().loginOut {
+            print("Tuya: Successfully logged out.")
+            resolver(true)
+        } failure: { error in
+            let errorMessage = error?.localizedDescription ?? "An unknown error occurred during logout."
+            print("Tuya: \(errorMessage)")
+            rejecter("logout_error", errorMessage, error)
+        }
+    }
+    
+    @objc(openCameraLivePreview:resolver:rejecter:)
+    func openCameraLivePreview(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let countryCode = params["countryCode"] as? String,
+              let uid = params["uid"] as? String,
+              let password = params["passwd"] as? String,
+              let deviceId = params["devId"] as? String,
+              let homeId = params["homeId"] as? String,
+              let id = params["id"] as? String,
+              let flavour = params["flavour"] as? String else {
+            rejecter("invalid_params", "Missing required params: countryCode, uid, passwd, devId, homeId, id or flavour", nil)
+            return
+        }
+        
+        let lastMoveoutAt = params["last_moveout_at"] as? String
+        let resetRequired = params["resetRequired"] as? Bool
+        let isResident = params["isResident"] as? Bool ?? true
+        let displayRemoveDoorbellButton = params["display_remove_doorbell_button"] as? Bool
+        let tuyaProductName = params["tuya_product_name"] as? String
+        let tuyaProductID = params["product_id"] as? String
+        let uuid = params["device_uuid"] as? String
+        let serialNumber = params["serial_no"] as? String
+        let isDefaultSettingsUpdated = params["doorbell_default_settings_updated"] as? Bool ?? false
+        let motionDetection = params["motion_detection"] as? Bool ?? false
+        let continuousRecording = params["continuous_recording"] as? Bool ?? false
+        let eventRecording = params["event_recording"] as? Bool ?? false
+        let setSensitivityLow = params["set_sensitivity_low"] as? Bool ?? false
+        
+        // Property Credentials
+        let propertyCredentialUsername = params["propertyCredentialUsername"] as? String
+        let propertyCredentialPassword = params["propertyCredentialPassword"] as? String
+        
+        Tuya.shared.lastMoveoutAt = lastMoveoutAt
+        Tuya.shared.resetRequired = resetRequired
+        Tuya.shared.isResident = isResident
+        Tuya.shared.displayRemoveDoorbellButton = displayRemoveDoorbellButton
+        Tuya.shared.tuyaProductName = tuyaProductName
+        Tuya.shared.tuyaProductID = tuyaProductID
+        Tuya.shared.uuid = uuid
+        Tuya.shared.serialNumber = serialNumber
+        Tuya.shared.id = id
+        Tuya.shared.isDefaultSettingsUpdated = isDefaultSettingsUpdated
+        Tuya.shared.motionDetection = motionDetection
+        Tuya.shared.continuousRecording = continuousRecording
+        Tuya.shared.eventRecording = eventRecording
+        Tuya.shared.setSensitivityLow = setSensitivityLow
+        Tuya.shared.flavour = flavour
+        
+        if !Tuya.shared.continuousRecording && !Tuya.shared.eventRecording {
+            Tuya.shared.eventRecording = true
+        }
+        
+        Tuya.shared.loginAndSetDevice(
+            deviceId: deviceId,
+            propertyUid: propertyCredentialUsername ?? uid,
+            propertyPassword: propertyCredentialPassword ?? password,
+            countryCode: countryCode,
+            homeId: homeId,
+            completion: { success, errorMessage, error in
+                if (success) {
+                    openLivePreview(appFlavor: Tuya.shared.flavour)
+                    resolver(true)
+                } else {
+                    rejecter("sync_failed", errorMessage, error)
+                }
+            }
+        )
+    }
+    
+    @objc(registerForPushNotification:resolver:rejecter:)
+    func registerForPushNotification(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let token = params["token"] as? String else {
+            let message = "Token is missing in the params."
+            print("Tuya: \(message)")
+            rejecter("invalid_params", message, nil)
+            return
+        }
+        
+        DispatchQueue.main.async {
+            if let tokenData = token.hexToData() {
+                let error: NSError? = nil
+                ThingSmartSDK.sharedInstance().setDeviceToken(tokenData, withError: error)
+
+                if let error = error {
+                    print("Failed to set device token: \(error.localizedDescription)")
+                    rejecter("set_token_error", error.localizedDescription, error)
+                } else {
+                    print("Tuya: Successfully registered for push notification")
+                    resolver(true)
+                }
+            } else {
+                let message = "Unable to convert token to data"
+                print("Tuya: \(message)")
+                rejecter("invalid_token", message, nil)
+            }
+        }
+    }
+
+    @objc(renameDevice:resolver:rejecter:)
+    func renameDevice(
+        params: NSDictionary,
+        resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        guard let deviceId = params["devId"] as? String,
+              let name = params["name"] as? String else {
+            let message = "Device ID or name is missing in the params."
+            print("Tuya: \(message)")
+            rejecter("invalid_params", message, nil)
+            return
+        }
+        
+        ThingSmartDevice(deviceId: deviceId)?.updateName(
+            name,
+            success: {
+                print("Tuya: Device renamed successfully")
+                resolver(true)
+            },
+            failure: { error in
+                rejecter("rename_device_error", error?.localizedDescription ?? "Unknown error", error)
+            }
+        )
+    }
+    
+  @objc(resetDevice:resolver:rejecter:)
+  func resetDevice(
+      params: NSDictionary,
+      resolver: @escaping RCTPromiseResolveBlock,
+      rejecter: @escaping RCTPromiseRejectBlock
+  ) {
+      print("Tuya: Received parameters -> \(params)")
+
+      guard let deviceId = params["devId"] as? String,
+            let homeId = params["homeId"] as? String,
+            let username = params["username"] as? String,
+            let password = params["password"] as? String,
+            let countryCode = params["countryCode"] as? String else {
+          print("Tuya: Error - Invalid parameters")
+          resolver(["success": false])
+          return
+      }
+
+      print("Tuya: Attempting login with deviceId: \(deviceId)")
+
+      Tuya.shared.loginAndSetDevice(
+          deviceId: deviceId,
+          propertyUid: username,
+          propertyPassword: password,
+          countryCode: countryCode,
+          homeId: homeId
+      ) { success, _, error in
+          if !success {
+              print("Tuya: Login failed")
+              resolver(["success": false])
+              return
+          }
+          print("Tuya: Device login successful for \(deviceId)")
+
+          guard let device = ThingSmartCameraDPManager(deviceId: deviceId) else {
+              print("Tuya: Error - Failed to get device instance")
+              resolver(["success": false])
+              return
+          }
+
+          let dispatchGroup = DispatchGroup()
+          let operationLock = DispatchQueue(label: "tuya.lock.queue")
+          var operationSuccess = true
+
+          print("Tuya: Starting reset operations...")
+
+          // Reset Chime Settings
+          if device.isSupportDP(ThingSmartCameraDPKey.init(rawValue: "165")) {
+              dispatchGroup.enter()
+              print("Tuya: Updating Chime Settings")
+              self.updateDeviceDP(device, key: ThingSmartCameraDPKey.init(rawValue: "165"), value: "1", message: "Chime Settings", group: dispatchGroup) { success in
+                  operationLock.sync { operationSuccess = operationSuccess && success }
+                  print("Tuya: Chime Settings update \(success ? "succeeded" : "failed")")
+                  dispatchGroup.leave()
+              }
+          }
+
+          // Handle SD Card Formatting & Recording Mode
+          if device.isSupportDP(ThingSmartCameraDPKey.sdCardStatusDPName) {
+              print("Tuya: Device supports SD Card Status DP")
+
+              if device.isSupportDP(ThingSmartCameraDPKey.recordModeDPName) {
+                  dispatchGroup.enter()
+                  print("Tuya: Updating SD Card Record Mode")
+                  self.updateDeviceDP(device, key: ThingSmartCameraDPKey.recordModeDPName, value: "1", message: "SD Card Record Mode", group: dispatchGroup) { success in
+                      operationLock.sync { operationSuccess = operationSuccess && success }
+                      print("Tuya: SD Card Record Mode update \(success ? "succeeded" : "failed")")
+                      dispatchGroup.leave()
+                  }
+              }
+
+              if let sdCardStatus = device.value(forDP: ThingSmartCameraDPKey.sdCardStatusDPName) as? Int {
+                  print("Tuya: Retrieved SD Card Status -> \(sdCardStatus)")
+
+                  if sdCardStatus != 5 {
+                      dispatchGroup.enter()
+                      print("Tuya: Formatting SD Card")
+                      self.updateDeviceDP(device, key: ThingSmartCameraDPKey.sdCardFormatDPName, value: true, message: "SD Card Formatting", group: dispatchGroup) { success in
+                          operationLock.sync { operationSuccess = operationSuccess && success }
+                          print("Tuya: SD Card Formatting \(success ? "succeeded" : "failed")")
+                          dispatchGroup.leave()
+                      }
+                  } else {
+                      print("Tuya: SD Card already formatted or invalid status")
+                  }
+              } else {
+                  print("Tuya: Unable to retrieve SD Card status")
+              }
+          } else {
+              print("Tuya: SD Card status DP is not supported")
+          }
+
+          // Timeout to avoid infinite loader (Max 10s)
+          let timeoutResult = dispatchGroup.wait(timeout: .now() + 10)
+          if timeoutResult == .timedOut {
+              print("Tuya: Timeout - Some operations did not complete in time")
+              resolver(["success": false])
+              return
+          }
+
+          // Final Promise resolution
+          dispatchGroup.notify(queue: .main) {
+              print("Tuya: Reset operations completed. Final success state -> \(operationSuccess)")
+              resolver(["success": operationSuccess])
+          }
+      }
+  }
+
+
+    private func updateDeviceDP(
+        _ device: ThingSmartCameraDPManager,
+        key: ThingSmartCameraDPKey,
+        value: Any,
+        message: String,
+        group: DispatchGroup,
+        completion: @escaping (Bool) -> Void
+    ) {
+        group.enter()
+        device.setValue(value, forDP: key) { _ in
+            print("Tuya: \(message) updated successfully")
+            completion(true)
+            group.leave()
+        } failure: { error in
+            print("Tuya: Failed to update \(message): \(error?.localizedDescription ?? "Unknown error")")
+            completion(false)
+            group.leave()
+        }
+    }
+
+}
+
+extension RentlyTuya: ThingSmartActivatorDelegate {
+    
+    func activator(_ activator: ThingSmartActivator, didReceiveDevice deviceModel: ThingSmartDeviceModel?, error: (any Error)?) {
+        defer {
+            activatorResolve = nil
+            activatorReject = nil
+        }
+
+        if let error = error as NSError? {
+            handleActivatorError(error, deviceModel: deviceModel)
+            return
+        }
+        
+        if let deviceModel = deviceModel {
+            let jsonDict = deviceModel.toDictionary()
+            activatorResolve?(jsonDict)
+        } else {
+            let unknownError = NSError(domain: "RentlyTuya", code: -1, userInfo: [NSLocalizedDescriptionKey: "Device model is nil"])
+            activatorReject?("pair_failed", "Device pairing failed", unknownError)
+        }
+    }
+    
+    func activator(_ activator: ThingSmartActivator, didPassWIFIToSecurityLevelDeviceWithUUID uuid: String) {
+        print("Tuya: Pairing Started")
+        // Continue configuration for security-level devices if necessary
+        // ThingSmartActivator.sharedInstance()?.continueConfigSecurityLevelDevice()
+    }
+
+    private func handleActivatorError(_ error: NSError, deviceModel: ThingSmartDeviceModel?) {
+        switch (error.code, error.localizedDescription) {
+        case (1512, "Timeout"):
+            let timeoutResponse: [String: Any] = ["is_timeout": "true"]
+            activatorResolve?(timeoutResponse)
+
+        case (1501, _):
+            let errorDetails: [String: Any] = [
+                "errorCode": error.localizedFailureReason ?? "",
+                "errorMsg": error.localizedDescription,
+                "id": deviceModel?.devId ?? "",
+                "uuid": deviceModel?.uuid ?? "",
+                "name": deviceModel?.name ?? ""
+            ]
+            let customError = NSError(domain: error.domain, code: error.code, userInfo: [NSLocalizedDescriptionKey: errorDetails])
+            activatorReject?("error_1501", error.localizedDescription, customError)
+
+        default:
+            activatorReject?("pair_failed", error.localizedDescription, error)
+        }
+    }
+}
+
+extension ThingSmartDeviceModel {
+    func toDictionary() -> [String: Any] {
+        return [
+            "devId": self.devId ?? "",
+            "uuid": self.uuid ?? ""
+        ]
+    }
+}
+
+extension String {
+    func hexToData() -> Data? {
+        var data = Data()
+        if self.count % 2 != 0 { return nil }
+        
+        var hexStr = self
+        while hexStr.count > 0 {
+            let c = String(hexStr.prefix(2))
+            hexStr = String(hexStr.dropFirst(2))
+            if let byte = UInt8(c, radix: 16) {
+                data.append(byte)
+            } else {
+                return nil
+            }
+        }
+        return data
+    }
+}

package/ios/theme/LocalColor.swift

@@ -0,0 +1,33 @@
+import SwiftUI
+
+struct LocalColor {
+    struct Main {
+        static var light = Color(hex: "#f3faff")
+        static var dark = Color(hex: "#329ddc")
+    }
+
+    struct Primary {
+        static let light = Color(#colorLiteral(red: 0, green: 0.6419225335, blue: 0.9344936609, alpha: 1))
+        static let secondary = Color(#colorLiteral(red: 0.3606210351, green: 0.5981844068, blue: 0.7222386599, alpha: 1))
+        static let dark = Color(#colorLiteral(red: 0, green: 0.6262267828, blue: 0.8854203224, alpha: 1))
+        static let medium = Color(#colorLiteral(red: 0, green: 0.5515162945, blue: 0.8891028762, alpha: 1))
+    }
+    
+    struct Secondary {
+        static let white = Color(#colorLiteral(red: 0.9466181397, green: 0.9815257192, blue: 1, alpha: 1))
+        static let light = Color(#colorLiteral(red: 0.8319713473, green: 0.9325252771, blue: 0.9908282161, alpha: 1))
+    }
+    
+    struct Danger {
+        static let primary = Color(#colorLiteral(red: 0.8711757064, green: 0, blue: 0, alpha: 1))
+    }
+    
+    struct Monochrome {
+        static let white = Color.white
+        static let regular = Color(#colorLiteral(red: 0.5263667703, green: 0.5214033127, blue: 0.5515511632, alpha: 1))
+        static let medium = Color(#colorLiteral(red: 0.2326147854, green: 0.3040209115, blue: 0.3540382385, alpha: 1))
+        static let grey = Color(#colorLiteral(red: 0.2156862617, green: 0.2156862617, blue: 0.2156862617, alpha: 1))
+        static let black = Color.black
+        static let transparent = Color.clear
+    }
+}

package/ios/theme/LocalFont.swift

@@ -0,0 +1,32 @@
+import SwiftUI
+
+import SwiftUI
+
+struct LocalFont {
+    struct FontSize {
+        static let XS: CGFloat = 10
+        static let S: CGFloat = 12
+        static let M: CGFloat = 14
+        static let L: CGFloat = 16
+        static let XL18: CGFloat = 18
+        static let XL20: CGFloat = 20
+        static let XL22: CGFloat = 22
+        static let XL24: CGFloat = 24
+        static let XL26: CGFloat = 26
+        static let XL28: CGFloat = 28
+        static let XL30: CGFloat = 30
+        static let XL34: CGFloat = 34
+        static let XL40: CGFloat = 40
+        static let XL50: CGFloat = 50
+        static let XL80: CGFloat = 80
+        static let XL200: CGFloat = 200
+    }
+
+    struct FontFamily {
+        static let light = "Quicksand-Light"
+        static let regular = "Quicksand-Regular"
+        static let medium = "Quicksand-Medium"
+        static let semiBold = "Quicksand-SemiBold"
+        static let bold = "Quicksand-Bold"
+    }
+}

package/ios/theme/Theme.swift

@@ -0,0 +1,71 @@
+import SwiftUI
+
+struct Themes {
+    static func configureTheme(for flavor: String) {
+        switch flavor.lowercased() {
+        case "keyless":
+            configureSmartHomeTheme()
+        case "bellanet":
+            configureBellanetTheme()
+        case "coveyhomes":
+            configureCoveyHomesTheme()
+        case "progress":
+            configureProgressTheme()
+        default:
+            configureSmartHomeTheme()
+        }
+    }
+
+    private static func configureSmartHomeTheme() {
+        LocalColor.Main.light = Color(hex: "#f3faff")
+        LocalColor.Main.dark = Color(hex: "#329ddc")
+    }
+
+    private static func configureBellanetTheme() {
+        LocalColor.Main.light = Color(hex: "#E9F0FF")
+        LocalColor.Main.dark = Color(hex: "#0B1E44")
+    }
+
+    private static func configureCoveyHomesTheme() {
+        LocalColor.Main.light = Color(hex: "#FAF6F6")
+        LocalColor.Main.dark = Color(hex: "#99855E")
+    }
+
+    private static func configureProgressTheme() {
+        LocalColor.Main.light = Color(hex: "#EFF5F4")
+        LocalColor.Main.dark = Color(hex: "#279989")
+    }
+}
+
+extension Color {
+    init(hex: String) {
+        let cleanedHex = hex.trimmingCharacters(in: CharacterSet.alphanumerics.inverted)
+        
+        var rgb: UInt64 = 0
+        Scanner(string: cleanedHex).scanHexInt64(&rgb)
+        
+        let length = cleanedHex.count
+        let r, g, b, a: Double
+        
+        switch length {
+        case 6:
+            r = Double((rgb >> 16) & 0xFF) / 255.0
+            g = Double((rgb >> 8) & 0xFF) / 255.0
+            b = Double(rgb & 0xFF) / 255.0
+            a = 1.0
+        case 8:
+            r = Double((rgb >> 24) & 0xFF) / 255.0
+            g = Double((rgb >> 16) & 0xFF) / 255.0
+            b = Double((rgb >> 8) & 0xFF) / 255.0
+            a = Double(rgb & 0xFF) / 255.0
+        default:
+            r = 0.0
+            g = 0.0
+            b = 0.0
+            a = 1.0
+            print("Invalid hex string, defaulting to black.")
+        }
+        
+        self.init(red: r, green: g, blue: b, opacity: a)
+    }
+}