MarkpdfClient client = new MarkpdfClient("YOUR_API_KEY");

// or with custom baseUrl
MarkpdfClient client = new MarkpdfClient("YOUR_API_KEY", "https://api.markpdf.tech");

ConvertOptions options = ConvertOptions.builder()
    .inputFormat(ConvertOptions.InputFormat.AUTO)   // default AUTO
    .mode(ConvertOptions.Mode.FAST)                 // default FAST
    .engine(ConvertOptions.Engine.AUTO)              // default AUTO
    .clean(true)                                     // default true
    .imageOcr(false)                                 // default false
    .hybridOcr(false)                                // default false
    .responseFormat(ConvertOptions.ResponseFormat.MARKDOWN) // default MARKDOWN
    .pages("1-10")                                   // default null (the whole document)
    .outputUrl(null)
    .outputEncoding(ConvertOptions.OutputEncoding.IDENTITY)
    .outputHeadUrl(null)
    .autoPoll(true)                                  // default true
    .build();

// shortcut for all defaults
ConvertOptions.defaults();

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

ConvertResult convertFile(Path path, ConvertOptions options) throws MarkpdfException

ConvertResult convertBytes(byte[] data, String filename, ConvertOptions options) throws MarkpdfException

CompletableFuture<ConvertResult> convertBytesAsync(byte[] data, String filename, ConvertOptions options)

ConvertResult convertFromUrl(String url, String filename, ConvertOptions options) throws MarkpdfException

Map<String, Object> pdfIndex(String url, String filename) throws MarkpdfException

Map<String, Object> spine = client.pdfIndex("https://bucket.example.com/report.pdf?sig=...", null);
List<Map<String, Object>> sections = (List<Map<String, Object>>) spine.get("sections");

Job getJob(String jobId) throws MarkpdfException

Job waitForJob(String jobId, Duration pollInterval, Duration timeout) throws MarkpdfException

sealed interface ConvertResult
    permits ConvertResult.Markdown, ConvertResult.Json, ConvertResult.Queued {

    record Markdown(String markdown) implements ConvertResult {}
    record Json(JsonResult result) implements ConvertResult {}
    record Queued(Job job) implements ConvertResult {}
}

ConvertResult result = client.convertBytes(data, "report.pdf", options);

String markdown = switch (result) {
    case ConvertResult.Markdown md -> md.markdown();
    case ConvertResult.Json j -> j.result().markdown();
    case ConvertResult.Queued q -> throw new IllegalStateException("job en cola: " + q.job().jobId());
};

record JsonResult(
    String markdown,
    String filename,
    String inputFormat,
    String engine,
    long sizeBytes,
    long markdownBytes,
    long tokenSavedEstimate,
    Timings timings
) {}

record Timings(
    long convertMs,
    long cleanMs,
    long totalWorkerMs,
    long uploadMs,
    long totalRequestMs
) {}

record Job(
    String jobId,
    JobStatus status, // enum: QUEUED, PROCESSING, COMPLETED, FAILED
    Object body,
    String error
) {}