Referencia

import { MarkpdfClient } from "@markpdf/bun";

const client = new MarkpdfClient({
  apiKey: "YOUR_API_KEY",                 // o Bun.env.MARKPDF_API_KEY
  baseUrl: "https://api.markpdf.tech", // optional, production default
  timeoutMs: 300_000,                   // default 300000 (5 min)
  maxRetries: 2,                        // reintentos en 429/5xx
  autoPoll: true,                       // default true, ver Streaming y async
});

client.convertFile(
  path: string,
  options?: {
    inputFormat?: InputFormat;   // default "auto"
    mode?: ConvertMode;          // default "fast"
    engine?: Engine;             // default "auto"
    clean?: boolean;             // default true
    imageOcr?: boolean;          // default false
    hybridOcr?: boolean;         // default false
    responseFormat?: "markdown" | "json"; // default "markdown"
    pages?: string;
    outputUrl?: string;
    outputEncoding?: "identity" | "gzip" | "zstd";
    outputHeadUrl?: string;
    autoPoll?: boolean;
  }
): Promise<string | ConversionResult>

client.convertBytes(
  data: Uint8Array | ArrayBuffer | Blob,
  filename: string,
  options?: { /* mismas opciones que convertFile */ }
): Promise<string | ConversionResult>

client.convertFromUrl(
  url: string,
  filename?: string,
  options?: { /* mismas opciones que convertFile */ }
): Promise<string | ConversionResult>

client.convertStream(
  path: string,
  options?: {
    inputFormat?: InputFormat;
    clean?: boolean;
    slim?: boolean;                     // default true
    streamSlimStrategy?: "off" | "sampled" | "full"; // default "sampled"
  }
): AsyncGenerator<string>

client.pdfIndex(url: string, filename?: string): Promise<PdfSpine>

const spine = await client.pdfIndex("https://bucket.example.com/report.pdf?sig=...");
for (const section of spine.sections) {
  console.log(section.page, section.level, section.text);
}

client.getJob(jobId: string): Promise<JobStatus>

client.waitForJob(
  jobId: string,
  options?: { pollIntervalMs?: number; timeoutMs?: number }
): Promise<JobStatus>

interface ConversionResult {
  markdown: string;
  filename: string;
  inputFormat: string;
  engine: string;
  sizeBytes: number;
  markdownBytes: number;
  tokenSavedEstimate: number;
  timings: {
    convertMs: number;
    cleanMs: number;
    totalWorkerMs: number;
    uploadMs: number;
    totalRequestMs: number;
  };
}

interface PdfSpine {
  pageCount: number;
  inputBytes: number;
  fontModel: { bodySize: number; headingSizes: number[] };
  sections: Array<{ page: number; level: number; text: string }>;
  repeatedHeadersFooters: string[];
  pages: Array<{ page: number; chars: number; firstLine: string; headings: unknown[] }>;
  pagesTruncated: boolean;
  estimatedTokensFull: number;
  estimatedTokensSpineOnly: number;
}

interface JobStatus {
  jobId: string;
  status: "queued" | "processing" | "completed" | "failed";
  body?: string | Record<string, unknown>;
  error?: string;
}

import type { ConversionResult, PdfSpine, JobStatus, ConvertMode } from "@markpdf/bun";