public enum SpendOwlError: LocalizedError, Sendable, Equatable

case notConfigured

do {
    let attribution = try await SpendOwl.attribution()
} catch SpendOwlError.notConfigured {
    // Configure the SDK first
    SpendOwl.configure(apiKey: "your-api-key")
}

case invalidAPIKey

case networkError(Error)

do {
    let attribution = try await SpendOwl.attribution()
} catch SpendOwlError.networkError(let underlyingError) {
    print("Network failed: \(underlyingError)")
    // Consider retrying later
}

case serverError(statusCode: Int, message: String?)

do {
    let attribution = try await SpendOwl.attribution()
} catch SpendOwlError.serverError(let code, let message) {
    print("Server error \(code): \(message ?? "Unknown")")
}

case attributionUnavailable

case attributionDenied

case encodingError

case decodingError(Error)

case unknown(Error)

public var errorDescription: String? { get }

catch let error as SpendOwlError {
    print(error.errorDescription ?? "Unknown error")
}

public var errorCode: Int { get }

do {
    let attribution = try await SpendOwl.attribution()
    handleAttribution(attribution)
} catch SpendOwlError.notConfigured {
    // SDK not configured
    SpendOwl.configure(apiKey: "your-api-key")
    // Retry
} catch SpendOwlError.invalidAPIKey {
    // Wrong API key - log and alert
    logger.error("Invalid SpendOwl API key")
} catch SpendOwlError.networkError {
    // Network issue - will be retried automatically
    // Consider showing offline indicator
} catch SpendOwlError.serverError(let code, _) where code >= 500 {
    // Server issue - temporary, will resolve
} catch SpendOwlError.attributionUnavailable {
    // Device doesn't support attribution
    // Continue without attribution data
} catch SpendOwlError.attributionDenied {
    // User has tracking disabled
    // Continue without attribution data
} catch {
    // Unknown error
    logger.error("Attribution error: \(error)")
}

do {
    let attribution = try await SpendOwl.attribution()
    // Use attribution
} catch {
    // Log and continue without attribution
    print("Attribution unavailable: \(error.localizedDescription)")
}

SpendOwl.attribution { result in
    switch result {
    case .success(let attribution):
        // Handle success
        break
    case .failure(let error):
        switch error {
        case .networkError:
            // Retry later
            break
        default:
            // Log error
            break
        }
    }
}