GrowthCat iOS Referral Redemption SDK

https://github.com/lapreamarcelo/GrowthCatSDK-ios.git

import GrowthCat

public enum GrowthCatEnvironmentMode: Sendable {
    case automatic
    case production
}

public static func initialize(
    apiKey: String,
    environmentMode: GrowthCatEnvironmentMode = .automatic,
    logsEnabled: Bool = false
)

import SwiftUI
import GrowthCat

@main
struct DemoApp: App {
    init() {
        GrowthCat.initialize(
            apiKey: "gc_live_123456",
            environmentMode: .automatic,
            logsEnabled: true
        )
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

GrowthCat.initialize(
    apiKey: "gc_live_123456",
    environmentMode: .production,
    logsEnabled: true
)

if let sdkConfig = GrowthCat.shared.sdkConfig {
    if sdkConfig.showCodeRedeemUI {
        // Show your GrowthCat entry point.
    }

    if sdkConfig.allowCodeRedeemExecution {
        // Let the user start the redeem flow.
    }
}

if let readiness = GrowthCat.shared.sdkReadiness {
    print("Can validate codes: \(readiness.canValidateCodes)")
}

Task {
    do {
        let sdkConfig = try await GrowthCat.shared.refreshSDKConfig()
        print("Latest SDK config: \(sdkConfig)")
    } catch {
        print("Failed to refresh SDK config: \(error)")
    }
}

let theme = GrowthCatTheme(
    primaryColor: .orange,
    backgroundColor: Color(.systemGroupedBackground),
    textColor: .primary,
    fontName: "AvenirNext-DemiBold",
    cornerRadius: 14
)

let strings = GrowthCatStrings(
    title: "Have a Promo Code?",
    description: "Enter your influencer code to unlock your offer.",
    howItWorksTitle: "How it works",
    howItWorksStepValidate: "1. We validate your code instantly.",
    howItWorksStepCopy: "2. If valid, we copy it for you.",
    howItWorksStepApple: "3. Apple redemption opens so you can paste and continue.",
    placeholder: "Enter code",
    buttonText: "Apply Discount",
    successMessage: "Code validated. Opening Apple redemption...",
    invalidCodeMessage: "That code does not exist. Please try again.",
    networkErrorMessage: "Network error. Please try again."
)

GrowthCatReferralView(theme: theme, strings: strings, verificationEntitlementID: "pro")

import SwiftUI
import GrowthCat

struct PaywallHeader: View {
    @State private var showReferralSheet = false

    var body: some View {
        GrowthCatBannerView(
            theme: GrowthCatBannerTheme(
                backgroundColor: Color(red: 0.93, green: 0.97, blue: 1.0),
                accentColor: .blue
            ),
            strings: GrowthCatBannerStrings(
                title: String(localized: "growthcat.banner.title"),
                subtitle: String(localized: "growthcat.banner.subtitle"),
                callToActionText: String(localized: "growthcat.banner.cta")
            ),
            configuration: GrowthCatBannerConfiguration(
                style: .soft,
                size: .regular,
                interaction: .fullBanner,
                cornerRadius: 16,
                iconSystemName: "gift.fill"
            )
        )
        .growthCatOnTap {
            showReferralSheet = true
        }
        .sheet(isPresented: $showReferralSheet) {
            GrowthCatReferralView(verificationEntitlementID: "pro")
        }
    }
}

let growthCatStrings = GrowthCatStrings(
    title: String(localized: "growthcat.title"),
    description: String(localized: "growthcat.description"),
    howItWorksTitle: String(localized: "growthcat.how_it_works_title"),
    howItWorksStepValidate: String(localized: "growthcat.how_it_works_validate"),
    howItWorksStepCopy: String(localized: "growthcat.how_it_works_copy"),
    howItWorksStepApple: String(localized: "growthcat.how_it_works_apple"),
    placeholder: String(localized: "growthcat.placeholder"),
    buttonText: String(localized: "growthcat.button_text"),
    successMessage: String(localized: "growthcat.success_message"),
    invalidCodeMessage: String(localized: "growthcat.invalid_code"),
    networkErrorMessage: String(localized: "growthcat.network_error")
)

GrowthCatReferralView(strings: growthCatStrings, verificationEntitlementID: "pro")

- notInitialized
- invalidCode(message:)
- unauthorized(message:)
- rateLimited(retryAfter:)
- network(message:)
- server(statusCode:message:)
- revenueCatUnavailable(message:)
- unknown(message:)

public enum GrowthCat {
    public static func initialize(
        apiKey: String,
        environmentMode: GrowthCatEnvironmentMode = .automatic,
        logsEnabled: Bool = false
    )
    public static var shared: GrowthCatClient { get }
}

public protocol GrowthCatRedeeming {
    var sdkConfig: SDKConfig? { get }
    var sdkReadiness: SDKReadiness? { get }
    func redeemReferralCode(_ code: String) async throws -> ReferralRedemptionResult
    func validateReferralCode(_ code: String) async throws -> ReferralRedemptionResult
    func refreshSDKConfig() async throws -> SDKConfig
    func openAppleRedemptionSheet() async throws
    func verifyAppleRedemption(entitlementID: String, timeout: TimeInterval) async -> Bool
}

@MainActor
public final class GrowthCatRedeemer: ObservableObject {
    @Published public private(set) var isLoading: Bool
    @Published public private(set) var lastResult: ReferralRedemptionResult?
    @Published public private(set) var lastError: GrowthCatError?
    public func redeem(_ code: String) async -> Result<ReferralRedemptionResult, GrowthCatError>
}