GrowthCat iOS SDK

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

import GrowthCat

public enum GrowthCatEnvironmentMode: Sendable {
    case automatic
    case production
}

public static func initialize(
    apiKey: String,
    environmentMode: GrowthCatEnvironmentMode = .automatic,
    logsEnabled: Bool = false,
    baseURL: URL? = nil,
    measurementMode: GrowthCatMeasurementMode
)

import SwiftUI
import GrowthCat

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

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

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

GrowthCat.setMeasurementMode(.analytics)

// Revocation clears optional queued events and rotates the analytics session.
GrowthCat.setMeasurementMode(.essential)

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 sessionID = GrowthCat.makeSessionID()
let context = GrowthCatAnalyticsContext(sessionID: sessionID, source: "creator_profile")

// 1. User saw the code link
try await GrowthCat.shared.recordReferralClick("MARCO20", context: context)

// 2. User typed and validated the code
let result = try await GrowthCat.shared.validateReferralCode("MARCO20", context: context)

// 3. User reached the paywall
try await GrowthCat.shared.recordAnalyticsEvent(
    .paywallViewed,
    code: result.normalizedCode,
    context: context,
    properties: ["paywall_variant": .string("annual_default")]
)

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")

public enum GrowthCatError: Error {
    case notInitialized
    case invalidCode(message: String?)
    case appSetupIncomplete(message: String?, requirements: AppSetupRequirements)
    case unauthorized(message: String?)
    case rateLimited(retryAfter: TimeInterval?)
    case network(message: String?)
    case server(statusCode: Int, message: String?)
    case revenueCatUnavailable(message: String?)
    case unknown(message: String?)
}

// ─── Initialization ──────────────────────────────────────────────────────────

public enum GrowthCat {
    public static func initialize(
        apiKey: String,
        environmentMode: GrowthCatEnvironmentMode = .automatic,
        logsEnabled: Bool = false,
        baseURL: URL? = nil,
        measurementMode: GrowthCatMeasurementMode
    )
    public static var shared: GrowthCatClient { get }
    public static func makeSessionID() -> String
    public static func setMeasurementMode(_ mode: GrowthCatMeasurementMode)
}

// ─── GrowthCatClient ─────────────────────────────────────────────────────────

public struct GrowthCatClient {
    // Config
    public var sdkConfig: GrowthCatSDKConfig? { get }
    public var sdkBootstrap: GrowthCatSDKBootstrap? { get }
    public var sdkReadiness: GrowthCatSDKReadiness? { get }
    public func refreshSDKConfig() async throws -> GrowthCatSDKConfig

    // Code redemption
    public func redeemReferralCode(_ code: String) async throws -> ReferralRedemptionResult
    public func validateReferralCode(_ code: String) async throws -> ReferralRedemptionResult
    public func openAppleRedemptionSheet() async throws
    public func verifyAppleRedemption(entitlementID: String, timeout: TimeInterval) async -> Bool

    // Analytics
    public func recordReferralClick(_ code: String, context: GrowthCatAnalyticsContext) async throws
    public func recordAnalyticsEvent(
        _ eventName: GrowthCatAnalyticsEventName,
        code: String?,
        eventAt: Date?,
        context: GrowthCatAnalyticsContext,
        properties: [String: GrowthCatAnalyticsValue]?
    ) async throws
}

// ─── GrowthCatRedeemer ───────────────────────────────────────────────────────

@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
}