afpp

Another f*cking PDF parser. Because parsing PDFs in Node.js should be easy. Live long and parse PDFs. 🖖

Why?

There are plenty of PDF-related packages for Node.js. They work… until they don’t.

Afpp was built to solve the headaches I ran into while trying to parse PDFs in Node.js:

• 📦 Do I need a package with 30+ MB just to read a PDF?
• 🧵 Why is the event loop blocked?
• 🐏 Is that a memory leak I smell?
• 🐌 Should reading a PDF really be this performance-heavy?
• 🐞 Why is everything so buggy?
• 🎨 Why does it complain about the lack of a canvas in Node.js?
• 🧱 Why does canvas require native C++/Python dependencies to build?
• 🪟 Why does it complain about the missing window object?
• 🪄 Why do I need ImageMagick for this?!
• 👻 What the hell is Ghostscript, and why does it keep failing?
• ❌ Where’s the TypeScript support?
• 🧓 Why are the dependencies older than my dev career?
• 🔐 Why does everything work… until I try an encrypted PDF?
• 🕯️ Why does every OS need its own special setup ritual?

Prerequisites

• Node.js >= v22.14.0

📦 Installation

You can install afpp via npm, Yarn, or pnpm.

npm

1npm install afpp

Yarn

1yarn add afpp

pnpm

1pnpm add afpp

Getting started

The afpp library makes it simple to extract text or images from PDF files in Node.js. Whether your PDF is stored locally, hosted online, or encrypted, afpp provides an easy-to-use API to handle it all. All functions have common parameters and accepts string path, buffer, or URL object.

Get text from path

1import { readFile } from 'fs/promises';
2import path from 'path';
3
4import { pdf2string } from 'afpp';
5
6(async function main() {
7  const pathToFile = path.join('..', 'test', 'example.pdf');
8  const input = await readFile(pathToFile);
9  const data = await pdf2string(input);
10
11  console.log('Extracted text:', data); // ['page 1 content', 'page 2 content', ...]
12})();

Get image from URL

1import { pdf2image } from 'afpp';
2
3(async function main() {
4  const url = new URL('https://pdfobject.com/pdf/sample.pdf');
5  const arrayOfImages = await pdf2image(url);
6
7  console.log(arrayOfImages); // [imageBuffer, imageBuffer, ...]
8})();

Parse pdf buffer

1import { parsePdf } from 'afpp';
2
3(async function main() {
4  // Download PDF from URL
5  const response = await fetch('https://pdfobject.com/pdf/sample.pdf');
6  const buffer = Buffer.from(await response.arrayBuffer());
7
8  // Parse the PDF buffer
9  const result = await parsePdf(buffer, {}, (content) => content);
10  console.log('Parsed PDF:', result);
11})();