unpdf 0.5.1 → 0.5.3

package/README.md

@@ -9,7 +9,7 @@ This library is also intended as a modern alternative to the unmaintained but st
 ## Features
 
 - 🏗️ Conditional exports for Browser, Node and worker environments
-- 💬 Extract text from PDFs
+- 💬 Extract text and images from PDFs
 - 🧱 Opt-in to legacy PDF.js build
 
 ## Installation
@@ -32,11 +32,16 @@ yarn add unpdf
 ```ts
 import { extractPDFText } from 'unpdf'
 
-const pdfBuffer = await fetch('https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf')
+// Fetch a PDF file from the web
+const pdf = await fetch('https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf')
   .then(res => res.arrayBuffer())
 
+// Or load it from the filesystem
+const pdf = await readFile('./dummy.pdf')
+
+// Pass the PDF buffer to the relevant method
 const { totalPages, text } = await extractPDFText(
-  new Uint8Array(pdfBuffer), { mergePages: true }
+  new Uint8Array(pdf), { mergePages: true }
 )
 ```
 
@@ -75,7 +80,7 @@ interface UnPDFConfiguration {
    * @example
    * () => import('pdfjs-dist/legacy/build/pdf.js')
    */
-  pdfjs?: () => typeof PDFJS
+  pdfjs?: () => Promise<typeof PDFJS>
 }
 ```
 
@@ -83,15 +88,15 @@ interface UnPDFConfiguration {
 
 ### `defineUnPDFConfig`
 
-Define a custom PDF.js module, like the legacy build.
+Define a custom PDF.js module, like the legacy build. Make sure to call this method before using any other methods.
 
 ```ts
-function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>
+function defineUnPDFConfig(config: UnPDFConfiguration): Promise<void>
 ```
 
 ### `getResolvedPDFJS`
 
-Returns the resolved PDF.js module.
+Returns the resolved PDF.js module. If no build is defined, the latest version will be initialized.
 
 ```ts
 function getResolvedPDFJS(): Promise<typeof import('pdfjs-dist')>
@@ -100,7 +105,9 @@ function getResolvedPDFJS(): Promise<typeof import('pdfjs-dist')>
 ### `getPDFMeta`
 
 ```ts
-function getPDFMeta(data: ArrayBuffer): Promise<{
+function getPDFMeta(
+  data: BinaryData | PDFDocumentProxy
+): Promise<{
   info: Record<string, any>
   metadata: Record<string, any>
 }>
@@ -110,7 +117,7 @@ function getPDFMeta(data: ArrayBuffer): Promise<{
 
 ```ts
 function extractPDFText(
-  data: ArrayBuffer,
+  data: BinaryData | PDFDocumentProxy,
   { mergePages }?: { mergePages?: boolean }
 ): Promise<{
   totalPages: number
@@ -122,7 +129,7 @@ function extractPDFText(
 
 ```ts
 function getImagesFromPage(
-  data: ArrayBuffer,
+  data: BinaryData | PDFDocumentProxy,
   pageNumber: number
 ): Promise<ArrayBuffer[]>
 ```

package/dist/index.node.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-const image = require('./shared/unpdf.3a651ae7.cjs');
-const utils = require('./shared/unpdf.15eec1ee.cjs');
+const image = require('./shared/unpdf.9511ac30.cjs');
+const utils = require('./shared/unpdf.61a2a4e1.cjs');
 
 const getPDFMeta = async (...args) => {
   await utils.resolvePDFJSImports();

package/dist/index.node.d.cts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.cjs';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.cjs';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.cjs';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.cjs';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.node.d.mts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.mjs';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.mjs';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.mjs';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.mjs';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.node.d.ts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.js';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.js';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.js';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.js';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.node.mjs

@@ -1,6 +1,6 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d5a4740d.mjs';
-import { r as resolvePDFJSImports } from './shared/unpdf.9db6f9f8.mjs';
-export { d as defineUnPDFConfig, g as getDocumentProxy, a as getResolvedPDFJS } from './shared/unpdf.9db6f9f8.mjs';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.cd67d475.mjs';
+import { r as resolvePDFJSImports } from './shared/unpdf.c7f36e56.mjs';
+export { d as defineUnPDFConfig, g as getDocumentProxy, a as getResolvedPDFJS } from './shared/unpdf.c7f36e56.mjs';
 
 const getPDFMeta = async (...args) => {
   await resolvePDFJSImports();

package/dist/index.web.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-const image = require('./shared/unpdf.3a651ae7.cjs');
-const utils = require('./shared/unpdf.15eec1ee.cjs');
+const image = require('./shared/unpdf.9511ac30.cjs');
+const utils = require('./shared/unpdf.61a2a4e1.cjs');
 
 const getPDFMeta = async (...args) => {
   await utils.resolvePDFJSImports();

package/dist/index.web.d.cts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.cjs';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.cjs';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.cjs';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.cjs';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.web.d.mts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.mjs';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.mjs';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.mjs';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.mjs';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.web.d.ts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.js';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.js';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.js';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.js';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.web.mjs

@@ -1,6 +1,6 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d5a4740d.mjs';
-import { r as resolvePDFJSImports } from './shared/unpdf.9db6f9f8.mjs';
-export { d as defineUnPDFConfig, g as getDocumentProxy, a as getResolvedPDFJS } from './shared/unpdf.9db6f9f8.mjs';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.cd67d475.mjs';
+import { r as resolvePDFJSImports } from './shared/unpdf.c7f36e56.mjs';
+export { d as defineUnPDFConfig, g as getDocumentProxy, a as getResolvedPDFJS } from './shared/unpdf.c7f36e56.mjs';
 
 const getPDFMeta = async (...args) => {
   await resolvePDFJSImports();

package/dist/index.worker.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const utils = require('./shared/unpdf.15eec1ee.cjs');
+const utils = require('./shared/unpdf.61a2a4e1.cjs');
 
 const getPDFMeta = async () => {
   throw new Error("Not implemented in worker context yet");

package/dist/index.worker.d.cts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.cjs';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.cjs';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.cjs';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.cjs';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.worker.d.mts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.mjs';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.mjs';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.mjs';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.mjs';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.worker.d.ts

@@ -1,5 +1,5 @@
-import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.3a0402b0.js';
-export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.3a0402b0.js';
+import { g as getPDFMeta$1, e as extractPDFText$1, a as getImagesFromPage$1 } from './shared/unpdf.d3d8f5ac.js';
+export { d as defineUnPDFConfig, b as getDocumentProxy, c as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.d3d8f5ac.js';
 import 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 

package/dist/index.worker.mjs

@@ -1,4 +1,4 @@
-export { d as defineUnPDFConfig, g as getDocumentProxy, a as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.9db6f9f8.mjs';
+export { d as defineUnPDFConfig, g as getDocumentProxy, a as getResolvedPDFJS, r as resolvePDFJSImports } from './shared/unpdf.c7f36e56.mjs';
 
 const getPDFMeta = async () => {
   throw new Error("Not implemented in worker context yet");

package/dist/shared/{unpdf.15eec1ee.cjs → unpdf.61a2a4e1.cjs}

@@ -1,13 +1,14 @@
 'use strict';
 
 let resolvedModule;
-async function getDocumentProxy(data) {
+async function getDocumentProxy(data, options = {}) {
   const { getDocument } = await getResolvedPDFJS();
   const pdf = await getDocument({
     data,
     useWorkerFetch: false,
+    isEvalSupported: false,
     useSystemFonts: true,
-    isEvalSupported: false
+    ...options
   }).promise;
   return pdf;
 }
@@ -26,9 +27,17 @@ async function getResolvedPDFJS() {
     await resolvePDFJSImports();
   return resolvedModule;
 }
-async function resolvePDFJSImports() {
+async function resolvePDFJSImports(pdfjs) {
   if (resolvedModule)
     return;
+  if (pdfjs) {
+    try {
+      const { default: mod } = await pdfjs();
+      resolvedModule = mod;
+    } catch (error) {
+      throw new Error("Resolving the PDF.js module failed. Please check your configuration.");
+    }
+  }
   try {
     const { default: mod } = await import('pdfjs-dist');
     resolvedModule = mod;
@@ -36,8 +45,12 @@ async function resolvePDFJSImports() {
     throw new Error("PDF.js is not available. Please add the package as a dependency.");
   }
 }
+function isPDFDocumentProxy(data) {
+  return typeof data === "object" && data !== null && "_pdfInfo" in data;
+}
 
 exports.defineUnPDFConfig = defineUnPDFConfig;
 exports.getDocumentProxy = getDocumentProxy;
 exports.getResolvedPDFJS = getResolvedPDFJS;
+exports.isPDFDocumentProxy = isPDFDocumentProxy;
 exports.resolvePDFJSImports = resolvePDFJSImports;

package/dist/shared/{unpdf.3a651ae7.cjs → unpdf.9511ac30.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-const utils = require('./unpdf.15eec1ee.cjs');
+const utils = require('./unpdf.61a2a4e1.cjs');
 
 async function getPDFMeta(data) {
-  const pdf = await utils.getDocumentProxy(data);
+  const pdf = utils.isPDFDocumentProxy(data) ? data : await utils.getDocumentProxy(data);
   const meta = await pdf.getMetadata().catch(() => null);
   return {
     info: meta?.info ?? {},
@@ -12,7 +12,7 @@ async function getPDFMeta(data) {
 }
 
 async function extractPDFText(data, { mergePages = false } = {}) {
-  const pdf = await utils.getDocumentProxy(data);
+  const pdf = utils.isPDFDocumentProxy(data) ? data : await utils.getDocumentProxy(data);
   const texts = await Promise.all(
     Array.from({ length: pdf.numPages }, (_, i) => getPageText(pdf, i + 1))
   );
@@ -32,7 +32,7 @@ async function getPageText(pdf, pageNumber) {
 }
 
 async function getImagesFromPage(data, pageNumber) {
-  const pdf = await utils.getDocumentProxy(data);
+  const pdf = utils.isPDFDocumentProxy(data) ? data : await utils.getDocumentProxy(data);
   const page = await pdf.getPage(pageNumber);
   const operatorList = await page.getOperatorList();
   const { OPS } = await utils.getResolvedPDFJS();

package/dist/shared/{unpdf.9db6f9f8.mjs → unpdf.c7f36e56.mjs}

@@ -1,11 +1,12 @@
 let resolvedModule;
-async function getDocumentProxy(data) {
+async function getDocumentProxy(data, options = {}) {
   const { getDocument } = await getResolvedPDFJS();
   const pdf = await getDocument({
     data,
     useWorkerFetch: false,
+    isEvalSupported: false,
     useSystemFonts: true,
-    isEvalSupported: false
+    ...options
   }).promise;
   return pdf;
 }
@@ -24,9 +25,17 @@ async function getResolvedPDFJS() {
     await resolvePDFJSImports();
   return resolvedModule;
 }
-async function resolvePDFJSImports() {
+async function resolvePDFJSImports(pdfjs) {
   if (resolvedModule)
     return;
+  if (pdfjs) {
+    try {
+      const { default: mod } = await pdfjs();
+      resolvedModule = mod;
+    } catch (error) {
+      throw new Error("Resolving the PDF.js module failed. Please check your configuration.");
+    }
+  }
   try {
     const { default: mod } = await import('pdfjs-dist');
     resolvedModule = mod;
@@ -34,5 +43,8 @@ async function resolvePDFJSImports() {
     throw new Error("PDF.js is not available. Please add the package as a dependency.");
   }
 }
+function isPDFDocumentProxy(data) {
+  return typeof data === "object" && data !== null && "_pdfInfo" in data;
+}
 
-export { getResolvedPDFJS as a, defineUnPDFConfig as d, getDocumentProxy as g, resolvePDFJSImports as r };
+export { getResolvedPDFJS as a, defineUnPDFConfig as d, getDocumentProxy as g, isPDFDocumentProxy as i, resolvePDFJSImports as r };

package/dist/shared/{unpdf.d5a4740d.mjs → unpdf.cd67d475.mjs}

@@ -1,7 +1,7 @@
-import { g as getDocumentProxy, a as getResolvedPDFJS } from './unpdf.9db6f9f8.mjs';
+import { i as isPDFDocumentProxy, g as getDocumentProxy, a as getResolvedPDFJS } from './unpdf.c7f36e56.mjs';
 
 async function getPDFMeta(data) {
-  const pdf = await getDocumentProxy(data);
+  const pdf = isPDFDocumentProxy(data) ? data : await getDocumentProxy(data);
   const meta = await pdf.getMetadata().catch(() => null);
   return {
     info: meta?.info ?? {},
@@ -10,7 +10,7 @@ async function getPDFMeta(data) {
 }
 
 async function extractPDFText(data, { mergePages = false } = {}) {
-  const pdf = await getDocumentProxy(data);
+  const pdf = isPDFDocumentProxy(data) ? data : await getDocumentProxy(data);
   const texts = await Promise.all(
     Array.from({ length: pdf.numPages }, (_, i) => getPageText(pdf, i + 1))
   );
@@ -30,7 +30,7 @@ async function getPageText(pdf, pageNumber) {
 }
 
 async function getImagesFromPage(data, pageNumber) {
-  const pdf = await getDocumentProxy(data);
+  const pdf = isPDFDocumentProxy(data) ? data : await getDocumentProxy(data);
   const page = await pdf.getPage(pageNumber);
   const operatorList = await page.getOperatorList();
   const { OPS } = await getResolvedPDFJS();

package/dist/shared/{unpdf.3a0402b0.d.cts → unpdf.d3d8f5ac.d.cts}

@@ -1,19 +1,19 @@
-import * as pdfjs_dist_types_src_display_api from 'pdfjs-dist/types/src/display/api';
+import { BinaryData, PDFDocumentProxy, DocumentInitParameters } from 'pdfjs-dist/types/src/display/api';
 import PDFJS from 'pdfjs-dist';
 
-declare function getPDFMeta(data: ArrayBuffer): Promise<{
+declare function getPDFMeta(data: BinaryData | PDFDocumentProxy): Promise<{
     info: Record<string, any>;
     metadata: Record<string, any>;
 }>;
 
-declare function extractPDFText(data: ArrayBuffer, { mergePages }?: {
+declare function extractPDFText(data: BinaryData | PDFDocumentProxy, { mergePages }?: {
     mergePages?: boolean;
 }): Promise<{
     totalPages: number;
     text: string | string[];
 }>;
 
-declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
+declare function getImagesFromPage(data: BinaryData | PDFDocumentProxy, pageNumber: number): Promise<ArrayBuffer[]>;
 
 interface UnPDFConfiguration {
     /**
@@ -27,9 +27,17 @@ interface UnPDFConfiguration {
     pdfjs?: () => Promise<typeof PDFJS>;
 }
 
-declare function getDocumentProxy(data: ArrayBuffer): Promise<pdfjs_dist_types_src_display_api.PDFDocumentProxy>;
+/**
+ * Returns a PDFDocumentProxy instance from a given binary data.
+ *
+ * Applies the following defaults:
+ * - `useWorkerFetch: false`
+ * - `isEvalSupported: false`
+ * - `useSystemFonts: true`
+ */
+declare function getDocumentProxy(data: BinaryData, options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
 declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
 declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
-declare function resolvePDFJSImports(): Promise<void>;
+declare function resolvePDFJSImports(pdfjs?: () => Promise<typeof PDFJS>): Promise<void>;
 
 export { getImagesFromPage as a, getDocumentProxy as b, getResolvedPDFJS as c, defineUnPDFConfig as d, extractPDFText as e, getPDFMeta as g, resolvePDFJSImports as r };

package/dist/shared/{unpdf.3a0402b0.d.mts → unpdf.d3d8f5ac.d.mts}

@@ -1,19 +1,19 @@
-import * as pdfjs_dist_types_src_display_api from 'pdfjs-dist/types/src/display/api';
+import { BinaryData, PDFDocumentProxy, DocumentInitParameters } from 'pdfjs-dist/types/src/display/api';
 import PDFJS from 'pdfjs-dist';
 
-declare function getPDFMeta(data: ArrayBuffer): Promise<{
+declare function getPDFMeta(data: BinaryData | PDFDocumentProxy): Promise<{
     info: Record<string, any>;
     metadata: Record<string, any>;
 }>;
 
-declare function extractPDFText(data: ArrayBuffer, { mergePages }?: {
+declare function extractPDFText(data: BinaryData | PDFDocumentProxy, { mergePages }?: {
     mergePages?: boolean;
 }): Promise<{
     totalPages: number;
     text: string | string[];
 }>;
 
-declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
+declare function getImagesFromPage(data: BinaryData | PDFDocumentProxy, pageNumber: number): Promise<ArrayBuffer[]>;
 
 interface UnPDFConfiguration {
     /**
@@ -27,9 +27,17 @@ interface UnPDFConfiguration {
     pdfjs?: () => Promise<typeof PDFJS>;
 }
 
-declare function getDocumentProxy(data: ArrayBuffer): Promise<pdfjs_dist_types_src_display_api.PDFDocumentProxy>;
+/**
+ * Returns a PDFDocumentProxy instance from a given binary data.
+ *
+ * Applies the following defaults:
+ * - `useWorkerFetch: false`
+ * - `isEvalSupported: false`
+ * - `useSystemFonts: true`
+ */
+declare function getDocumentProxy(data: BinaryData, options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
 declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
 declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
-declare function resolvePDFJSImports(): Promise<void>;
+declare function resolvePDFJSImports(pdfjs?: () => Promise<typeof PDFJS>): Promise<void>;
 
 export { getImagesFromPage as a, getDocumentProxy as b, getResolvedPDFJS as c, defineUnPDFConfig as d, extractPDFText as e, getPDFMeta as g, resolvePDFJSImports as r };

package/dist/shared/{unpdf.3a0402b0.d.ts → unpdf.d3d8f5ac.d.ts}

@@ -1,19 +1,19 @@
-import * as pdfjs_dist_types_src_display_api from 'pdfjs-dist/types/src/display/api';
+import { BinaryData, PDFDocumentProxy, DocumentInitParameters } from 'pdfjs-dist/types/src/display/api';
 import PDFJS from 'pdfjs-dist';
 
-declare function getPDFMeta(data: ArrayBuffer): Promise<{
+declare function getPDFMeta(data: BinaryData | PDFDocumentProxy): Promise<{
     info: Record<string, any>;
     metadata: Record<string, any>;
 }>;
 
-declare function extractPDFText(data: ArrayBuffer, { mergePages }?: {
+declare function extractPDFText(data: BinaryData | PDFDocumentProxy, { mergePages }?: {
     mergePages?: boolean;
 }): Promise<{
     totalPages: number;
     text: string | string[];
 }>;
 
-declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
+declare function getImagesFromPage(data: BinaryData | PDFDocumentProxy, pageNumber: number): Promise<ArrayBuffer[]>;
 
 interface UnPDFConfiguration {
     /**
@@ -27,9 +27,17 @@ interface UnPDFConfiguration {
     pdfjs?: () => Promise<typeof PDFJS>;
 }
 
-declare function getDocumentProxy(data: ArrayBuffer): Promise<pdfjs_dist_types_src_display_api.PDFDocumentProxy>;
+/**
+ * Returns a PDFDocumentProxy instance from a given binary data.
+ *
+ * Applies the following defaults:
+ * - `useWorkerFetch: false`
+ * - `isEvalSupported: false`
+ * - `useSystemFonts: true`
+ */
+declare function getDocumentProxy(data: BinaryData, options?: DocumentInitParameters): Promise<PDFDocumentProxy>;
 declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
 declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
-declare function resolvePDFJSImports(): Promise<void>;
+declare function resolvePDFJSImports(pdfjs?: () => Promise<typeof PDFJS>): Promise<void>;
 
 export { getImagesFromPage as a, getDocumentProxy as b, getResolvedPDFJS as c, defineUnPDFConfig as d, extractPDFText as e, getPDFMeta as g, resolvePDFJSImports as r };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unpdf",
   "type": "module",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "packageManager": "pnpm@8.6.12",
   "description": "Utilities to work with PDFs, like extracting text",
   "author": "Johann Schopplich <pkg@johannschopplich.com>",