unpdf 1.9.0 → 1.9.1

package/README.md

@@ -1,16 +1,17 @@
 # unpdf
 
-Utilities for PDF extraction and rendering across all JavaScript runtimes – Node.js, Deno, Bun, the browser, and serverless environments like Cloudflare Workers. Especially useful for AI applications that need to summarize or analyze PDF documents.
+Utilities for PDF extraction and rendering across all JavaScript runtimes – Node.js, Bun, the browser, and serverless environments like Cloudflare Workers. Especially useful for AI applications that need to summarize or analyze PDF documents.
 
 Ships with a serverless build of Mozilla's [PDF.js](https://github.com/mozilla/pdf.js), optimized for edge environments. If you're coming from [`pdf-parse`](https://www.npmjs.com/package/pdf-parse), `unpdf` is a modern, actively maintained alternative with broader runtime support.
 
 ## Features
 
-- 🏗️ Works in Node.js, browser and serverless environments
-- 🪭 Includes serverless build of PDF.js ([`unpdf/pdfjs`](./package.json))
-- 💬 Extract [text](#extract-text-from-pdf), [links](#extractlinks), and [images](#extractimages) from PDF files
+- 🏗️ Works in Node.js 22+, Bun, browsers, and serverless environments ([Cloudflare Workers example](./examples/cloudflare))
+- 🪭 Includes serverless build of PDF.js ([`unpdf/pdfjs`](#how-it-works))
+- 💬 Extract [text](#extracttext), [positioned text](#extracttextitems), [links](#extractlinks), [images](#extractimages), and [metadata](#getmeta) from PDF files
+- 🖼️ [Render pages as images](#renderpageasimage)
 - 🧠 Perfect for AI applications and PDF summarization
-- 🧱 Opt-in to official or legacy PDF.js build
+- 🧱 Opt-in to a [custom PDF.js build](#custom-pdfjs-build)
 
 ## Installation
 
@@ -24,8 +25,6 @@ npm install unpdf
 
 ## Usage
 
-### Extract Text From PDF
-
 ```ts
 import { extractText, getDocumentProxy } from 'unpdf'
 
@@ -40,54 +39,6 @@ console.log(`Total pages: ${totalPages}`)
 console.log(text)
 ```
 
-### Official or Legacy PDF.js Build
-
-Usually you don't need to worry about the PDF.js build. `unpdf` ships with a serverless build of the latest PDF.js version. However, if you want to use the official PDF.js version or the legacy build, you can define a custom PDF.js module.
-
-> [!WARNING]
-> PDF.js v5.x uses `Promise.withResolvers`, which may not be supported in all environments, such as Node < 22. Consider using the bundled serverless build, which includes a polyfill, or use an older version of PDF.js.
-
-For example, if you want to use the official PDF.js build:
-
-```ts
-import { definePDFJSModule, extractText, getDocumentProxy } from 'unpdf'
-
-// Define the PDF.js build before using any other unpdf method
-await definePDFJSModule(() => import('pdfjs-dist'))
-
-// Now, you can use all unpdf methods with the official PDF.js build
-const pdf = await getDocumentProxy(/* … */)
-const { text } = await extractText(pdf)
-```
-
-### PDF.js API
-
-`unpdf` provides helpful [methods](#api) to work with PDF files, such as `extractText` and `extractImages`, which should cover most use cases. However, if you need more control over the PDF.js API, you can use the `getResolvedPDFJS` method to get the resolved PDF.js module.
-
-Access the PDF.js API directly by calling `getResolvedPDFJS`:
-
-```ts
-import { getResolvedPDFJS } from 'unpdf'
-
-const { version } = await getResolvedPDFJS()
-```
-
-> [!NOTE]
-> If no other PDF.js build was defined, the serverless build will always be used.
-
-For example, you can use the `getDocument` method to load a PDF file and then use the `getMetadata` method to get the metadata of the PDF file:
-
-```ts
-import { readFile } from 'node:fs/promises'
-import { getResolvedPDFJS } from 'unpdf'
-
-const { getDocument } = await getResolvedPDFJS()
-const data = await readFile('./dummy.pdf')
-const document = await getDocument(new Uint8Array(data)).promise
-
-console.log(await document.getMetadata())
-```
-
 ## How It Works
 
 > [!NOTE]
@@ -97,13 +48,13 @@ Heart and soul of this package is the [`pdfjs.rolldown.config.ts`](./pdfjs.rolld
 
 - **String replacements** strip browser-specific references from the PDF.js source.
 - **Worker inlining** embeds the PDF.js worker directly into the main bundle, since serverless runtimes can't load separate worker files.
-- **Global polyfills** provide missing APIs like `Promise.withResolvers` and `FinalizationRegistry` (unavailable in Node.js < 22 and Cloudflare Workers, respectively).
+- **Global polyfills** fill in newer APIs like `Promise.try` and `Map.prototype.getOrInsert` for runtimes that lack them, plus `FinalizationRegistry` for Cloudflare Workers.
 
 ## API
 
 ### `definePDFJSModule`
 
-Allows to define a custom PDF.js build. This method should be called before using any other method. If no custom build is defined, the serverless build will be used.
+Sets the PDF.js build every other method uses – call it before any of them. See [Custom PDF.js Build](#custom-pdfjs-build).
 
 **Type Declaration**
 
@@ -113,7 +64,7 @@ function definePDFJSModule(pdfjs: () => Promise<PDFJS>): Promise<void>
 
 ### `getResolvedPDFJS`
 
-Returns the resolved PDF.js module. If no other PDF.js build was defined, the serverless build will be used. This method is useful if you want to use the PDF.js API directly.
+Returns the resolved PDF.js module – the serverless build, unless `definePDFJSModule` set another. Use it to call the PDF.js API directly.
 
 **Type Declaration**
 
@@ -121,11 +72,19 @@ Returns the resolved PDF.js module. If no other PDF.js build was defined, the se
 function getResolvedPDFJS(): Promise<PDFJS>
 ```
 
+**Example**
+
+```ts
+import { getResolvedPDFJS } from 'unpdf'
+
+const { version } = await getResolvedPDFJS()
+```
+
 ### `getDocumentProxy`
 
 Creates a `PDFDocumentProxy` from binary PDF data. Every extraction method accepts either raw data or an existing proxy – use this when you want to reuse one document across multiple calls.
 
-Applies sensible defaults: `useSystemFonts: true`; in Node.js additionally `disableFontFace: true`, plus `standardFontDataUrl` and `cMapUrl`/`cMapPacked` resolved from the local `pdfjs-dist` package for standard font and CJK character map support (see the font rendering tip in [`renderPageAsImage`](#renderpageasimage)).
+Applies sensible defaults: `useSystemFonts: true`; in Node.js additionally `disableFontFace: true`, plus `standardFontDataUrl` and `cMapUrl`/`cMapPacked` resolved from the local `pdfjs-dist` package for standard font and CJK character map support. Without `pdfjs-dist` installed, the Node.js defaults are skipped.
 
 **Type Declaration**
 
@@ -136,6 +95,17 @@ function getDocumentProxy(
 ): Promise<PDFDocumentProxy>
 ```
 
+**Example**
+
+Your options override the defaults:
+
+```ts
+const pdf = await getDocumentProxy(buffer, {
+  disableFontFace: false,
+  standardFontDataUrl: 'https://unpkg.com/pdfjs-dist@latest/standard_fonts/',
+})
+```
+
 ### `getMeta`
 
 Extracts metadata from a PDF. If `parseDates` is set to `true`, the date properties will be parsed into `Date` objects.
@@ -238,7 +208,7 @@ for (const link of links) console.log(link)
 
 ### `extractImages`
 
-Extracts images from a specific page of a PDF document, including necessary metadata such as width, height, and calculated color channels. Works with both the serverless and official PDF.js build.
+Extracts images from a specific page of a PDF document, including necessary metadata such as width, height, and calculated color channels.
 
 **Type Declaration**
 
@@ -259,65 +229,31 @@ function extractImages(
 
 **Example**
 
-> [!NOTE]
-> The following example uses the [sharp](https://github.com/lovell/sharp) library to process and save the extracted images. You will need to install it with your preferred package manager.
+Saves each image as PNG with [sharp](https://github.com/lovell/sharp), installed separately:
 
 ```ts
-import { readFile, writeFile } from 'node:fs/promises'
+import { readFile } from 'node:fs/promises'
 import sharp from 'sharp'
 import { extractImages, getDocumentProxy } from 'unpdf'
 
-async function extractPdfImages() {
-  const buffer = await readFile('./document.pdf')
-  const pdf = await getDocumentProxy(new Uint8Array(buffer))
-
-  // Extract images from page 1
-  const imagesData = await extractImages(pdf, 1)
-  console.log(`Found ${imagesData.length} images on page 1`)
-
-  // Process each image with sharp (optional)
-  let totalImagesProcessed = 0
-  for (const imgData of imagesData) {
-    const imageIndex = ++totalImagesProcessed
-
-    await sharp(imgData.data, {
-      raw: {
-        width: imgData.width,
-        height: imgData.height,
-        channels: imgData.channels
-      }
-    })
-      .png()
-      .toFile(`image-${imageIndex}.png`)
-
-    console.log(`Saved image ${imageIndex} (${imgData.width}x${imgData.height}, ${imgData.channels} channels)`)
-  }
+const buffer = await readFile('./document.pdf')
+const pdf = await getDocumentProxy(new Uint8Array(buffer))
+const images = await extractImages(pdf, 1)
+
+for (const [index, image] of images.entries()) {
+  await sharp(image.data, {
+    raw: { width: image.width, height: image.height, channels: image.channels },
+  })
+    .png()
+    .toFile(`image-${index + 1}.png`)
 }
-
-extractPdfImages().catch(console.error)
 ```
 
 ### `renderPageAsImage`
 
-To render a PDF page as an image, you can use the `renderPageAsImage` method. This method will return an `ArrayBuffer` of the rendered image. It can also return a data URL (`string`) if `toDataURL` option is set to `true`.
+Renders a PDF page as PNG and returns its bytes as an `ArrayBuffer`, or a data URL (`string`) with `toDataURL: true`.
 
-> [!NOTE]
-> This method will only work in Node.js and browser environments.
-
-In order to use this method, make sure to meet the following requirements:
-
-- Use the official PDF.js build (see [Official or Legacy PDF.js Build](#official-or-legacy-pdfjs-build)).
-- 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]
-> 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
-> const pdf = await getDocumentProxy(buffer, {
->   disableFontFace: false,
->   standardFontDataUrl: 'https://unpkg.com/pdfjs-dist@latest/standard_fonts/',
-> })
-> ```
+Rendering needs a canvas: browsers bring their own, while Node.js and Bun need the [`@napi-rs/canvas`](https://github.com/Brooooooklyn/canvas) package, passed as `canvasImport`. Serverless runtimes like Cloudflare Workers have neither.
 
 **Type Declaration**
 
@@ -336,57 +272,36 @@ function renderPageAsImage(
 ): Promise<ArrayBuffer | string>
 ```
 
-**Examples**
+**Example**
 
 ```ts
 import { readFile, writeFile } from 'node:fs/promises'
-import { definePDFJSModule, renderPageAsImage } from 'unpdf'
+import { renderPageAsImage } from 'unpdf'
 
-// Use the official PDF.js build
-await definePDFJSModule(() => import('pdfjs-dist'))
-
-const pdf = await readFile('./dummy.pdf')
-const buffer = new Uint8Array(pdf)
-const pageNumber = 1
-
-const result = await renderPageAsImage(buffer, pageNumber, {
+const buffer = await readFile('./dummy.pdf')
+const image = await renderPageAsImage(new Uint8Array(buffer), 1, {
   canvasImport: () => import('@napi-rs/canvas'),
   scale: 2,
 })
-await writeFile('dummy-page-1.png', new Uint8Array(result))
+
+await writeFile('dummy-page-1.png', new Uint8Array(image))
 ```
 
-```ts
-import { readFile, writeFile } from 'node:fs/promises'
-import { definePDFJSModule, renderPageAsImage } from 'unpdf'
+## Custom PDF.js Build
 
-await definePDFJSModule(() => import('pdfjs-dist'))
+`unpdf` uses its serverless build unless you define another one, e.g. to pin a different PDF.js version. Install `pdfjs-dist` and call `definePDFJSModule` before any other method:
 
-const pdf = await readFile('./dummy.pdf')
-const buffer = new Uint8Array(pdf)
-const pageNumber = 1
+```ts
+import { definePDFJSModule, extractText, getDocumentProxy } from 'unpdf'
 
-const result = await renderPageAsImage(buffer, pageNumber, {
-  canvasImport: () => import('@napi-rs/canvas'),
-  scale: 2,
-  toDataURL: true,
-})
+await definePDFJSModule(() => import('pdfjs-dist/legacy/build/pdf.mjs'))
 
-const html = `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Dummy Page</title>
-  </head>
-  <body>
-    <img alt="Example Page" src="${result}">
-  </body>
-</html>`
-
-await writeFile('dummy-page-1.html', html)
+const pdf = await getDocumentProxy(/* … */)
+const { text } = await extractText(pdf)
 ```
 
+In Node.js, import the legacy build as shown. The default `pdfjs-dist` entry targets current browsers – it fails on Node.js 24 and older and warns on newer versions.
+
 ## Processing Untrusted PDFs
 
 PDF.js does not execute scripts embedded in PDFs, but resource limits are your job:

package/dist/index.cjs

@@ -53,7 +53,7 @@ let resolvedModule;
 const isNode = globalThis.process?.release?.name === "node";
 const isBrowser = typeof window !== "undefined";
 /**
-* Returns a `PDFDocumentProxy` instance from a given binary data.
+* Creates a `PDFDocumentProxy` from binary PDF data.
 *
 * Applies the following defaults:
 * - `useSystemFonts: true`
@@ -209,18 +209,6 @@ function injectCanvasConstructors() {
 /**
 * Extracts images from a specific page of a PDF document, including necessary metadata,
 * such as width, height, and calculated color channels.
-*
-* @example
-* const imagesData = await extractImages(pdf, pageNum)
-*
-* for (const imgData of imagesData) {
-*   const imageIndex = totalImagesProcessed + 1
-*   await sharp(imgData.data, {
-*     raw: { width: imgData.width, height: imgData.height, channels: imgData.channels }
-*   })
-*     .png()
-*     .toFile(`${imageIndex}.png`)
-* }
 */
 async function extractImages$1(data, pageNumber) {
 	return await withDocument(data, async (pdf) => {
@@ -327,23 +315,23 @@ const XMP_DATE_PROPERTIES = [
 async function getMeta$1(data, options = {}) {
 	return await withDocument(data, async (pdf) => {
 		const meta = await pdf.getMetadata();
-		const info = meta?.info || {};
+		const info = { ...meta.info };
+		let metadata = meta.metadata;
 		if (options.parseDates) {
 			const { PDFDateString } = await getResolvedPDFJS();
-			if (info?.CreationDate) info.CreationDate = PDFDateString.toDateObject(info?.CreationDate);
-			if (info?.ModDate) info.ModDate = PDFDateString.toDateObject(info?.ModDate);
-			if (meta.metadata) meta.metadata = new Proxy(meta.metadata, { get(target, prop) {
-				if (prop === "get") return (name) => {
-					const value = target.get(name);
-					if (XMP_DATE_PROPERTIES.includes(name) && value) return parseISODateString(value);
-					return value;
-				};
-				return target[prop];
-			} });
+			if (info.CreationDate) info.CreationDate = PDFDateString.toDateObject(info.CreationDate);
+			if (info.ModDate) info.ModDate = PDFDateString.toDateObject(info.ModDate);
+			if (metadata) {
+				const Metadata = metadata.constructor;
+				metadata = new Metadata({
+					parsedData: new Map(Array.from(metadata, ([name, value]) => [name, XMP_DATE_PROPERTIES.includes(name) && value ? parseISODateString(value) : value])),
+					rawData: metadata.getRaw()
+				});
+			}
 		}
 		return {
 			info,
-			metadata: meta?.metadata || {}
+			metadata: metadata || {}
 		};
 	});
 }
@@ -404,15 +392,14 @@ function normalizeMergedText(texts) {
 //#endregion
 //#region src/config.ts
 /**
-* By default, unpdf will use the latest version of PDF.js compiled for
-* serverless environments. If you want to use a different version, you can
-* provide a custom resolver function.
+* Sets the PDF.js build every other method uses – call it before any of them.
+* Without it, the serverless build is used.
 *
 * @example
-* // Use the official PDF.js build (make sure to install it first)
+* // In Node.js, the legacy build of `pdfjs-dist` (install it first)
 * import { definePDFJSModule } from 'unpdf'
 *
-* await definePDFJSModule(() => import('pdfjs-dist'))
+* await definePDFJSModule(() => import('pdfjs-dist/legacy/build/pdf.mjs'))
 */
 async function definePDFJSModule(pdfjs) {
 	await resolvePDFJSImport(pdfjs, { reload: true });

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import { DocumentInitParameters, PDFDocumentProxy } from "./types/src/display/api.js";
 import { Canvas, SKRSContext2D } from "@napi-rs/canvas";
+import { Metadata } from "./types/src/display/metadata.js";
 import * as PDFJS from "./types/src/pdf.js";
 //#region src/_internal/canvas.d.ts
 interface CanvasFactoryContext {
@@ -55,18 +56,6 @@ interface ExtractedImageObject {
 /**
  * Extracts images from a specific page of a PDF document, including necessary metadata,
  * such as width, height, and calculated color channels.
- *
- * @example
- * const imagesData = await extractImages(pdf, pageNum)
- *
- * for (const imgData of imagesData) {
- *   const imageIndex = totalImagesProcessed + 1
- *   await sharp(imgData.data, {
- *     raw: { width: imgData.width, height: imgData.height, channels: imgData.channels }
- *   })
- *     .png()
- *     .toFile(`${imageIndex}.png`)
- * }
  */
 declare function extractImages$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number): Promise<ExtractedImageObject[]>;
 declare function renderPageAsImage$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number, options?: {
@@ -98,7 +87,7 @@ declare function getMeta$1(data: DocumentInitParameters['data'] | PDFDocumentPro
   parseDates?: boolean;
 }): Promise<{
   info: Record<string, any>;
-  metadata: import("./types/src/display/metadata.js").Metadata;
+  metadata: Metadata;
 }>;
 //#endregion
 //#region src/text.d.ts
@@ -147,15 +136,14 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
 //#endregion
 //#region src/config.d.ts
 /**
- * By default, unpdf will use the latest version of PDF.js compiled for
- * serverless environments. If you want to use a different version, you can
- * provide a custom resolver function.
+ * Sets the PDF.js build every other method uses – call it before any of them.
+ * Without it, the serverless build is used.
  *
  * @example
- * // Use the official PDF.js build (make sure to install it first)
+ * // In Node.js, the legacy build of `pdfjs-dist` (install it first)
  * import { definePDFJSModule } from 'unpdf'
  *
- * await definePDFJSModule(() => import('pdfjs-dist'))
+ * await definePDFJSModule(() => import('pdfjs-dist/legacy/build/pdf.mjs'))
  */
 export declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
 /** @deprecated Use `definePDFJSModule` instead. Will be removed in v2. */
@@ -165,7 +153,7 @@ export declare function configureUnPDF(options: {
 //#endregion
 //#region src/utils.d.ts
 /**
- * Returns a `PDFDocumentProxy` instance from a given binary data.
+ * Creates a `PDFDocumentProxy` from binary PDF data.
  *
  * Applies the following defaults:
  * - `useSystemFonts: true`

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { DocumentInitParameters, PDFDocumentProxy } from "./types/src/display/api.js";
 import { Canvas, SKRSContext2D } from "@napi-rs/canvas";
+import { Metadata } from "./types/src/display/metadata.js";
 import * as PDFJS from "./types/src/pdf.js";
 //#region src/_internal/canvas.d.ts
 interface CanvasFactoryContext {
@@ -55,18 +56,6 @@ interface ExtractedImageObject {
 /**
  * Extracts images from a specific page of a PDF document, including necessary metadata,
  * such as width, height, and calculated color channels.
- *
- * @example
- * const imagesData = await extractImages(pdf, pageNum)
- *
- * for (const imgData of imagesData) {
- *   const imageIndex = totalImagesProcessed + 1
- *   await sharp(imgData.data, {
- *     raw: { width: imgData.width, height: imgData.height, channels: imgData.channels }
- *   })
- *     .png()
- *     .toFile(`${imageIndex}.png`)
- * }
  */
 declare function extractImages$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number): Promise<ExtractedImageObject[]>;
 declare function renderPageAsImage$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number, options?: {
@@ -98,7 +87,7 @@ declare function getMeta$1(data: DocumentInitParameters['data'] | PDFDocumentPro
   parseDates?: boolean;
 }): Promise<{
   info: Record<string, any>;
-  metadata: import("./types/src/display/metadata.js").Metadata;
+  metadata: Metadata;
 }>;
 //#endregion
 //#region src/text.d.ts
@@ -147,15 +136,14 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
 //#endregion
 //#region src/config.d.ts
 /**
- * By default, unpdf will use the latest version of PDF.js compiled for
- * serverless environments. If you want to use a different version, you can
- * provide a custom resolver function.
+ * Sets the PDF.js build every other method uses – call it before any of them.
+ * Without it, the serverless build is used.
  *
  * @example
- * // Use the official PDF.js build (make sure to install it first)
+ * // In Node.js, the legacy build of `pdfjs-dist` (install it first)
  * import { definePDFJSModule } from 'unpdf'
  *
- * await definePDFJSModule(() => import('pdfjs-dist'))
+ * await definePDFJSModule(() => import('pdfjs-dist/legacy/build/pdf.mjs'))
  */
 export declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
 /** @deprecated Use `definePDFJSModule` instead. Will be removed in v2. */
@@ -165,7 +153,7 @@ export declare function configureUnPDF(options: {
 //#endregion
 //#region src/utils.d.ts
 /**
- * Returns a `PDFDocumentProxy` instance from a given binary data.
+ * Creates a `PDFDocumentProxy` from binary PDF data.
  *
  * Applies the following defaults:
  * - `useSystemFonts: true`

package/dist/index.mjs

@@ -52,7 +52,7 @@ let resolvedModule;
 const isNode = globalThis.process?.release?.name === "node";
 const isBrowser = typeof window !== "undefined";
 /**
-* Returns a `PDFDocumentProxy` instance from a given binary data.
+* Creates a `PDFDocumentProxy` from binary PDF data.
 *
 * Applies the following defaults:
 * - `useSystemFonts: true`
@@ -208,18 +208,6 @@ function injectCanvasConstructors() {
 /**
 * Extracts images from a specific page of a PDF document, including necessary metadata,
 * such as width, height, and calculated color channels.
-*
-* @example
-* const imagesData = await extractImages(pdf, pageNum)
-*
-* for (const imgData of imagesData) {
-*   const imageIndex = totalImagesProcessed + 1
-*   await sharp(imgData.data, {
-*     raw: { width: imgData.width, height: imgData.height, channels: imgData.channels }
-*   })
-*     .png()
-*     .toFile(`${imageIndex}.png`)
-* }
 */
 async function extractImages$1(data, pageNumber) {
 	return await withDocument(data, async (pdf) => {
@@ -326,23 +314,23 @@ const XMP_DATE_PROPERTIES = [
 async function getMeta$1(data, options = {}) {
 	return await withDocument(data, async (pdf) => {
 		const meta = await pdf.getMetadata();
-		const info = meta?.info || {};
+		const info = { ...meta.info };
+		let metadata = meta.metadata;
 		if (options.parseDates) {
 			const { PDFDateString } = await getResolvedPDFJS();
-			if (info?.CreationDate) info.CreationDate = PDFDateString.toDateObject(info?.CreationDate);
-			if (info?.ModDate) info.ModDate = PDFDateString.toDateObject(info?.ModDate);
-			if (meta.metadata) meta.metadata = new Proxy(meta.metadata, { get(target, prop) {
-				if (prop === "get") return (name) => {
-					const value = target.get(name);
-					if (XMP_DATE_PROPERTIES.includes(name) && value) return parseISODateString(value);
-					return value;
-				};
-				return target[prop];
-			} });
+			if (info.CreationDate) info.CreationDate = PDFDateString.toDateObject(info.CreationDate);
+			if (info.ModDate) info.ModDate = PDFDateString.toDateObject(info.ModDate);
+			if (metadata) {
+				const Metadata = metadata.constructor;
+				metadata = new Metadata({
+					parsedData: new Map(Array.from(metadata, ([name, value]) => [name, XMP_DATE_PROPERTIES.includes(name) && value ? parseISODateString(value) : value])),
+					rawData: metadata.getRaw()
+				});
+			}
 		}
 		return {
 			info,
-			metadata: meta?.metadata || {}
+			metadata: metadata || {}
 		};
 	});
 }
@@ -403,15 +391,14 @@ function normalizeMergedText(texts) {
 //#endregion
 //#region src/config.ts
 /**
-* By default, unpdf will use the latest version of PDF.js compiled for
-* serverless environments. If you want to use a different version, you can
-* provide a custom resolver function.
+* Sets the PDF.js build every other method uses – call it before any of them.
+* Without it, the serverless build is used.
 *
 * @example
-* // Use the official PDF.js build (make sure to install it first)
+* // In Node.js, the legacy build of `pdfjs-dist` (install it first)
 * import { definePDFJSModule } from 'unpdf'
 *
-* await definePDFJSModule(() => import('pdfjs-dist'))
+* await definePDFJSModule(() => import('pdfjs-dist/legacy/build/pdf.mjs'))
 */
 async function definePDFJSModule(pdfjs) {
 	await resolvePDFJSImport(pdfjs, { reload: true });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unpdf",
   "type": "module",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "packageManager": "pnpm@12.11.2",
   "description": "PDF extraction and rendering across all JavaScript runtimes",
   "author": "Johann Schopplich <hello@johannschopplich.com>",
@@ -84,6 +84,7 @@
   "devDependencies": {
     "@antfu/eslint-config": "^9.5.1",
     "@arethetypeswrong/cli": "^0.18.5",
+    "@cloudflare/vitest-plugin": "^1.4.3",
     "@napi-rs/canvas": "^1.0.11",
     "@types/node": "^26.6.5",
     "bumpp": "^12.3.0",