val client = MarkpdfClient(
    apiKey = "YOUR_API_KEY",
    baseUrl = "https://api.markpdf.tech", // optional, production default
    http = OkHttpClient(),                  // optional, your own OkHttpClient
)

data class ConvertOptions(
    val inputFormat: InputFormat = InputFormat.AUTO,
    val mode: ConversionMode = ConversionMode.FAST,
    val engine: Engine = Engine.AUTO,
    val clean: Boolean = true,
    val imageOcr: Boolean = false,
    val hybridOcr: Boolean = false,
    val responseFormat: ResponseFormat = ResponseFormat.MARKDOWN,
    val slim: Boolean = true,
    val pages: String? = null,
    val outputUrl: String? = null,
    val outputEncoding: OutputEncoding = OutputEncoding.IDENTITY,
    val outputHeadUrl: String? = null,
    val autoPoll: Boolean = true,
)

// Example: just change mode
val options = ConvertOptions(mode = ConversionMode.BALANCED)

enum class InputFormat { AUTO, PDF, DOCX, XLSX, PPTX, CSV, TXT, ZIP }
enum class ConversionMode { FAST, ULTRA_FAST, BALANCED, QUALITY, AUTO }
enum class ResponseFormat { MARKDOWN, JSON }
enum class OutputEncoding { IDENTITY, GZIP, ZSTD }

suspend fun convertFile(
    file: File,
    options: ConvertOptions = ConvertOptions(),
): ConvertResult

suspend fun convertBytes(
    data: ByteArray,
    filename: String,
    options: ConvertOptions = ConvertOptions(),
): ConvertResult

suspend fun convertFromUrl(
    url: String,
    filename: String? = null,
    options: ConvertOptions = ConvertOptions(),
): ConvertResult

suspend fun pdfIndex(url: String, filename: String? = null): JsonObject

val spine = client.pdfIndex("https://bucket.example.com/report.pdf?sig=...")
val sections = spine["sections"]!!.jsonArray
for (section in sections) {
    println(section.jsonObject["text"])
}

suspend fun getJob(jobId: String): Job

suspend fun waitForJob(
    jobId: String,
    pollInterval: Duration = 5.seconds,
    timeout: Duration? = null,
): Job

sealed class ConvertResult {
    data class Markdown(val markdown: String) : ConvertResult()
    data class Json(val result: JsonResult) : ConvertResult()
    data class Queued(val job: Job) : ConvertResult()
}

val markdown = when (val result = client.convertBytes(bytes, "report.pdf")) {
    is ConvertResult.Markdown -> result.markdown
    is ConvertResult.Json -> result.result.markdown
    is ConvertResult.Queued -> error("job en cola: ${result.job.jobId}")
}

data class JsonResult(
    val markdown: String,
    val filename: String,
    val inputFormat: String,
    val engine: String,
    val sizeBytes: Long,
    val markdownBytes: Long,
    val tokenSavedEstimate: Long,
    val timings: Timings,
)

data class Timings(
    val convertMs: Long,
    val cleanMs: Long,
    val totalWorkerMs: Long,
    val uploadMs: Long,
    val totalRequestMs: Long,
)

data class Job(
    val jobId: String,
    val status: JobStatus, // enum: QUEUED, PROCESSING, COMPLETED, FAILED
    val body: JsonElement? = null,
    val error: String? = null,
)