feat: auto-apply standard font defaults in Node.js (closes #15)

johannschopplich · johannschopplich · commit 79d6885cdd70 · 2026-04-13T10:22:52.000+02:00
diff --git a/README.md b/README.md
@@ -273,19 +273,13 @@ In order to use this method, make sure to meet the following requirements:
 - Install the [`@napi-rs/canvas`](https://github.com/Brooooooklyn/canvas) package if you are using Node.js. This package is required to render the PDF page as an image.
 
 > [!TIP]
-> If fonts render incorrectly, create a `PDFDocumentProxy` with custom options and pass it directly:
+> In Node.js, `getDocumentProxy` automatically sets `disableFontFace: true` and resolves `standardFontDataUrl` from your local `pdfjs-dist` package for correct font rendering. To customize this behavior, pass your own options:
 >
 > ```ts
-> import { getDocumentProxy, renderPageAsImage } from 'unpdf'
->
 > const pdf = await getDocumentProxy(buffer, {
->   disableFontFace: true,
+>   disableFontFace: false,
 >   standardFontDataUrl: 'https://unpkg.com/pdfjs-dist@latest/standard_fonts/',
 > })
->
-> const image = await renderPageAsImage(pdf, 1, {
->   canvasImport: () => import('@napi-rs/canvas'),
-> })
 > ```
 
 **Type Declaration**
diff --git a/src/utils.ts b/src/utils.ts
@@ -14,17 +14,37 @@ export const isBrowser = typeof window !== 'undefined'
  * Applies the following defaults:
  * - `isEvalSupported: false`
  * - `useSystemFonts: true`
+ *
+ * In Node.js environments, additionally applies:
+ * - `disableFontFace: true`
+ * - `standardFontDataUrl` resolved from the local `pdfjs-dist` package
  */
 export async function getDocumentProxy(
   data: DocumentInitParameters['data'],
   options: DocumentInitParameters = {},
 ) {
   const { getDocument } = await getResolvedPDFJS()
+
+  let nodeDefaults: Partial<DocumentInitParameters> = {}
+  if (isNode) {
+    try {
+      const base = import.meta.resolve('pdfjs-dist/package.json')
+      nodeDefaults = {
+        disableFontFace: true,
+        standardFontDataUrl: new URL('./standard_fonts/', base).href,
+      }
+    }
+    catch {
+      // pdfjs-dist not installed (e.g. using serverless bundle), skip font defaults
+    }
+  }
+
   const pdf = await getDocument({
     data,
     isEvalSupported: false,
     // See: https://github.com/mozilla/pdf.js/issues/4244#issuecomment-1479534301
     useSystemFonts: true,
+    ...nodeDefaults,
     ...options,
   }).promise
 
