unpdf 0.7.0 → 0.7.1

package/README.md

@@ -179,8 +179,11 @@ defineUnPDFConfig({
 
 const pdf = await readFile("./dummy.pdf");
 const buffer = new Uint8Array(pdf);
+const pageNumber = 1;
 
-const result = await renderPageAsImage(buffer, 1);
+const result = await renderPageAsImage(buffer, pageNumber, {
+  canvas: () => import("canvas"),
+});
 await writeFile("dummy-page-1.png", Buffer.from(result));
 ```
 
@@ -191,8 +194,9 @@ declare function renderPageAsImage(
   data: BinaryData | PDFDocumentProxy,
   pageNumber: number,
   options?: {
+    canvas?: () => Promise<typeof "canvas">;
     /** @default 1 */
-    scale?: number;
+    scale?: number
     width?: number;
     height?: number;
   },
@@ -210,9 +214,11 @@ function extractImages(
 
 ## FAQ
 
-### What About Canvas?
+### Why Is `canvas` A Peer Dependency?
+
+The official PDF.js library depends on the `canvas` module for Node.js environments, which [doesn't work inside worker threads](https://github.com/Automattic/node-canvas/issues/1394). That's why `unpdf` ships with a serverless build of PDF.js that mocks the `canvas` module.
 
-The official PDF.js library depends on the optional `canvas` module, which [doesn't work inside worker threads](https://github.com/Automattic/node-canvas/issues/1394). That's why `unpdf` ships with a serverless build of PDF.js that mocks the `canvas` module.
+However, to render PDF pages as images, you need to install the `canvas` module in Node.js environments. That's why `canvas` is a peer dependency.
 
 ## License
 

package/dist/index.cjs

@@ -116,7 +116,7 @@ async function renderPageAsImage$1(data, pageNumber, options = {}) {
   if (outputScale !== 1 && outputScale > 0) {
     viewport = page.getViewport({ scale: outputScale });
   }
-  const canvasFactory = await createIsomorphicCanvasFactory();
+  const canvasFactory = await createIsomorphicCanvasFactory(options.canvas);
   const ctx = canvasFactory.create(viewport.width, viewport.height);
   await page.render({
     canvasContext: ctx.context,
@@ -126,25 +126,19 @@ async function renderPageAsImage$1(data, pageNumber, options = {}) {
   const response = await fetch(dataUrl);
   return await response.arrayBuffer();
 }
-async function createIsomorphicCanvasFactory() {
-  let _canvas;
-  if (isNode) {
-    try {
-      _canvas = await import('canvas');
-    } catch {
-      throw new Error(
-        'The "canvas" package is required when running in Node.js.'
-      );
-    }
-  }
+async function createIsomorphicCanvasFactory(canvas) {
+  const _canvas = await canvas?.();
   return {
     _createCanvas(width, height) {
       if (isBrowser) {
-        const canvas = document.createElement("canvas");
-        canvas.width = width;
-        canvas.height = height;
-        return canvas;
+        const canvas2 = document.createElement("canvas");
+        canvas2.width = width;
+        canvas2.height = height;
+        return canvas2;
       } else if (isNode) {
+        if (!_canvas) {
+          throw new Error('Failed to resolve "canvas" package.');
+        }
         return _canvas.createCanvas(width, height);
       }
       throw new Error("Unsupported environment for canvas creation.");

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { BinaryData, PDFDocumentProxy, DocumentInitParameters } from './types/src/display/api';
+import * as canvas from 'canvas';
 import * as _PDFJS from './types/src/pdf';
 
 declare function getMeta$1(data: BinaryData | PDFDocumentProxy): Promise<{
@@ -15,6 +16,7 @@ declare function extractText$1(data: BinaryData | PDFDocumentProxy, options?: {
 
 declare function extractImages$1(data: BinaryData | PDFDocumentProxy, pageNumber: number): Promise<Uint8ClampedArray[]>;
 declare function renderPageAsImage$1(data: BinaryData | PDFDocumentProxy, pageNumber: number, options?: {
+    canvas?: () => Promise<typeof canvas>;
     /** @default 1 */
     scale?: number;
     width?: number;

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { BinaryData, PDFDocumentProxy, DocumentInitParameters } from './types/src/display/api';
+import * as canvas from 'canvas';
 import * as _PDFJS from './types/src/pdf';
 
 declare function getMeta$1(data: BinaryData | PDFDocumentProxy): Promise<{
@@ -15,6 +16,7 @@ declare function extractText$1(data: BinaryData | PDFDocumentProxy, options?: {
 
 declare function extractImages$1(data: BinaryData | PDFDocumentProxy, pageNumber: number): Promise<Uint8ClampedArray[]>;
 declare function renderPageAsImage$1(data: BinaryData | PDFDocumentProxy, pageNumber: number, options?: {
+    canvas?: () => Promise<typeof canvas>;
     /** @default 1 */
     scale?: number;
     width?: number;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { BinaryData, PDFDocumentProxy, DocumentInitParameters } from './types/src/display/api';
+import * as canvas from 'canvas';
 import * as _PDFJS from './types/src/pdf';
 
 declare function getMeta$1(data: BinaryData | PDFDocumentProxy): Promise<{
@@ -15,6 +16,7 @@ declare function extractText$1(data: BinaryData | PDFDocumentProxy, options?: {
 
 declare function extractImages$1(data: BinaryData | PDFDocumentProxy, pageNumber: number): Promise<Uint8ClampedArray[]>;
 declare function renderPageAsImage$1(data: BinaryData | PDFDocumentProxy, pageNumber: number, options?: {
+    canvas?: () => Promise<typeof canvas>;
     /** @default 1 */
     scale?: number;
     width?: number;

package/dist/index.mjs

@@ -114,7 +114,7 @@ async function renderPageAsImage$1(data, pageNumber, options = {}) {
   if (outputScale !== 1 && outputScale > 0) {
     viewport = page.getViewport({ scale: outputScale });
   }
-  const canvasFactory = await createIsomorphicCanvasFactory();
+  const canvasFactory = await createIsomorphicCanvasFactory(options.canvas);
   const ctx = canvasFactory.create(viewport.width, viewport.height);
   await page.render({
     canvasContext: ctx.context,
@@ -124,25 +124,19 @@ async function renderPageAsImage$1(data, pageNumber, options = {}) {
   const response = await fetch(dataUrl);
   return await response.arrayBuffer();
 }
-async function createIsomorphicCanvasFactory() {
-  let _canvas;
-  if (isNode) {
-    try {
-      _canvas = await import('canvas');
-    } catch {
-      throw new Error(
-        'The "canvas" package is required when running in Node.js.'
-      );
-    }
-  }
+async function createIsomorphicCanvasFactory(canvas) {
+  const _canvas = await canvas?.();
   return {
     _createCanvas(width, height) {
       if (isBrowser) {
-        const canvas = document.createElement("canvas");
-        canvas.width = width;
-        canvas.height = height;
-        return canvas;
+        const canvas2 = document.createElement("canvas");
+        canvas2.width = width;
+        canvas2.height = height;
+        return canvas2;
       } else if (isNode) {
+        if (!_canvas) {
+          throw new Error('Failed to resolve "canvas" package.');
+        }
         return _canvas.createCanvas(width, height);
       }
       throw new Error("Unsupported environment for canvas creation.");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unpdf",
   "type": "module",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "packageManager": "pnpm@8.7.0",
   "description": "Utilities to work with PDFs in Node.js, browser and workers",
   "author": "Johann Schopplich <pkg@johannschopplich.com>",