unpdf 0.12.1 → 1.0.0

package/dist/index.d.cts

@@ -1,31 +1,38 @@
-import * as canvas from 'canvas';
-import { Canvas } from 'canvas';
+import * as _napi_rs_canvas from '@napi-rs/canvas';
 import { DocumentInitParameters, PDFDocumentProxy } from './types/src/display/api';
 import * as _PDFJS from './types/src/pdf';
 
-declare function extractImages$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number): Promise<Uint8ClampedArray[]>;
+interface ExtractedImageObject {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+    channels: 1 | 3 | 4;
+    key: string;
+}
+/**
+ * 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?: {
-    canvas?: () => Promise<typeof canvas>;
-    /** @default 1 */
+    canvasImport?: () => Promise<typeof _napi_rs_canvas>;
+    /** @default 1.0 */
     scale?: number;
     width?: number;
     height?: number;
 }): Promise<ArrayBuffer>;
-declare function createIsomorphicCanvasFactory(canvas?: () => Promise<typeof canvas>): Promise<{
-    _createCanvas(width: number, height: number): Canvas | HTMLCanvasElement;
-    create(width: number, height: number): {
-        canvas: Canvas | HTMLCanvasElement;
-        context: CanvasRenderingContext2D;
-    };
-    reset(ctx: {
-        canvas?: Canvas;
-        context?: CanvasRenderingContext2D;
-    }, width: number, height: number): void;
-    destroy(ctx: {
-        canvas?: Canvas;
-        context?: CanvasRenderingContext2D;
-    }): void;
-}>;
 
 declare function getMeta$1(data: DocumentInitParameters['data'] | PDFDocumentProxy): Promise<{
     info: Record<string, any>;
@@ -45,21 +52,24 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
     text: string;
 }>;
 
-type PDFJS = typeof _PDFJS;
-interface UnPDFConfiguration {
-    /**
-     * 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.
-     *
-     * @example
-     * // Use the official PDF.js build (make sure to install it first)
-     * () => import('pdfjs-dist')
-     */
+/**
+ * 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.
+ *
+ * @example
+ * // Use the official PDF.js build (make sure to install it first)
+ * import { definePDFJSModule } from 'unpdf'
+ *
+ * await definePDFJSModule(() => import('pdfjs-dist'))
+ */
+declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
+/** @deprecated Use `definePDFJSModule` instead. */
+declare function configureUnPDF(options: {
     pdfjs?: () => Promise<any>;
-}
+}): Promise<void>;
 
-declare function configureUnPDF(options: UnPDFConfiguration): Promise<void>;
+type PDFJS = typeof _PDFJS;
 
 /**
  * Returns a PDFDocumentProxy instance from a given binary data.
@@ -70,8 +80,8 @@ declare function configureUnPDF(options: UnPDFConfiguration): Promise<void>;
  */
 declare function getDocumentProxy(data: DocumentInitParameters['data'], options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
 declare function getResolvedPDFJS(): Promise<PDFJS>;
-declare function resolvePDFJSImports(pdfjsResolver?: () => Promise<any>, { force }?: {
-    force?: boolean | undefined;
+declare function resolvePDFJSImport(pdfjsResolver?: () => Promise<any>, { reload }?: {
+    reload?: boolean | undefined;
 }): Promise<void>;
 
 declare const getMeta: typeof getMeta$1;
@@ -79,4 +89,4 @@ declare const extractText: typeof extractText$1;
 declare const extractImages: typeof extractImages$1;
 declare const renderPageAsImage: typeof renderPageAsImage$1;
 
-export { configureUnPDF, createIsomorphicCanvasFactory, extractImages, extractText, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImports };
+export { configureUnPDF, definePDFJSModule, extractImages, extractText, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };

package/dist/index.d.mts

@@ -1,31 +1,38 @@
-import * as canvas from 'canvas';
-import { Canvas } from 'canvas';
+import * as _napi_rs_canvas from '@napi-rs/canvas';
 import { DocumentInitParameters, PDFDocumentProxy } from './types/src/display/api';
 import * as _PDFJS from './types/src/pdf';
 
-declare function extractImages$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number): Promise<Uint8ClampedArray[]>;
+interface ExtractedImageObject {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+    channels: 1 | 3 | 4;
+    key: string;
+}
+/**
+ * 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?: {
-    canvas?: () => Promise<typeof canvas>;
-    /** @default 1 */
+    canvasImport?: () => Promise<typeof _napi_rs_canvas>;
+    /** @default 1.0 */
     scale?: number;
     width?: number;
     height?: number;
 }): Promise<ArrayBuffer>;
-declare function createIsomorphicCanvasFactory(canvas?: () => Promise<typeof canvas>): Promise<{
-    _createCanvas(width: number, height: number): Canvas | HTMLCanvasElement;
-    create(width: number, height: number): {
-        canvas: Canvas | HTMLCanvasElement;
-        context: CanvasRenderingContext2D;
-    };
-    reset(ctx: {
-        canvas?: Canvas;
-        context?: CanvasRenderingContext2D;
-    }, width: number, height: number): void;
-    destroy(ctx: {
-        canvas?: Canvas;
-        context?: CanvasRenderingContext2D;
-    }): void;
-}>;
 
 declare function getMeta$1(data: DocumentInitParameters['data'] | PDFDocumentProxy): Promise<{
     info: Record<string, any>;
@@ -45,21 +52,24 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
     text: string;
 }>;
 
-type PDFJS = typeof _PDFJS;
-interface UnPDFConfiguration {
-    /**
-     * 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.
-     *
-     * @example
-     * // Use the official PDF.js build (make sure to install it first)
-     * () => import('pdfjs-dist')
-     */
+/**
+ * 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.
+ *
+ * @example
+ * // Use the official PDF.js build (make sure to install it first)
+ * import { definePDFJSModule } from 'unpdf'
+ *
+ * await definePDFJSModule(() => import('pdfjs-dist'))
+ */
+declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
+/** @deprecated Use `definePDFJSModule` instead. */
+declare function configureUnPDF(options: {
     pdfjs?: () => Promise<any>;
-}
+}): Promise<void>;
 
-declare function configureUnPDF(options: UnPDFConfiguration): Promise<void>;
+type PDFJS = typeof _PDFJS;
 
 /**
  * Returns a PDFDocumentProxy instance from a given binary data.
@@ -70,8 +80,8 @@ declare function configureUnPDF(options: UnPDFConfiguration): Promise<void>;
  */
 declare function getDocumentProxy(data: DocumentInitParameters['data'], options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
 declare function getResolvedPDFJS(): Promise<PDFJS>;
-declare function resolvePDFJSImports(pdfjsResolver?: () => Promise<any>, { force }?: {
-    force?: boolean | undefined;
+declare function resolvePDFJSImport(pdfjsResolver?: () => Promise<any>, { reload }?: {
+    reload?: boolean | undefined;
 }): Promise<void>;
 
 declare const getMeta: typeof getMeta$1;
@@ -79,4 +89,4 @@ declare const extractText: typeof extractText$1;
 declare const extractImages: typeof extractImages$1;
 declare const renderPageAsImage: typeof renderPageAsImage$1;
 
-export { configureUnPDF, createIsomorphicCanvasFactory, extractImages, extractText, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImports };
+export { configureUnPDF, definePDFJSModule, extractImages, extractText, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };

package/dist/index.d.ts

@@ -1,31 +1,38 @@
-import * as canvas from 'canvas';
-import { Canvas } from 'canvas';
+import * as _napi_rs_canvas from '@napi-rs/canvas';
 import { DocumentInitParameters, PDFDocumentProxy } from './types/src/display/api';
 import * as _PDFJS from './types/src/pdf';
 
-declare function extractImages$1(data: DocumentInitParameters['data'] | PDFDocumentProxy, pageNumber: number): Promise<Uint8ClampedArray[]>;
+interface ExtractedImageObject {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+    channels: 1 | 3 | 4;
+    key: string;
+}
+/**
+ * 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?: {
-    canvas?: () => Promise<typeof canvas>;
-    /** @default 1 */
+    canvasImport?: () => Promise<typeof _napi_rs_canvas>;
+    /** @default 1.0 */
     scale?: number;
     width?: number;
     height?: number;
 }): Promise<ArrayBuffer>;
-declare function createIsomorphicCanvasFactory(canvas?: () => Promise<typeof canvas>): Promise<{
-    _createCanvas(width: number, height: number): Canvas | HTMLCanvasElement;
-    create(width: number, height: number): {
-        canvas: Canvas | HTMLCanvasElement;
-        context: CanvasRenderingContext2D;
-    };
-    reset(ctx: {
-        canvas?: Canvas;
-        context?: CanvasRenderingContext2D;
-    }, width: number, height: number): void;
-    destroy(ctx: {
-        canvas?: Canvas;
-        context?: CanvasRenderingContext2D;
-    }): void;
-}>;
 
 declare function getMeta$1(data: DocumentInitParameters['data'] | PDFDocumentProxy): Promise<{
     info: Record<string, any>;
@@ -45,21 +52,24 @@ declare function extractText$1(data: DocumentInitParameters['data'] | PDFDocumen
     text: string;
 }>;
 
-type PDFJS = typeof _PDFJS;
-interface UnPDFConfiguration {
-    /**
-     * 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.
-     *
-     * @example
-     * // Use the official PDF.js build (make sure to install it first)
-     * () => import('pdfjs-dist')
-     */
+/**
+ * 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.
+ *
+ * @example
+ * // Use the official PDF.js build (make sure to install it first)
+ * import { definePDFJSModule } from 'unpdf'
+ *
+ * await definePDFJSModule(() => import('pdfjs-dist'))
+ */
+declare function definePDFJSModule(pdfjs: () => Promise<any>): Promise<void>;
+/** @deprecated Use `definePDFJSModule` instead. */
+declare function configureUnPDF(options: {
     pdfjs?: () => Promise<any>;
-}
+}): Promise<void>;
 
-declare function configureUnPDF(options: UnPDFConfiguration): Promise<void>;
+type PDFJS = typeof _PDFJS;
 
 /**
  * Returns a PDFDocumentProxy instance from a given binary data.
@@ -70,8 +80,8 @@ declare function configureUnPDF(options: UnPDFConfiguration): Promise<void>;
  */
 declare function getDocumentProxy(data: DocumentInitParameters['data'], options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
 declare function getResolvedPDFJS(): Promise<PDFJS>;
-declare function resolvePDFJSImports(pdfjsResolver?: () => Promise<any>, { force }?: {
-    force?: boolean | undefined;
+declare function resolvePDFJSImport(pdfjsResolver?: () => Promise<any>, { reload }?: {
+    reload?: boolean | undefined;
 }): Promise<void>;
 
 declare const getMeta: typeof getMeta$1;
@@ -79,4 +89,4 @@ declare const extractText: typeof extractText$1;
 declare const extractImages: typeof extractImages$1;
 declare const renderPageAsImage: typeof renderPageAsImage$1;
 
-export { configureUnPDF, createIsomorphicCanvasFactory, extractImages, extractText, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImports };
+export { configureUnPDF, definePDFJSModule, extractImages, extractText, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };

package/dist/index.mjs

@@ -14,24 +14,21 @@ async function getDocumentProxy(data, options = {}) {
 }
 async function getResolvedPDFJS() {
   if (!resolvedModule) {
-    await resolvePDFJSImports();
+    await resolvePDFJSImport();
   }
   return resolvedModule;
 }
-async function resolvePDFJSImports(pdfjsResolver, { force = false } = {}) {
-  if (resolvedModule && !force) {
+async function resolvePDFJSImport(pdfjsResolver, { reload = false } = {}) {
+  if (resolvedModule && !reload) {
     return;
   }
   if (pdfjsResolver) {
     try {
       resolvedModule = await interopDefault(pdfjsResolver());
-      if (resolvedModule && "resolvePDFJS" in resolvedModule) {
-        resolvedModule = await resolvedModule.resolvePDFJS();
-      }
       return;
     } catch (error) {
       console.error(error);
-      throw new Error("Resolving failed. Please check the provided configuration.");
+      throw new Error("PDF.js could not be resolved. Please check the resolver function.");
     }
   }
   try {
@@ -39,7 +36,7 @@ async function resolvePDFJSImports(pdfjsResolver, { force = false } = {}) {
     resolvedModule = await resolvePDFJS();
   } catch (error) {
     console.error(error);
-    throw new Error("PDF.js is not available. Please add the package as a dependency.");
+    throw new Error("PDF.js package not available. Please install it first.");
   }
 }
 function isPDFDocumentProxy(data) {
@@ -50,12 +47,93 @@ async function interopDefault(m) {
   return resolved.default || resolved;
 }
 
+let canvasModule;
+/**
+ * Derived from the PDF.js project by the Mozilla Foundation.
+ * @see https://github.com/mozilla/pdf.js/blob/b8de9a372f9bbf7e33adb362eeae5ef1919dba73/src/display/canvas_factory.js#L18
+ * @license Apache-2.0
+ */
+class BaseCanvasFactory {
+  #enableHWA = false;
+  constructor({ enableHWA = false } = {}) {
+    this.#enableHWA = enableHWA;
+  }
+  create(width, height) {
+    const canvas = this._createCanvas(width, height);
+    return {
+      canvas,
+      context: canvas.getContext("2d", {
+        willReadFrequently: !this.#enableHWA
+      })
+    };
+  }
+  reset({ canvas }, width, height) {
+    if (!canvas) {
+      throw new Error("Canvas is not specified");
+    }
+    canvas.width = width;
+    canvas.height = height;
+  }
+  destroy(context) {
+    if (!context.canvas) {
+      throw new Error("Canvas is not specified");
+    }
+    context.canvas.width = 0;
+    context.canvas.height = 0;
+    context.canvas = void 0;
+    context.context = void 0;
+  }
+  // eslint-disable-next-line unused-imports/no-unused-vars
+  _createCanvas(width, height) {
+    throw new Error("Not implemented");
+  }
+}
+/**
+ * Derived from the PDF.js project by the Mozilla Foundation.
+ * @see https://github.com/mozilla/pdf.js/blob/b8de9a372f9bbf7e33adb362eeae5ef1919dba73/src/display/canvas_factory.js#L18
+ * @license Apache-2.0
+ */
+class DOMCanvasFactory extends BaseCanvasFactory {
+  _document;
+  constructor({ ownerDocument = globalThis.document, enableHWA = false } = {}) {
+    super({ enableHWA });
+    this._document = ownerDocument;
+  }
+  _createCanvas(width, height) {
+    const canvas = this._document.createElement("canvas");
+    canvas.width = width;
+    canvas.height = height;
+    return canvas;
+  }
+}
+class NodeCanvasFactory extends BaseCanvasFactory {
+  constructor({ enableHWA = false } = {}) {
+    super({ enableHWA });
+  }
+  _createCanvas(width, height) {
+    if (!canvasModule) {
+      throw new Error("@napi-rs/canvas module is not resolved");
+    }
+    return canvasModule.createCanvas(width, height);
+  }
+}
+async function resolveCanvasModule(canvasImport) {
+  canvasModule ??= await interopDefault(canvasImport());
+}
+function injectCanvasConstructors() {
+  if (!canvasModule)
+    return;
+  globalThis.DOMMatrix ??= canvasModule.DOMMatrix;
+  globalThis.ImageData ??= canvasModule.ImageData;
+  globalThis.Path2D ??= canvasModule.Path2D;
+}
+
 async function extractImages$1(data, pageNumber) {
   const pdf = isPDFDocumentProxy(data) ? data : await getDocumentProxy(data);
-  const page = await pdf.getPage(pageNumber);
   if (pageNumber < 1 || pageNumber > pdf.numPages) {
     throw new Error(`Invalid page number. Must be between 1 and ${pdf.numPages}.`);
   }
+  const page = await pdf.getPage(pageNumber);
   const operatorList = await page.getOperatorList();
   const { OPS } = await getResolvedPDFJS();
   const images = [];
@@ -66,79 +144,61 @@ async function extractImages$1(data, pageNumber) {
     }
     const imageKey = operatorList.argsArray[i][0];
     const image = await page.objs.get(imageKey);
-    images.push(image.data);
+    if (!image || !image.data || !image.width || !image.height) {
+      continue;
+    }
+    const { width, height, data: data2 } = image;
+    const calculatedChannels = data2.length / (width * height);
+    if (![1, 3, 4].includes(calculatedChannels)) {
+      continue;
+    }
+    const channels = calculatedChannels;
+    images.push({
+      data: data2,
+      width,
+      height,
+      channels,
+      key: imageKey
+    });
   }
   return images;
 }
 async function renderPageAsImage$1(data, pageNumber, options = {}) {
-  const canvasFactory = await createIsomorphicCanvasFactory(options.canvas);
-  const pdf = isPDFDocumentProxy(data) ? data : await getDocumentProxy(data, { canvasFactory });
+  const CanvasFactory = await createIsomorphicCanvasFactory(options.canvasImport);
+  const pdf = isPDFDocumentProxy(data) ? data : await getDocumentProxy(data, { CanvasFactory });
   const page = await pdf.getPage(pageNumber);
   if (pageNumber < 1 || pageNumber > pdf.numPages) {
     throw new Error(`Invalid page number. Must be between 1 and ${pdf.numPages}.`);
   }
-  let outputScale = options.scale || 1;
-  let viewport = page.getViewport({ scale: outputScale });
+  const defaultViewport = page.getViewport({ scale: 1 });
+  let scale = options.scale || 1;
   if (options.width) {
-    outputScale = options.width / viewport.width;
+    scale = options.width / defaultViewport.width;
   } else if (options.height) {
-    outputScale = options.height / viewport.height;
-  }
-  if (outputScale !== 1 && outputScale > 0) {
-    viewport = page.getViewport({ scale: outputScale });
+    scale = options.height / defaultViewport.height;
   }
-  const ctx = canvasFactory.create(viewport.width, viewport.height);
+  const viewport = page.getViewport({ scale: Math.max(0, scale) });
+  const drawingContext = new CanvasFactory().create(viewport.width, viewport.height);
   await page.render({
-    canvasContext: ctx.context,
+    canvasContext: drawingContext.context,
     viewport
   }).promise;
-  const dataUrl = isBrowser ? ctx.canvas.toDataURL() : ctx.canvas.toDataURL();
+  const dataUrl = drawingContext.canvas.toDataURL();
   const response = await fetch(dataUrl);
   return await response.arrayBuffer();
 }
-async function createIsomorphicCanvasFactory(canvas) {
-  const _canvas = canvas ? await interopDefault(canvas()) : void 0;
-  return {
-    _createCanvas(width, height) {
-      if (isBrowser) {
-        const canvas2 = document.createElement("canvas");
-        canvas2.width = width;
-        canvas2.height = height;
-        return canvas2;
-      }
-      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.");
-    },
-    create(width, height) {
-      const _canvas2 = this._createCanvas(width, height);
-      const context = _canvas2.getContext(
-        "2d"
-      );
-      return {
-        canvas: _canvas2,
-        context
-      };
-    },
-    reset(ctx, width, height) {
-      if (ctx.canvas) {
-        ctx.canvas.width = width;
-        ctx.canvas.height = height;
-      }
-    },
-    destroy(ctx) {
-      if (ctx.canvas) {
-        ctx.canvas.width = 0;
-        ctx.canvas.height = 0;
-      }
-      ctx.canvas = void 0;
-      ctx.context = void 0;
+async function createIsomorphicCanvasFactory(canvasImport) {
+  if (isBrowser)
+    return DOMCanvasFactory;
+  if (isNode) {
+    if (!canvasImport) {
+      throw new Error('Parameter "canvasImport" is required in Node.js environment.');
     }
-  };
+    await resolveCanvasModule(canvasImport);
+    injectCanvasConstructors();
+    return NodeCanvasFactory;
+  }
+  throw new Error("Unsupported environment for canvas creation.");
 }
 
 async function getMeta$1(data) {
@@ -151,7 +211,7 @@ async function getMeta$1(data) {
 }
 
 async function extractText$1(data, options = {}) {
-  const { mergePages = false } = { ...options };
+  const { mergePages = false } = options;
   const pdf = isPDFDocumentProxy(data) ? data : await getDocumentProxy(data);
   const texts = await Promise.all(
     Array.from({ length: pdf.numPages }, (_, i) => getPageText(pdf, i + 1))
@@ -167,28 +227,28 @@ async function getPageText(document, pageNumber) {
   return content.items.filter((item) => item.str != null).map((item) => item.str + (item.hasEOL ? "\n" : "")).join("");
 }
 
+async function definePDFJSModule(pdfjs) {
+  await resolvePDFJSImport(pdfjs, { reload: true });
+}
 async function configureUnPDF(options) {
-  const { pdfjs } = { ...options };
-  if (pdfjs) {
-    await resolvePDFJSImports(pdfjs, { force: true });
-  }
+  await resolvePDFJSImport(options.pdfjs, { reload: true });
 }
 
 const getMeta = async (...args) => {
-  await resolvePDFJSImports();
+  await resolvePDFJSImport();
   return await getMeta$1(...args);
 };
 const extractText = async (...args) => {
-  await resolvePDFJSImports();
+  await resolvePDFJSImport();
   return await extractText$1(...args);
 };
 const extractImages = async (...args) => {
-  await resolvePDFJSImports();
+  await resolvePDFJSImport();
   return await extractImages$1(...args);
 };
 const renderPageAsImage = async (...args) => {
-  await resolvePDFJSImports();
+  await resolvePDFJSImport();
   return await renderPageAsImage$1(...args);
 };
 
-export { configureUnPDF, createIsomorphicCanvasFactory, extractImages, extractText, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImports };
+export { configureUnPDF, definePDFJSModule, extractImages, extractText, getDocumentProxy, getMeta, getResolvedPDFJS, renderPageAsImage, resolvePDFJSImport };