PDF

bun add @talosjs/pdf

import { PDF } from "@talosjs/pdf";

const pdf = new PDF("/path/to/document.pdf");
const result = await pdf.extract();

console.log(result.pdfType);   // "TextBased" | "Scanned" | "ImageBased" | "Mixed"
console.log(result.markdown);  // extracted Markdown, if any
console.log(result.pageCount); // total pages in the document

const result = await pdf.extract({ pages: [0, 2] });

const result = await pdf.extract();

if (result.pagesNeedingOcr.length > 0) {
  for (const { page, reasons } of result.ocrReasonsByPage) {
    console.log(`Page ${page} needs OCR: ${reasons.join(", ")}`);
  }
}

type PDFPageOcrReasonsType = {
  page: number;      // 1-indexed page number
  reasons: string[]; // machine-readable OCR reasons for this page
};

import { PDF, PDFException } from "@talosjs/pdf";

try {
  const pdf = new PDF("/path/to/document.pdf");
  await pdf.extract();
} catch (error) {
  if (error instanceof PDFException) {
    console.error(`[${error.key}] ${error.message}`, error.data);
  }
}