react-native-hyperswitch-dev-sdk 0.4.1

package/ios/hyperswitchSDK/Shared/Codable+UIKit.swift

@@ -0,0 +1,75 @@
+//
+//  Codable+UIKit.swift
+//  hyperswitch
+//
+//  Created by Harshit Srivastava on 09/10/25.
+//
+
+import UIKit
+
+// MARK: - CodableColor Wrapper
+public struct CodableColor: Codable, Equatable {
+    private let wrapped: UIColor
+
+    public init(_ color: UIColor) {
+        self.wrapped = color
+    }
+
+    // Accessor for UIKit API compatibility
+    public var uiColor: UIColor { wrapped }
+
+    public func encode(to encoder: Encoder) throws {
+        var container = encoder.singleValueContainer()
+        guard let hex = wrapped.hexString else {
+            throw EncodingError.invalidValue(
+                wrapped,
+                EncodingError.Context(
+                    codingPath: container.codingPath,
+                    debugDescription: "Failed to encode UIColor to hex"
+                )
+            )
+        }
+        try container.encode(hex)
+    }
+
+    public init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        let hex = try container.decode(String.self)
+        guard let decoded = UIColor(hexString: hex) else {
+            throw DecodingError.dataCorruptedError(
+                in: container,
+                debugDescription: "Invalid hex string: \(hex)"
+            )
+        }
+        self.wrapped = decoded
+    }
+}
+
+// MARK: - CodableFont Wrapper
+public struct CodableFont: Codable, Equatable {
+    private let wrapped: UIFont
+
+    public init(_ font: UIFont) {
+        self.wrapped = font
+    }
+
+    // Accessor for UIKit API compatibility
+    public var uiFont: UIFont { wrapped }
+
+    public func encode(to encoder: Encoder) throws {
+        var container = encoder.singleValueContainer()
+        try container.encode(wrapped.fontName)
+    }
+
+    public init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        let name = try container.decode(String.self)
+        guard let decodedFont = UIFont(name: name, size: .zero) else {
+            throw DecodingError.dataCorruptedError(
+                in: container,
+                debugDescription: "Invalid font name: \(name)"
+            )
+        }
+        self.wrapped = decodedFont
+    }
+}

package/ios/hyperswitchSDK/Shared/CustomEndpointConfiguration.swift

@@ -0,0 +1,67 @@
+//
+//  CustomEndpointConfiguration.swift
+//  HyperswitchCore
+//
+//  Created by Harshit Srivastava on 17/05/26.
+//
+
+public enum CustomEndpointConfiguration: Codable {
+    case commonEndpoint(String)
+    case overrideEndpoints(OverrideEndpointConfiguration)
+
+    private enum CodingKeys: String, CodingKey {
+        case commonEndpoint
+        case overrideEndpoints
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var container = encoder.container(keyedBy: CodingKeys.self)
+        switch self {
+        case .commonEndpoint(let value):
+            try container.encode(value, forKey: .commonEndpoint)
+        case .overrideEndpoints(let config):
+            try container.encode(config, forKey: .overrideEndpoints)
+        }
+    }
+
+    public init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        if let value = try container.decodeIfPresent(String.self, forKey: .commonEndpoint) {
+            self = .commonEndpoint(value)
+        } else if let config = try container.decodeIfPresent(OverrideEndpointConfiguration.self, forKey: .overrideEndpoints) {
+            self = .overrideEndpoints(config)
+        } else {
+            throw DecodingError.dataCorrupted(
+                DecodingError.Context(
+                    codingPath: decoder.codingPath,
+                    debugDescription: ""
+                )
+            )
+        }
+    }
+}
+
+public struct OverrideEndpointConfiguration: Codable {
+    let customBackendEndpoint: String?
+    let customAssetEndpoint: String?
+    let customSDKConfigEndpoint: String?
+    let customConfirmEndpoint: String?
+    let customAirborneEndpoint: String?
+    let customLoggingEndpoint: String?
+
+    public init(
+        customBackendEndpoint: String? = nil,
+        customAssetEndpoint: String? = nil,
+        customSDKConfigEndpoint: String? = nil,
+        customConfirmEndpoint: String? = nil,
+        customAirborneEndpoint: String? = nil,
+        customLoggingEndpoint: String? = nil
+    ) {
+        self.customBackendEndpoint = customBackendEndpoint
+        self.customAssetEndpoint = customAssetEndpoint
+        self.customSDKConfigEndpoint = customSDKConfigEndpoint
+        self.customConfirmEndpoint = customConfirmEndpoint
+        self.customAirborneEndpoint = customAirborneEndpoint
+        self.customLoggingEndpoint = customLoggingEndpoint
+    }
+}

package/ios/hyperswitchSDK/Shared/DictionaryConverter.swift

@@ -0,0 +1,104 @@
+//
+//  DictionaryConverter.swift
+//  Hyperswitch
+//
+//  Created by Balaganesh on 20/12/22.
+//
+
+import Foundation
+import UIKit
+
+protocol DictionaryConverter {
+    func toDictionary() -> [String: Any]
+}
+
+extension DictionaryConverter {
+
+    /// Helper function to convert a UIColor to a hexadecimal string representation.
+    func hexStringFromColor(color: UIColor) -> String {
+        let cgColorInRGB = color.cgColor.converted(to: CGColorSpace(name: CGColorSpace.sRGB)!, intent: .defaultIntent, options: nil)!
+        let colorRef = cgColorInRGB.components
+        let r = colorRef?[0] ?? 0
+        let g = colorRef?[1] ?? 0
+        let b = ((colorRef?.count ?? 0) > 2 ? colorRef?[2] : g) ?? 0
+        let a = color.cgColor.alpha
+
+        var color = String(
+            format: "#%02lX%02lX%02lX",
+            lroundf(Float(r * 255)),
+            lroundf(Float(g * 255)),
+            lroundf(Float(b * 255))
+        )
+
+        if a < 1 {
+            color += String(format: "%02lX", lroundf(Float(a * 255)))
+        }
+
+        return color
+    }
+
+    /// Function to convert the current instance to a dictionary.
+    func toDictionary() -> [String: Any] {
+        let reflect = Mirror(reflecting: self)
+        let children = reflect.children
+        let dictionary = toAnyHashable(elements: children)
+        return dictionary
+    }
+
+    /// Recursive helper function to convert the properties of an instance to a dictionary.
+    func toAnyHashable(elements: AnyCollection<Mirror.Child>) -> [String: Any] {
+        var dictionary: [String: Any] = [:]
+        for element in elements {
+            if let key = element.label {
+
+                if let value = element.value as? AnyHashable {
+                    if "\(value)" == "nil" {
+                        continue
+                    }
+                }
+
+                let isEnumValue = Mirror(reflecting: element.value).displayStyle == .enum
+
+                if let collectionValidHashable = element.value as? [AnyHashable] {
+                    dictionary[key] = collectionValidHashable
+                }
+
+                if let validHashable = element.value as? AnyHashable {
+                    if isEnumValue {
+                        dictionary[key] = "\(validHashable)"
+                    } else {
+                        dictionary[key] = validHashable
+                    }
+                }
+
+                /// Handle Theme values
+                if let theme = element.value as? PaymentSheet.Appearance.Theme {
+                    dictionary[key] = theme.themeLabel
+                }
+
+                /// Handle UIColor values
+                if let color = element.value as? UIColor {
+                    dictionary[key] = self.hexStringFromColor(color: color)
+                }
+
+                /// Handle UIFont values
+                if let font = element.value as? UIFont {
+                    dictionary[key] = font.fontName
+                }
+
+                if let convertor = element.value as? DictionaryConverter {
+                    if !isEnumValue {
+                        dictionary[key] = convertor.toDictionary()
+                    }
+                }
+
+                if let convertorList = element.value as? [DictionaryConverter] {
+                    dictionary[key] = convertorList.map({ e in
+                        e.toDictionary()
+                    })
+                }
+            }
+        }
+        return dictionary
+    }
+}

package/ios/hyperswitchSDK/Shared/Environment.swift

@@ -0,0 +1,24 @@
+//
+//  Environment.swift
+//  hyperswitch
+//
+//  Created by Kuntimaddi Manideep on 24/01/25.
+//
+
+import Foundation
+
+enum SDKEnvironment {
+    case PROD, SANDBOX
+
+    static func getEnvironment(_ publishableKey: String) -> SDKEnvironment {
+        return publishableKey.contains("_snd_") ? .SANDBOX : .PROD
+    }
+
+    static func baseURL(for publishableKey: String) -> String {
+        return getEnvironment(publishableKey) == .PROD ? "https://api.hyperswitch.io" : "https://sandbox.hyperswitch.io"
+    }
+
+    static func loggingURL(for publishableKey: String) -> String {
+        return "\(baseURL(for: publishableKey))/logs/sdk"
+    }
+}

package/ios/hyperswitchSDK/Shared/Extensions.swift

@@ -0,0 +1,101 @@
+//
+//  Extensions.swift
+//  hyperswitch
+//
+//  Created by Harshit Srivastava on 05/09/24.
+//
+
+import Foundation
+import UIKit
+
+internal extension UIColor {
+    static func dynamic(light: UIColor, dark: UIColor) -> UIColor {
+        return UIColor(dynamicProvider: { (traitCollection) in
+            switch traitCollection.userInterfaceStyle {
+            case .light, .unspecified:
+                return light
+            case .dark:
+                return dark
+            @unknown default:
+                return light
+            }
+        })
+    }
+}
+
+internal extension String {
+    func toJSON() -> Any? {
+        guard let data = self.data(using: .utf8, allowLossyConversion: false) else { return nil }
+        return try? JSONSerialization.jsonObject(with: data, options: .mutableContainers)
+    }
+}
+
+internal extension Encodable {
+    func toDictionary() throws -> [String: Any] {
+        let data = try JSONEncoder().encode(self)
+        guard let dict = try JSONSerialization.jsonObject(with: data) as? [String: Any] else {
+            throw NSError(domain: "Encoding", code: 0)
+        }
+        return dict
+    }
+}
+
+internal extension UIColor {
+    /// Convert UIColor to hex string (#RRGGBB or #RRGGBBAA if alpha < 1)
+    var hexString: String? {
+        guard let sRGB = CGColorSpace(name: CGColorSpace.sRGB),
+            let cgColorInRGB = cgColor.converted(
+                to: sRGB,
+                intent: .defaultIntent,
+                options: nil
+            ),
+            let comps = cgColorInRGB.components
+        else {
+            return nil
+        }
+
+        let r = comps.count > 0 ? comps[0] : 0
+        let g = comps.count > 1 ? comps[1] : 0
+        let b = comps.count > 2 ? comps[2] : 0
+        let a = cgColor.alpha
+
+        var hex = String(
+            format: "#%02lX%02lX%02lX",
+            lroundf(Float(r * 255)),
+            lroundf(Float(g * 255)),
+            lroundf(Float(b * 255))
+        )
+        if a < 1 {
+            hex += String(format: "%02lX", lroundf(Float(a * 255)))
+        }
+        return hex
+    }
+
+    /// Initialize UIColor from hex string (#RRGGBB or #RRGGBBAA)
+    convenience init?(hexString: String) {
+        var hex = hexString.trimmingCharacters(in: .whitespacesAndNewlines)
+        hex = hex.replacingOccurrences(of: "#", with: "")
+
+        var rgb: UInt64 = 0
+        guard Scanner(string: hex).scanHexInt64(&rgb) else { return nil }
+
+        switch hex.count {
+        case 6:
+            self.init(
+                red: CGFloat((rgb & 0xFF0000) >> 16) / 255,
+                green: CGFloat((rgb & 0x00FF00) >> 8) / 255,
+                blue: CGFloat(rgb & 0x0000FF) / 255,
+                alpha: 1.0
+            )
+        case 8:
+            self.init(
+                red: CGFloat((rgb & 0xFF000000) >> 24) / 255,
+                green: CGFloat((rgb & 0x00FF0000) >> 16) / 255,
+                blue: CGFloat((rgb & 0x0000FF00) >> 8) / 255,
+                alpha: CGFloat(rgb & 0x000000FF) / 255
+            )
+        default:
+            return nil
+        }
+    }
+}

package/ios/hyperswitchSDK/Shared/Helper.swift

@@ -0,0 +1,40 @@
+//
+//  Helper.swift
+//  hyperswitch
+//
+//  Created by Harshit Srivastava on 22/10/24.
+//
+
+import Foundation
+
+enum Helper {
+
+    static func getInfoPlist(_ key: String) -> String? {
+        guard let infoDictionary = Bundle.main.infoDictionary,
+            let value = infoDictionary[key] as? String, !value.isEmpty
+        else {
+            return nil
+        }
+        return value
+    }
+
+    /// Dedicated serial queue protecting the read-then-write block
+    private static let uuidQueue = DispatchQueue(label: "io.hyperswitch.helper.uuid")
+
+    static func persistentUUID(for flow: String) -> String {
+        uuidQueue.sync {
+            /// never call this using another uuidQueue.sync (deadlock)
+            let safeFlow = flow.lowercased().replacingOccurrences(of: " ", with: "_")
+            let key = "uuid_\(safeFlow)"
+            let defaults = UserDefaults.standard
+
+            if let existing = defaults.string(forKey: key) {
+                return existing
+            }
+
+            let newUUID = UUID().uuidString
+            defaults.set(newUUID, forKey: key)
+            return newUUID
+        }
+    }
+}

package/ios/hyperswitchSDK/Shared/HyperEvents/PaymentEventData.swift

@@ -0,0 +1,125 @@
+//
+//  PaymentEventData.swift
+//  Hyperswitch
+//
+//  Created by Harshit Srivastava on 21/04/26.
+//
+
+import Foundation
+
+public enum PaymentEventData {
+
+    case cardInfo(CardInfo)
+    case paymentMethodStatus(PaymentMethodStatus)
+    case formStatus(FormStatusEvent)
+    case paymentMethodInfoAddress(PaymentMethodInfoAddress)
+    case cvcStatus(CvcStatus)
+
+    public struct CardInfo: Sendable {
+        public let bin: String?
+        public let last4: String?
+        public let brand: String?
+        public let expiryMonth: String?
+        public let expiryYear: String?
+        public let formattedExpiry: String?
+        public let isCardNumberComplete: Bool
+        public let isCvcComplete: Bool
+        public let isExpiryComplete: Bool
+        public let isCardNumberValid: Bool
+        public let isExpiryValid: Bool
+
+        static func from(_ map: [String: Any]) -> CardInfo {
+            CardInfo(
+                bin: map["bin"] as? String,
+                last4: map["last4"] as? String,
+                brand: map["brand"] as? String,
+                expiryMonth: map["expiryMonth"] as? String,
+                expiryYear: map["expiryYear"] as? String,
+                formattedExpiry: map["formattedExpiry"] as? String,
+                isCardNumberComplete: map["isCardNumberComplete"] as? Bool ?? false,
+                isCvcComplete: map["isCvcComplete"] as? Bool ?? false,
+                isExpiryComplete: map["isExpiryComplete"] as? Bool ?? false,
+                isCardNumberValid: map["isCardNumberValid"] as? Bool ?? false,
+                isExpiryValid: map["isExpiryValid"] as? Bool ?? false
+            )
+        }
+    }
+
+    public struct PaymentMethodStatus: Sendable {
+        public let paymentMethod: String
+        public let paymentMethodType: String
+        public let isSavedPaymentMethod: Bool
+        public let isOneClickWallet: Bool
+
+        static func from(_ map: [String: Any]) -> PaymentMethodStatus {
+            PaymentMethodStatus(
+                paymentMethod: map["paymentMethod"] as? String ?? "",
+                paymentMethodType: map["paymentMethodType"] as? String ?? "",
+                isSavedPaymentMethod: map["isSavedPaymentMethod"] as? Bool ?? false,
+                isOneClickWallet: map["isOneClickWallet"] as? Bool ?? false
+            )
+        }
+    }
+
+    public enum FormStatusValue: String, Sendable {
+        case empty = "EMPTY"
+        case filling = "FILLING"
+        case complete = "COMPLETE"
+    }
+
+    public struct FormStatusEvent: Sendable {
+        public let status: FormStatusValue?
+
+        static func from(_ map: [String: Any]) -> FormStatusEvent {
+            FormStatusEvent(status: (map["status"] as? String).flatMap(FormStatusValue.init(rawValue:)))
+        }
+    }
+
+    public struct PaymentMethodInfoAddress: Sendable {
+        public let country: String
+        public let state: String
+        public let postalCode: String
+
+        static func from(_ map: [String: Any]) -> PaymentMethodInfoAddress {
+            PaymentMethodInfoAddress(
+                country: map["country"] as? String ?? "",
+                state: map["state"] as? String ?? "",
+                postalCode: map["postalCode"] as? String ?? ""
+            )
+        }
+    }
+
+    public struct CvcStatus: Sendable {
+        public let isCvcFocused: Bool
+        public let isCvcBlur: Bool
+        public let isCvcEmpty: Bool
+        public let isCvcComplete: Bool
+
+        static func from(_ map: [String: Any]) -> CvcStatus {
+            let source = (map["cvcStatus"] as? [String: Any]) ?? map
+            return CvcStatus(
+                isCvcFocused: source["isCvcFocused"] as? Bool ?? false,
+                isCvcBlur: source["isCvcBlur"] as? Bool ?? false,
+                isCvcEmpty: source["isCvcEmpty"] as? Bool ?? true,
+                isCvcComplete: source["isCvcComplete"] as? Bool ?? false
+            )
+        }
+    }
+
+    public static func from(type: String, payload: [String: Any]) -> PaymentEventData? {
+        switch type {
+        case PaymentEventType.paymentMethodInfoCard.rawValue:
+            return .cardInfo(.from(payload))
+        case PaymentEventType.paymentMethodStatus.rawValue:
+            return .paymentMethodStatus(.from(payload))
+        case PaymentEventType.formStatus.rawValue:
+            return .formStatus(.from(payload))
+        case PaymentEventType.paymentMethodInfoBillingAddress.rawValue:
+            return .paymentMethodInfoAddress(.from(payload))
+        case PaymentEventType.cvcStatus.rawValue:
+            return .cvcStatus(.from(payload))
+        default:
+            return nil
+        }
+    }
+}

package/ios/hyperswitchSDK/Shared/HyperEvents/PaymentEventSubscriptionBuilder.swift

@@ -0,0 +1,45 @@
+//
+//  PaymentEventSubscriptionBuilder.swift
+//  Hyperswitch
+//
+//  Created by Harshit Srivastava on 21/04/26.
+//
+
+import Foundation
+
+public final class PaymentEventSubscriptionBuilder {
+    private var handlers: [PaymentEventType: (PaymentEvent) -> Void] = [:]
+
+    public init() {}
+
+    public func on(_ eventType: PaymentEventType, _ handler: @escaping (PaymentEvent) -> Void) {
+        handlers[eventType] = handler
+    }
+
+    internal func build() -> (subscription: PaymentEventSubscription, listener: PaymentEventListener) {
+        let dispatch: [String: (PaymentEvent) -> Void] = Dictionary(
+            uniqueKeysWithValues: handlers.map { ($0.key.rawValue, $0.value) }
+        )
+        let subscription = PaymentEventSubscription(eventTypes: Array(handlers.keys))
+        let listener = PaymentEventListener { event in
+            dispatch[event.type]?(event)
+        }
+        return (subscription, listener)
+    }
+}
+
+public struct PaymentEventSubscription: Sendable {
+    public let eventTypes: [PaymentEventType]
+
+    public func isSubscribed(_ rawType: String) -> Bool {
+        eventTypes.contains { $0.rawValue == rawType }
+    }
+
+    public func subscribedEventStrings() -> [String] {
+        eventTypes.map(\.rawValue)
+    }
+}
+
+internal struct PaymentEventListener {
+    let onPaymentEvent: (PaymentEvent) -> Void
+}

package/ios/hyperswitchSDK/Shared/HyperEvents/PaymentEventType.swift

@@ -0,0 +1,30 @@
+//
+//  PaymentEventType.swift
+//  Hyperswitch
+//
+//  Created by Harshit Srivastava on 21/04/26.
+//
+
+import Foundation
+
+public enum PaymentEventType: String, CaseIterable, Sendable {
+    case paymentMethodInfoCard = "PAYMENT_METHOD_INFO_CARD"
+    case paymentMethodStatus = "PAYMENT_METHOD_STATUS"
+    case formStatus = "FORM_STATUS"
+    case paymentMethodInfoBillingAddress = "PAYMENT_METHOD_INFO_BILLING_ADDRESS"
+    case cvcStatus = "CVC_STATUS"
+}
+
+public struct PaymentEvent {
+    public let type: String
+    public let payload: [String: Any]
+
+    public var data: PaymentEventData? {
+        PaymentEventData.from(type: type, payload: payload)
+    }
+
+    public init(type: String, payload: [String: Any]) {
+        self.type = type
+        self.payload = payload
+    }
+}