Setup & Configuration

import SuggestKit
import SwiftUI

@main
struct MyApp: App {
    init() {
        // Configure SuggestKit with your public API key
        SuggestKit.configure(
            apiKey: "your_public_api_key_here",
            environment: .production // or .sandbox for testing
        )
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

SuggestKit.configure(
    apiKey: "public_your_production_key",
    environment: .production
)

SuggestKit.configure(
    apiKey: "public_your_sandbox_key", 
    environment: .sandbox,
    debugMode: true // Enable detailed logging
)

SuggestKit.configure(
    apiKey: "your_public_api_key",
    environment: .production,
    options: SuggestKitOptions(
        // Network settings
        requestTimeout: 30.0,
        maxRetries: 3,
        
        // Caching
        enableOfflineCache: true,
        maxCacheSize: 50, // suggestions
        
        // UI defaults
        defaultTheme: .system,
        enableHaptics: true,
        
        // Analytics
        enableAnalytics: true,
        
        // Debug
        debugMode: false
    )
)

import SuggestKit

// Basic user setup
SuggestKit.setUser(
    id: "user_12345",
    email: "user@example.com"
)

// Advanced user setup
SuggestKit.setUser(
    id: "user_12345",
    email: "user@example.com",
    customId: "my_internal_user_id",
    monthlyRevenue: 19.99,
    country: "US",
    platform: .ios,
    locale: "en_US",
    metadata: [
        "plan": "pro",
        "signup_date": "2024-01-15"
    ]
)

// On logout
SuggestKit.clearUser()

#if DEBUG
SuggestKit.configure(
    apiKey: "your_api_key",
    environment: .sandbox,
    debugMode: true
)

// This will log configuration status
SuggestKit.validateConfiguration()
#endif

do {
    try SuggestKit.configure(
        apiKey: "your_api_key",
        environment: .production
    )
} catch SuggestKitError.invalidAPIKey {
    print("Invalid API key provided")
} catch SuggestKitError.networkError(let details) {
    print("Network configuration error: \(details)")
} catch {
    print("Configuration error: \(error)")
}