react-native-hyperswitch-dev-sdk 0.4.1

package/ios/hyperswitchSDK/Shared/NativeLogger/LogPayload.swift

@@ -0,0 +1,91 @@
+//
+//  LogPayload.swift
+//  hyperswitch
+//
+//  Created by Kuntimaddi Manideep on 24/01/25.
+//
+
+import Foundation
+
+struct LogPayload: Codable {
+    let timestamp: String
+    let log_type: LogType
+    let component: String
+    let category: LogCategory
+    let version: String
+    let code_push_version: String
+    let client_core_version: String
+    let value: String
+    let internal_metadata: String
+    let session_id: String
+    var merchant_id: String
+    let payment_id: String
+    let authentication_id: String
+    let app_id: String?
+    let platform: String
+    let user_agent: String
+    let event_name: EventName
+    let latency: String?
+    let first_event: String
+    let payment_method: String?
+    let payment_experience: String?
+    let source: String
+
+    func toJson() -> String? {
+        do {
+            let jsonData = try JSONEncoder().encode(self)
+            return String(data: jsonData, encoding: .utf8)
+        } catch {
+            return nil
+        }
+    }
+}
+
+enum LogType: String, Codable {
+    case DEBUG, INFO, ERROR, WARNING
+}
+
+enum LogCategory: String, Codable {
+    case API, USER_ERROR, USER_EVENT, MERCHANT_EVENT, OTA_LIFE_CYCLE
+}
+
+enum EventName: String, Codable {
+    case hyperOTAInit = "HYPER_OTA_INIT"
+    case hyperOTAFinish = "HYPER_OTA_FINISH"
+    case hyperOTAEvent = "HYPER_OTA_EVENT"
+
+    case authenticationSessionInit = "AUTHENTICATION_SESSION_INIT"
+    case authenticationSessionReturned = "AUTHENTICATION_SESSION_RETURNED"
+    case initClickToPaySessionInit = "INIT_CLICK_TO_PAY_SESSION_INIT"
+    case initClickToPaySessionReturned = "INIT_CLICK_TO_PAY_SESSION_RETURNED"
+    case initClickToPayDCTPSessionInit = "INIT_CLICK_TO_PAY_DCTP_SESSION_INIT"
+    case initClickToPayDCTPSessionReturned = "INIT_CLICK_TO_PAY_DCTP_SESSION_RETURNED"
+    case createWebViewInit = "CREATE_WEBVIEW_INIT"
+    case scriptLoadInit = "SCRIPT_LOAD_INIT"
+    case scriptLoadReturn = "SCRIPT_LOAD_RETURN"
+    case dctpScriptLoadInit = "DCTP_SCRIPT_LOAD_INIT"
+    case dctpScriptLoadReturn = "DCTP_SCRIPT_LOAD_RETURN"
+    case createWebViewReturned = "CREATE_WEBVIEW_RETURNED"
+    case getActiveClickToPaySessionInit = "GET_ACTIVE_CLICK_TO_PAY_SESSION_INIT"
+    case getActiveClickToPaySessionReturned = "GET_ACTIVE_CLICK_TO_PAY_SESSION_RETURNED"
+    case isCustomerPresentInit = "IS_CUSTOMER_PRESENT_INIT"
+    case isCustomerPresentReturned = "IS_CUSTOMER_PRESENT_RETURNED"
+    case getUserTypeInit = "GET_USER_TYPE_INIT"
+    case getUserTypeReturned = "GET_USER_TYPE_RETURNED"
+    case getRecognisedCardsInit = "GET_RECOGNISED_CARDS_INIT"
+    case getRecognisedCardsReturned = "GET_RECOGNISED_CARDS_RETURNED"
+    case validateCustomerAuthenticationInit = "VALIDATE_CUSTOMER_AUTHENTICATION_INIT"
+    case validateCustomerAuthenticationReturned = "VALIDATE_CUSTOMER_AUTHENTICATION_RETURNED"
+    case checkoutInit = "CHECKOUT_INIT"
+    case checkoutReturned = "CHECKOUT_RETURNED"
+    case createNewWebViewInit = "CREATE_NEW_WEBVIEW_INIT"
+    case createNewWebViewReturned = "CREATE_NEW_WEBVIEW_RETURNED"
+    case signOutInit = "SIGN_OUT_INIT"
+    case signOutReturned = "SIGN_OUT_RETURNED"
+    case closeInit = "CLOSE_INIT"
+    case closeReturned = "CLOSE_RETURNED"
+    case closeWebViewInit = "CLOSE_WEBVIEW_INIT"
+    case closeWebViewReturned = "CLOSE_WEBVIEW_RETURNED"
+    case checkSessionClosed = "CHECK_SESSION_CLOSED"
+    case userContentControllerReturned = "USER_CONTENT_CONTROLLER_RETURNED"
+}

package/ios/hyperswitchSDK/Shared/PaymentMethodType.swift

@@ -0,0 +1,15 @@
+//
+//  PaymentRequestData.swift
+//  hyperswitch
+//
+//  Created by Harshit Srivastava on 18/05/26.
+//
+
+public struct PaymentRequestData: Codable {
+    public var paymentMethodType: PaymentMethodType
+}
+
+public enum PaymentMethodType: String, Codable {
+    case applePay = "apple_pay"
+    case payPal = "paypal"
+}

package/ios/hyperswitchSDK/Shared/PaymentSession.swift

@@ -0,0 +1,98 @@
+//
+//  PaymentSession.swift
+//  Hyperswitch
+//
+//  Created by Harshit Srivastava on 07/03/24.
+//
+
+import Combine
+import Foundation
+
+@frozen public enum PaymentResult {
+    case completed(data: String)
+    case canceled(data: String)
+    case failed(error: Error)
+}
+
+public enum UpdateIntentResult {
+    case success
+    case cancelled
+    case failure(Error)
+}
+
+public class PaymentSession {
+
+    internal var paymentSessionConfiguration: PaymentSessionConfiguration
+    internal var hyperswitchConfiguration: HyperswitchConfiguration?
+
+    internal let updateIntentDidStart = PassthroughSubject<Void, Never>()
+    internal let updateIntentDidComplete = PassthroughSubject<String, Never>()
+    internal let updateIntentInitReturned = PassthroughSubject<String, Never>()
+    internal let updateIntentCompleteReturned = PassthroughSubject<String, Never>()
+    private var cancellables = Set<AnyCancellable>()
+
+    internal init(paymentSessionConfiguration: PaymentSessionConfiguration, hyperswitchConfiguration: HyperswitchConfiguration? = nil) {
+        self.paymentSessionConfiguration = paymentSessionConfiguration
+        self.hyperswitchConfiguration = hyperswitchConfiguration
+
+        if let hyperswitchConfiguration = hyperswitchConfiguration {
+            #if canImport(HyperOTA)
+            OTAServices.shared.initialize(publishableKey: hyperswitchConfiguration.publishableKey)
+            LogManager.initialize(publishableKey: hyperswitchConfiguration.publishableKey)
+            #endif
+        }
+    }
+
+    public func updateIntent(
+        authorizationProvider: @escaping (@escaping (String) -> Void) -> Void,
+        completion: @escaping (UpdateIntentResult) -> Void
+    ) {
+        //        updateIntentInitReturned
+        //            .first()
+        //            .receive(on: DispatchQueue.main)
+        //            .sink { [weak self] _ in
+        //                guard let self = self else { return }
+        //                authorizationProvider { [weak self] sdkAuthorization in
+        //                    guard let self = self else { return }
+        //                    self.updateIntentCompleteReturned
+        //                        .first()
+        //                        .receive(on: DispatchQueue.main)
+        //                        .sink { result in
+        //                            completion(self.parseUpdateIntentResult(result))
+        //                        }
+        //                        .store(in: &self.cancellables)
+        //                    self.sdkAuthorization = sdkAuthorization
+        //                    self.updateIntentDidComplete.send(sdkAuthorization)
+        //                }
+        //            }
+        //            .store(in: &cancellables)
+        //        updateIntentDidStart.send(())
+
+        // MARK: workaround
+        authorizationProvider { [weak self] sdkAuthorization in
+            self?.paymentSessionConfiguration = PaymentSessionConfiguration(sdkAuthorization: sdkAuthorization)
+            completion(UpdateIntentResult.success)
+        }
+    }
+
+    private func parseUpdateIntentResult(_ data: String) -> UpdateIntentResult {
+        guard
+            let bytes = data.data(using: .utf8),
+            let json = (try? JSONSerialization.jsonObject(with: bytes)) as? [String: String]
+        else {
+            return .failure(
+                NSError(domain: "UNKNOWN_ERROR", code: 0, userInfo: [NSLocalizedDescriptionKey: "Invalid update intent result"])
+            )
+        }
+        switch json["status"] {
+        case "cancelled":
+            return .cancelled
+        case "failed", "error":
+            let code = json["code"].flatMap { $0.isEmpty ? nil : $0 } ?? "UNKNOWN_ERROR"
+            let message = json["message"].flatMap { $0.isEmpty ? nil : $0 } ?? (json["status"] ?? "failed")
+            return .failure(NSError(domain: code, code: 0, userInfo: [NSLocalizedDescriptionKey: message]))
+        default:
+            return .success
+        }
+    }
+}

package/ios/hyperswitchSDK/Shared/PaymentSessionConfiguration.swift

@@ -0,0 +1,14 @@
+//
+//  PaymentSessionConfiguration.swift
+//  HyperswitchCore
+//
+//  Created by Harshit Srivastava on 17/05/26.
+//
+
+public struct PaymentSessionConfiguration: Codable {
+    public let sdkAuthorization: String
+
+    public init(sdkAuthorization: String) {
+        self.sdkAuthorization = sdkAuthorization
+    }
+}

package/ios/hyperswitchSDK/Shared/PaymentSheet.swift

@@ -0,0 +1,33 @@
+//
+//  PaymentSheet.swift
+//  Hyperswitch
+//
+//  Created by Balaganesh on 09/12/22.
+//
+
+import Foundation
+
+/// PaymentSheet is a class that handles the presentation and management of a payment sheet interface.
+public class PaymentSheet {
+
+    /// The initializer method that sets up the payment sheet with the required parameters.
+    internal required init(
+        paymentSessionConfiguration: PaymentSessionConfiguration,
+        hyperswitchConfiguration: HyperswitchConfiguration? = nil,
+        configuration: Configuration? = nil
+    ) {
+        self.paymentSessionConfiguration = paymentSessionConfiguration
+        self.hyperswitchConfiguration = hyperswitchConfiguration
+        self.configuration = configuration
+    }
+
+    internal let paymentSessionConfiguration: PaymentSessionConfiguration
+    internal var hyperswitchConfiguration: HyperswitchConfiguration?
+
+    /// The configuration object that holds the settings for the payment sheet.
+    internal let configuration: Configuration?
+    internal var completion: ((PaymentResult) -> Void)?
+    internal var subscribedEvents: [String]?
+    internal var paymentEventListener: PaymentEventListener?
+    internal var shouldProceedWithPaymentCallback: ((PaymentRequestData, @escaping (Bool) -> Void) -> Void)?
+}

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

@@ -0,0 +1,182 @@
+//
+//  PaymentSheetAppearance+Codable.swift
+//  hyperswitch
+//
+//  Created by Harshit Srivastava on 09/10/25.
+//
+
+// MARK: - Codable Conformance
+import UIKit
+
+extension PaymentSheet.Appearance.Colors: Codable {
+    enum CodingKeys: String, CodingKey {
+        case primary, background, componentBackground, componentBorder
+        case componentDivider, text, textSecondary, componentText
+        case componentPlaceholderText, icon, danger
+        case loaderBackground, loaderForeground
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var c = encoder.container(keyedBy: CodingKeys.self)
+        try c.encodeIfPresent(primary.map { CodableColor($0) }, forKey: .primary)
+        try c.encodeIfPresent(background.map { CodableColor($0) }, forKey: .background)
+        try c.encodeIfPresent(componentBackground.map { CodableColor($0) }, forKey: .componentBackground)
+        try c.encodeIfPresent(componentBorder.map { CodableColor($0) }, forKey: .componentBorder)
+        try c.encodeIfPresent(componentDivider.map { CodableColor($0) }, forKey: .componentDivider)
+        try c.encodeIfPresent(text.map { CodableColor($0) }, forKey: .text)
+        try c.encodeIfPresent(textSecondary.map { CodableColor($0) }, forKey: .textSecondary)
+        try c.encodeIfPresent(componentText.map { CodableColor($0) }, forKey: .componentText)
+        try c.encodeIfPresent(componentPlaceholderText.map { CodableColor($0) }, forKey: .componentPlaceholderText)
+        try c.encodeIfPresent(icon.map { CodableColor($0) }, forKey: .icon)
+        try c.encodeIfPresent(danger.map { CodableColor($0) }, forKey: .danger)
+        try c.encodeIfPresent(loaderBackground.map { CodableColor($0) }, forKey: .loaderBackground)
+        try c.encodeIfPresent(loaderForeground.map { CodableColor($0) }, forKey: .loaderForeground)
+    }
+
+    public init(from decoder: Decoder) throws {
+        self.init()
+        let c = try decoder.container(keyedBy: CodingKeys.self)
+        primary = try c.decodeIfPresent(CodableColor.self, forKey: .primary)?.uiColor
+        background = try c.decodeIfPresent(CodableColor.self, forKey: .background)?.uiColor
+        componentBackground = try c.decodeIfPresent(CodableColor.self, forKey: .componentBackground)?.uiColor
+        componentBorder = try c.decodeIfPresent(CodableColor.self, forKey: .componentBorder)?.uiColor
+        componentDivider = try c.decodeIfPresent(CodableColor.self, forKey: .componentDivider)?.uiColor
+        text = try c.decodeIfPresent(CodableColor.self, forKey: .text)?.uiColor
+        textSecondary = try c.decodeIfPresent(CodableColor.self, forKey: .textSecondary)?.uiColor
+        componentText = try c.decodeIfPresent(CodableColor.self, forKey: .componentText)?.uiColor
+        componentPlaceholderText = try c.decodeIfPresent(CodableColor.self, forKey: .componentPlaceholderText)?.uiColor
+        icon = try c.decodeIfPresent(CodableColor.self, forKey: .icon)?.uiColor
+        danger = try c.decodeIfPresent(CodableColor.self, forKey: .danger)?.uiColor
+        loaderBackground = try c.decodeIfPresent(CodableColor.self, forKey: .loaderBackground)?.uiColor
+        loaderForeground = try c.decodeIfPresent(CodableColor.self, forKey: .loaderForeground)?.uiColor
+    }
+}
+
+extension PaymentSheet.Appearance.Font: Codable {
+    enum CodingKeys: String, CodingKey {
+        case sizeScaleFactor, base, headingTextSizeAdjust, subHeadingTextSizeAdjust
+        case placeholderTextSizeAdjust, buttonTextSizeAdjust, errorTextSizeAdjust
+        case linkTextSizeAdjust, modalTextSizeAdjust, cardTextSizeAdjust, family
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var c = encoder.container(keyedBy: CodingKeys.self)
+        try c.encodeIfPresent(sizeScaleFactor, forKey: .sizeScaleFactor)
+        try c.encodeIfPresent(base.map { CodableFont($0) }, forKey: .base)
+        try c.encodeIfPresent(headingTextSizeAdjust, forKey: .headingTextSizeAdjust)
+        try c.encodeIfPresent(subHeadingTextSizeAdjust, forKey: .subHeadingTextSizeAdjust)
+        try c.encodeIfPresent(placeholderTextSizeAdjust, forKey: .placeholderTextSizeAdjust)
+        try c.encodeIfPresent(buttonTextSizeAdjust, forKey: .buttonTextSizeAdjust)
+        try c.encodeIfPresent(errorTextSizeAdjust, forKey: .errorTextSizeAdjust)
+        try c.encodeIfPresent(linkTextSizeAdjust, forKey: .linkTextSizeAdjust)
+        try c.encodeIfPresent(modalTextSizeAdjust, forKey: .modalTextSizeAdjust)
+        try c.encodeIfPresent(cardTextSizeAdjust, forKey: .cardTextSizeAdjust)
+        try c.encodeIfPresent(family, forKey: .family)
+    }
+
+    public init(from decoder: Decoder) throws {
+        self.init()
+        let c = try decoder.container(keyedBy: CodingKeys.self)
+        sizeScaleFactor = try c.decodeIfPresent(CGFloat.self, forKey: .sizeScaleFactor)
+        base = try c.decodeIfPresent(CodableFont.self, forKey: .base)?.uiFont
+        headingTextSizeAdjust = try c.decodeIfPresent(CGFloat.self, forKey: .headingTextSizeAdjust)
+        subHeadingTextSizeAdjust = try c.decodeIfPresent(CGFloat.self, forKey: .subHeadingTextSizeAdjust)
+        placeholderTextSizeAdjust = try c.decodeIfPresent(CGFloat.self, forKey: .placeholderTextSizeAdjust)
+        buttonTextSizeAdjust = try c.decodeIfPresent(CGFloat.self, forKey: .buttonTextSizeAdjust)
+        errorTextSizeAdjust = try c.decodeIfPresent(CGFloat.self, forKey: .errorTextSizeAdjust)
+        linkTextSizeAdjust = try c.decodeIfPresent(CGFloat.self, forKey: .linkTextSizeAdjust)
+        modalTextSizeAdjust = try c.decodeIfPresent(CGFloat.self, forKey: .modalTextSizeAdjust)
+        cardTextSizeAdjust = try c.decodeIfPresent(CGFloat.self, forKey: .cardTextSizeAdjust)
+        family = try c.decodeIfPresent(String.self, forKey: .family)
+    }
+}
+
+extension PaymentSheet.Appearance.PrimaryButton: Codable {
+    enum CodingKeys: String, CodingKey {
+        case backgroundColor, textColor, successBackgroundColor, successTextColor
+        case cornerRadius, borderColor, borderWidth, font, shadow, height
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var c = encoder.container(keyedBy: CodingKeys.self)
+        try c.encodeIfPresent(backgroundColor.map { CodableColor($0) }, forKey: .backgroundColor)
+        try c.encodeIfPresent(textColor.map { CodableColor($0) }, forKey: .textColor)
+        try c.encodeIfPresent(successBackgroundColor.map { CodableColor($0) }, forKey: .successBackgroundColor)
+        try c.encodeIfPresent(successTextColor.map { CodableColor($0) }, forKey: .successTextColor)
+        try c.encodeIfPresent(cornerRadius, forKey: .cornerRadius)
+        try c.encodeIfPresent(borderColor.map { CodableColor($0) }, forKey: .borderColor)
+        try c.encodeIfPresent(borderWidth, forKey: .borderWidth)
+        try c.encodeIfPresent(font.map { CodableFont($0) }, forKey: .font)
+        try c.encodeIfPresent(shadow, forKey: .shadow)
+        try c.encodeIfPresent(height, forKey: .height)
+    }
+
+    public init(from decoder: Decoder) throws {
+        self.init()
+        let c = try decoder.container(keyedBy: CodingKeys.self)
+        backgroundColor = try c.decodeIfPresent(CodableColor.self, forKey: .backgroundColor)?.uiColor
+        textColor = try c.decodeIfPresent(CodableColor.self, forKey: .textColor)?.uiColor
+        successBackgroundColor = try c.decodeIfPresent(CodableColor.self, forKey: .successBackgroundColor)?.uiColor
+        successTextColor = try c.decodeIfPresent(CodableColor.self, forKey: .successTextColor)?.uiColor
+        cornerRadius = try c.decodeIfPresent(CGFloat.self, forKey: .cornerRadius)
+        borderColor = try c.decodeIfPresent(CodableColor.self, forKey: .borderColor)?.uiColor
+        borderWidth = try c.decodeIfPresent(CGFloat.self, forKey: .borderWidth)
+        font = try c.decodeIfPresent(CodableFont.self, forKey: .font)?.uiFont
+        shadow = try c.decodeIfPresent(PaymentSheet.Appearance.Shadow.self, forKey: .shadow)
+        height = try c.decodeIfPresent(CGFloat.self, forKey: .height)
+    }
+}
+
+extension PaymentSheet.Appearance.Shadow: Codable {
+    enum CodingKeys: String, CodingKey {
+        case color, opacity, offset, radius, intensity
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var c = encoder.container(keyedBy: CodingKeys.self)
+        try c.encodeIfPresent(color.map { CodableColor($0) }, forKey: .color)
+        try c.encodeIfPresent(opacity, forKey: .opacity)
+        try c.encodeIfPresent(offset, forKey: .offset)
+        try c.encodeIfPresent(radius, forKey: .radius)
+        try c.encodeIfPresent(intensity, forKey: .intensity)
+    }
+
+    public init(from decoder: Decoder) throws {
+        self.init()
+        let c = try decoder.container(keyedBy: CodingKeys.self)
+        color = try c.decodeIfPresent(CodableColor.self, forKey: .color)?.uiColor
+        opacity = try c.decodeIfPresent(CGFloat.self, forKey: .opacity)
+        offset = try c.decodeIfPresent(CGSize.self, forKey: .offset)
+        radius = try c.decodeIfPresent(CGFloat.self, forKey: .radius)
+        intensity = try c.decodeIfPresent(CGFloat.self, forKey: .intensity)
+    }
+}
+
+extension PaymentSheet.Appearance: Codable {
+    enum CodingKeys: String, CodingKey {
+        case font, colors, primaryButton, cornerRadius, borderWidth, shadow, theme
+    }
+
+    public func encode(to encoder: Encoder) throws {
+        var c = encoder.container(keyedBy: CodingKeys.self)
+        try c.encodeIfPresent(font, forKey: .font)
+        try c.encodeIfPresent(colors, forKey: .colors)
+        try c.encodeIfPresent(primaryButton, forKey: .primaryButton)
+        try c.encodeIfPresent(cornerRadius, forKey: .cornerRadius)
+        try c.encodeIfPresent(borderWidth, forKey: .borderWidth)
+        try c.encodeIfPresent(shadow, forKey: .shadow)
+        try c.encodeIfPresent(theme, forKey: .theme)
+    }
+
+    public init(from decoder: Decoder) throws {
+        self.init()
+        let c = try decoder.container(keyedBy: CodingKeys.self)
+        font = try c.decodeIfPresent(PaymentSheet.Appearance.Font.self, forKey: .font) ?? Font()
+        colors = try c.decodeIfPresent(PaymentSheet.Appearance.Colors.self, forKey: .colors) ?? Colors()
+        primaryButton = try c.decodeIfPresent(PaymentSheet.Appearance.PrimaryButton.self, forKey: .primaryButton) ?? PrimaryButton()
+        cornerRadius = try c.decodeIfPresent(CGFloat.self, forKey: .cornerRadius)
+        borderWidth = try c.decodeIfPresent(CGFloat.self, forKey: .borderWidth)
+        shadow = try c.decodeIfPresent(PaymentSheet.Appearance.Shadow.self, forKey: .shadow)
+        theme = try c.decodeIfPresent(PaymentSheet.Appearance.Theme.self, forKey: .theme)
+    }
+}

package/ios/hyperswitchSDK/Shared/PaymentSheetAppearance.swift

@@ -0,0 +1,238 @@
+//
+//  PaymentSheetApperance.swift
+//  Hyperswitch
+//
+//  Created by Harshit Srivastava on 09/11/23.
+//
+
+import UIKit
+
+public extension PaymentSheet {
+
+    /// Describes the appearance of PaymentSheet
+    struct Appearance {
+
+        /// Creates a `PaymentSheet.Appearance` with default values
+        public init() {}
+
+        /// Describes the appearance of fonts in PaymentSheet
+        public var font: Font = Font()
+
+        /// Describes the colors in PaymentSheet
+        public var colors: Colors = Colors()
+
+        /// Describes the appearance of the primary button (e.g., the "Pay" button)
+        public var primaryButton: PrimaryButton = PrimaryButton()
+
+        /// The corner radius used for buttons, inputs, tabs in PaymentSheet
+        /// - Note: The behavior of this property is consistent with the behavior of corner radius on `CALayer`
+        public var cornerRadius: CGFloat?
+
+        /// The border used for inputs and tabs in PaymentSheet
+        /// - Note: The behavior of this property is consistent with the behavior of border width on `CALayer`
+        public var borderWidth: CGFloat?
+
+        /// The shadow used for inputs and tabs in PaymentSheet
+        /// - Note: Set this to `.disabled` to disable shadows
+        public var shadow: Shadow?
+
+        public var theme: Theme?
+
+        public enum Theme: String, Codable {
+            case `default` = "Default"
+            case light = "Light"
+            case dark = "Dark"
+            case minimal = "Minimal"
+            case flatMinimal = "FlatMinimal"
+
+            var themeLabel: String {
+                return self.rawValue
+            }
+        }
+
+        // MARK: Fonts
+
+        /// Describes the appearance of fonts in PaymentSheet
+        public struct Font {
+
+            /// Creates a `PaymentSheet.Appearance.Font` with default values
+            public init() {}
+
+            /// The scale factor for all font sizes in PaymentSheet.
+            /// Font sizes are multiplied by this value before being displayed. For example, setting this to 1.2 increases the size of all text by 20%.
+            /// - Note: This value must be greater than 0. The default value is 1.0.
+            /// - Note: This is used in conjunction with the Dynamic Type accessibility text size.
+            public var sizeScaleFactor: CGFloat?
+
+            /// The font family of this font is used throughout PaymentSheet. PaymentSheet uses this font at multiple weights (e.g., regular, medium, semibold) if they exist.
+            /// - Note: The size and weight of the font is ignored. To adjust font sizes, see `sizeScaleFactor`.
+            public var base: UIFont?
+
+            /// The size adjustment for all heading texts in PaymentSheet
+            /// Font sizes of all headings will be increased by this value from their respective default size
+            public var headingTextSizeAdjust: CGFloat?
+
+            /// The size for all sub heading texts in PaymentSheet
+            /// Font sizes of all sub headings will be increased by this value from their respective default size
+            public var subHeadingTextSizeAdjust: CGFloat?
+
+            /// The size for all placeholder texts in PaymentSheet
+            /// Font sizes of all placeholder texts will be increased by this value from their respective default size
+            public var placeholderTextSizeAdjust: CGFloat?
+
+            /// The size for all button texts in PaymentSheet
+            /// Font sizes of all button texts will be increased by this value from their respective default size
+            public var buttonTextSizeAdjust: CGFloat?
+
+            /// The size for all error texts in PaymentSheet
+            /// Font sizes of all error texts will be increased by this value from their respective default size
+            public var errorTextSizeAdjust: CGFloat?
+
+            /// The size for all link texts in PaymentSheet
+            /// Font sizes of all link texts will be increased by this value from their respective default size
+            public var linkTextSizeAdjust: CGFloat?
+
+            /// The size for all modal texts in PaymentSheet
+            /// Font sizes of all modal texts will be increased by this value from their respective default size
+            public var modalTextSizeAdjust: CGFloat?
+
+            /// The size for all card texts in PaymentSheet
+            /// Font sizes of all card texts will be increased by this value from their respective default size
+            public var cardTextSizeAdjust: CGFloat?
+
+            /// the font Attributes for PaymentSheetLite
+            public var family: String?
+        }
+
+        // MARK: Colors
+
+        /// Describes the colors in PaymentSheet
+        public struct Colors {
+
+            /// Creates a `PaymentSheet.Appearance.Colors` with default values
+            public init() {}
+
+            /// The primary color used throughout PaymentSheet
+            public var primary: UIColor?
+
+            /// The color used for the background of PaymentSheet
+            public var background: UIColor?
+
+            /// The color used for the background of inputs, tabs, and other components
+            public var componentBackground: UIColor?
+
+            /// The border color used for inputs, tabs, and other components
+            public var componentBorder: UIColor?
+
+            /// The color of the divider lines used inside inputs, tabs, and other components
+            public var componentDivider: UIColor?
+
+            /// The default text color used in PaymentSheet, appearing over the background color
+            public var text: UIColor?
+
+            /// The color used for text of secondary importance. For example, this color is used for the label above input fields
+            public var textSecondary: UIColor?
+
+            /// The color of text appearing over `componentBackground`
+            public var componentText: UIColor?
+
+            /// The color used for input placeholder text
+            public var componentPlaceholderText: UIColor?
+
+            /// The color used for icons in PaymentSheet, such as the close or back icons
+            public var icon: UIColor?
+
+            /// The color used to indicate errors or destructive actions in PaymentSheet
+            public var danger: UIColor?
+
+            /// The color used to indicate Loader Background Color
+            public var loaderBackground: UIColor?
+
+            /// The color used to indicate Loader Foreground Color
+            public var loaderForeground: UIColor?
+        }
+
+        // MARK: Shadow
+
+        /// Represents a shadow in PaymentSheet
+        public struct Shadow {
+
+            /// Creates a `PaymentSheet.Appearance.Shadow` with default values
+            public init() {}
+
+            /// A pre-configured `Shadow` in the disabled or off state
+            public static var disabled: Shadow?
+
+            /// Color of the shadow
+            /// - Note: The behavior of this property is consistent with `CALayer.shadowColor`
+            public var color: UIColor?
+
+            /// Opacity or alpha of the shadow
+            /// - Note: The behavior of this property is consistent with `CALayer.shadowOpacity`
+            public var opacity: CGFloat?
+
+            /// Offset of the shadow
+            /// - Note: The behavior of this property is consistent with `CALayer.shadowOffset`
+            public var offset: CGSize?
+
+            /// Radius of the shadow
+            /// - Note: The behavior of this property is consistent with `CALayer.shadowRadius`
+            public var radius: CGFloat?
+
+            /// intensity of the shadow
+            /// - Note: The behavior of this property is consistent with `CALayer.shadowIntensity`
+            public var intensity: CGFloat?
+        }
+
+        // MARK: Primary Button
+
+        /// Describes the appearance of the primary button (e.g., the "Pay" button)
+        public struct PrimaryButton {
+
+            /// Creates a `PaymentSheet.Appearance.PrimaryButton` with default values
+            public init() {}
+
+            /// The background color of the primary button
+            /// - Note: If `nil`, `appearance.colors.primary` will be used as the primary button background color
+            public var backgroundColor: UIColor?
+
+            /// The text color of the primary button
+            /// - Note: If `nil`, defaults to either white or black depending on the color of the button
+            public var textColor: UIColor?
+
+            /// The background color of the primary button when in a success state.
+            /// - Note: Only applies to PaymentSheet. The primary button transitions to the success state when payment succeeds.
+            public var successBackgroundColor: UIColor?
+
+            /// The text color of the primary button when in a success state.
+            /// - Note: Only applies to PaymentSheet. The primary button transitions to the success state when payment succeeds.
+            /// - Note: If `nil`, defaults to `textColor`
+            public var successTextColor: UIColor?
+
+            /// The corner radius of the primary button
+            /// - Note: If `nil`, `appearance.cornerRadius` will be used as the primary button corner radius
+            /// - Note: The behavior of this property is consistent with the behavior of corner radius on `CALayer`
+            public var cornerRadius: CGFloat?
+
+            /// The border color of the primary button
+            /// - Note: The behavior of this property is consistent with the behavior of border color on `CALayer`
+            public var borderColor: UIColor?
+
+            /// The border width of the primary button
+            /// - Note: The behavior of this property is consistent with the behavior of border width on `CALayer`
+            public var borderWidth: CGFloat?
+
+            /// The font used for the text of the primary button
+            /// - Note: If `nil`, `appearance.font.base` will be used as the primary button font
+            /// - Note: `appearance.font.sizeScaleFactor` does not impact the size of this font
+            public var font: UIFont?
+
+            /// The shadow of the primary button
+            /// - Note: If `nil`, `appearance.shadow` will be used as the primary button shadow
+            public var shadow: Shadow?
+
+            /// The height of the primary button in points
+            public var height: CGFloat?
+        }
+    }
+}