Handle Errors from the Figranium Kotlin SDK

class FigraniumException(
    val status: Int = 0,
    val code: String? = null,
    val details: JsonElement? = null,
    val requestId: String? = null,
    message: String
) : IOException(message)

import dev.figranium.sdk.*
import java.io.IOException

val client = Figranium(authentication = FigraniumAuthentication.ApiKey("your-api-key"))

try {
    client.runTask("missing-task")
} catch (e: FigraniumException) {
    println(e.status)      // e.g. 404
    println(e.code)        // e.g. "TASK_NOT_FOUND"
    println(e.details)     // server diagnostics
    println(e.requestId)   // when supplied by the server or proxy
} catch (e: IOException) {
    println("Transport failure: ${e.message}")
}

import dev.figranium.sdk.*

try {
    client.tasks.get("some-task-id")
} catch (e: FigraniumException) {
    when (e.status) {
        401 -> {
            // Reauthenticate or refresh the API key.
            refreshApiKey()
        }
        404 -> {
            // Task is gone; treat as an empty result.
        }
        429 -> {
            // Back off and retry.
            delay(2_000)
        }
        else -> throw e
    }
}

import dev.figranium.sdk.*
import java.io.IOException

try {
    client.health.check()
} catch (e: FigraniumException) {
    println("Figranium API error: ${e.message}")
} catch (e: IOException) {
    println("Figranium is unreachable: ${e.message}")
}

import dev.figranium.sdk.*
import java.io.IOException
import kotlinx.coroutines.CancellationException

try {
    client.runTask("slow-task", options = RequestOptions(timeoutMillis = 5_000))
} catch (e: FigraniumException) {
    println("Figranium error: ${e.message}")
} catch (e: CancellationException) {
    println("The request was cancelled")
} catch (e: IOException) {
    println("The request timed out or the network failed: ${e.message}")
}