Feature Flags

let flags = try await grantiva.flags.getFlags()

if flags["dark_mode"]?.boolValue == true {
    enableDarkMode()
}

// Boolean (default: false)
let enabled = try await grantiva.flags.boolValue(for: "dark_mode", default: false)

// String (default: "")
let theme = try await grantiva.flags.stringValue(for: "theme", default: "light")

// Integer (default: 0)
let limit = try await grantiva.flags.intValue(for: "upload_limit", default: 10)

// Double (default: 0.0)
let threshold = try await grantiva.flags.doubleValue(for: "risk_threshold", default: 0.5)

if let value = try await grantiva.flags.value(for: "feature_x") {
    print(value.rawValue)       // Raw string from server
    print(value.valueType)      // FlagValueType: boolean, integer, double, string, json
    print(value.boolValue)      // Bool?
    print(value.intValue)       // Int?
    print(value.stringValue)    // String (always succeeds)
    print(value.jsonValue)      // Any? (parsed JSON)
}

grantiva.flags.environment = .staging  // .development, .staging, .production
let flags = try await grantiva.flags.getFlags(forceRefresh: true)

// 30-second TTL — fast propagation for kill-switches
grantiva.flags.cacheTTL = 30

// Disable caching entirely — always fetch fresh values
grantiva.flags.cacheTTL = 0

// Force refresh on next fetch
await grantiva.flags.refresh()

// Clear all cached flag data
await grantiva.flags.clearCache()