@maxwbh/pdf-lib

> This is an extended fork of pdf-lib with enterprise features including PDF encryption, decryption, incremental save (preserving digital signatures), and hyperlinks support.
>
> 100% backward compatible - Just change your import from pdf-lib to @maxwbh/pdf-lib
>
> Documentação em Português: docs/DOCUMENTACAO_PT.md

Table of Contents

- New Features
- Features
- Motivation
- Usage Examples
- Create Document
- Modify Document
- Create Form
- Fill Form
- Flatten Form
- Copy Pages
- Embed PNG and JPEG Images
- Embed PDF Pages
- Embed Font and Measure Text
- Add Attachments
- Set Document Metadata
- Read Document Metadata
- Set Viewer Preferences
- Read Viewer Preferences
- Draw SVG Paths
- Encrypt Document
- Open Encrypted Document
- Add Hyperlinks
- Incremental Save
- Deno Usage
- Complete Examples
- Installation
- Documentation
- Fonts and Unicode
- Creating and Filling Forms
- Limitations
- Help and Discussion
- Contributing
- License

New Features

This fork extends the original pdf-lib with enterprise-grade features:

| Feature | Description |
|---------|-------------|
| PDF Encryption | Password protect documents with RC4 (40/128-bit) or AES (128/256-bit) encryption |
| PDF Decryption | Open and work with password-protected PDF files |
| Incremental Save | Modify signed PDFs without invalidating digital signatures |
| Hyperlinks | Add clickable URL links and internal page navigation |
| Granular Permissions | Control printing, copying, modifying, form filling, and more |

$3

``js
// Encrypt a PDF
const pdfBytes = await pdfDoc.save({
encrypt: {
userPassword: 'user123',
ownerPassword: 'owner456',
permissions: { printing: true, copying: false },
},
});

// Open encrypted PDF
const pdfDoc = await PDFDocument.load(encryptedBytes, { password: 'user123' });

// Preserve digital signatures
pdfDoc.takeSnapshot();
// ... make changes ...
const pdfBytes = await pdfDoc.saveIncremental();

// Add hyperlinks
page.drawLink({ url: 'https://example.com', x: 50, y: 300, width: 100, height: 20 });
`

Features

$3

- Encrypt PDFs - Password protect documents with RC4 or AES encryption
- Decrypt PDFs - Open password-protected PDF files
- Incremental Save - Preserve digital signatures when modifying signed PDFs
- Hyperlinks - Add clickable links (URLs and internal page navigation)
- Granular Permissions - Control printing, copying, modifying, etc.

$3

- Create new PDFs
- Modify existing PDFs
- Create forms
- Fill forms
- Flatten forms
- Add Pages
- Insert Pages
- Remove Pages
- Copy pages between PDFs
- Draw Text
- Draw Images
- Draw PDF Pages
- Draw Vector Graphics
- Draw SVG Paths
- Measure width and height of text
- Embed Fonts (supports UTF-8 and UTF-16 character sets)
- Set document metadata
- Read document metadata
- Set viewer preferences
- Read viewer preferences
- Add attachments

Motivation

pdf-lib was created to address the JavaScript ecosystem's lack of robust support for PDF manipulation (especially for PDF _modification_).

Two of pdf-lib's distinguishing features are:

1. Supporting modification (editing) of existing documents.
2. Working in all JavaScript environments - not just in Node or the Browser.

There are other good open source JavaScript PDF libraries available. However, most of them can only _create_ documents, they cannot _modify_ existing ones. And many of them only work in particular environments.

Usage Examples

$3

_This example produces this PDF._

Try the JSFiddle demo


`js
import { PDFDocument, StandardFonts, rgb } from '@maxwbh/pdf-lib'

// Create a new PDFDocument
const pdfDoc = await PDFDocument.create()

// Embed the Times Roman font
const timesRomanFont = await pdfDoc.embedFont(StandardFonts.TimesRoman)

// Add a blank page to the document
const page = pdfDoc.addPage()

// Get the width and height of the page
const { width, height } = page.getSize()

// Draw a string of text toward the top of the page
const fontSize = 30
page.drawText('Creating PDFs in JavaScript is awesome!', {
x: 50,
y: height - 4 * fontSize,
size: fontSize,
font: timesRomanFont,
color: rgb(0, 0.53, 0.71),
})

// Serialize the PDFDocument to bytes (a Uint8Array)
const pdfBytes = await pdfDoc.save()

// For example, pdfBytes can be:
// • Written to a file in Node
// • Downloaded from the browser
// • Rendered in an