unpdf 0.4.1 → 0.5.1

package/README.md

@@ -1,16 +1,16 @@
 # unpdf
 
-A collection of utilities to work with PDFs. Uses Mozilla's [PDF.js](https://github.com/mozilla/pdf.js) under the hood.
+A collection of utilities to work with PDFs. Uses Mozilla's [PDF.js](https://github.com/mozilla/pdf.js) under the hood and lazily initializes the library.
 
-`unpdf` takes advantage of [export conditions](https://nodejs.org/api/packages.html#packages_conditional_exports) to circumvent build issues in serverless environments. PDF.js depends on the optional `canvas` module, which [doesn't work inside worker threads](https://github.com/Automattic/node-canvas/issues/1394).
+`unpdf` takes advantage of [export conditions](https://nodejs.org/api/packages.html#packages_conditional_exports) to circumvent build issues in serverless environments. For example, PDF.js depends on the optional `canvas` module, which [doesn't work inside worker threads](https://github.com/Automattic/node-canvas/issues/1394).
 
-This library is also intended as a modern alternative to the unmaintained [`pdf-parse`](https://www.npmjs.com/package/pdf-parse).
+This library is also intended as a modern alternative to the unmaintained but still popular [`pdf-parse`](https://www.npmjs.com/package/pdf-parse).
 
 ## Features
 
 - 🏗️ Conditional exports for Browser, Node and worker environments
 - 💬 Extract text from PDFs
-- 🧱 Use custom PDF.js build
+- 🧱 Opt-in to legacy PDF.js build
 
 ## Installation
 
@@ -18,27 +18,51 @@ Run the following command to add `unpdf` to your project.
 
 ```bash
 # pnpm
-pnpm add -D unpdf
+pnpm add unpdf
 
 # npm
-npm install -D unpdf
+npm install unpdf
 
 # yarn
-yarn add -D unpdf
+yarn add unpdf
 ```
 
 ## Usage
 
 ```ts
-import { decodePDFText } from 'unpdf'
+import { extractPDFText } from 'unpdf'
 
-const pdfBuffer = await fetch('https://example.com/file.pdf').then(res => res.arrayBuffer())
+const pdfBuffer = await fetch('https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf')
+  .then(res => res.arrayBuffer())
 
-const { totalPages, info, metadata, text } = await decodePDFText(
+const { totalPages, text } = await extractPDFText(
   new Uint8Array(pdfBuffer), { mergePages: true }
 )
 ```
 
+### Use Legacy Or Custom PDF.js Build
+
+```ts
+// Before using any other methods, define the PDF.js module
+import { defineUnPDFConfig } from 'unpdf'
+
+// Use the legacy build
+defineUnPDFConfig({
+  pdfjs: () => import('pdfjs-dist/legacy/build/pdf.js')
+})
+
+// Now, you can use the other methods
+// …
+```
+
+### Access the PDF.js Module
+
+```ts
+import { getResolvedPDFJS } from 'unpdf'
+
+const { version } = await getResolvedPDFJS()
+```
+
 ## Config
 
 ```ts
@@ -59,24 +83,39 @@ interface UnPDFConfiguration {
 
 ### `defineUnPDFConfig`
 
+Define a custom PDF.js module, like the legacy build.
+
 ```ts
 function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>
 ```
 
-### `decodePDFText`
+### `getResolvedPDFJS`
+
+Returns the resolved PDF.js module.
 
 ```ts
-interface PDFContent {
-  totalPages: number
-  info?: Record<string, any>
-  metadata?: any
-  text: string | string[]
-}
+function getResolvedPDFJS(): Promise<typeof import('pdfjs-dist')>
+```
+
+### `getPDFMeta`
+
+```ts
+function getPDFMeta(data: ArrayBuffer): Promise<{
+  info: Record<string, any>
+  metadata: Record<string, any>
+}>
+```
+
+### `extractPDFText`
 
-function decodePDFText(
+```ts
+function extractPDFText(
   data: ArrayBuffer,
   { mergePages }?: { mergePages?: boolean }
-): Promise<PDFContent>
+): Promise<{
+  totalPages: number
+  text: string | string[]
+}>
 ```
 
 ### `getImagesFromPage`

package/dist/index.node.cjs

@@ -1,11 +1,15 @@
 'use strict';
 
-const image = require('./shared/unpdf.ff73f2a9.cjs');
-const utils = require('./shared/unpdf.54007d6f.cjs');
+const image = require('./shared/unpdf.3a651ae7.cjs');
+const utils = require('./shared/unpdf.15eec1ee.cjs');
 
-const decodePDFText = async (...args) => {
+const getPDFMeta = async (...args) => {
   await utils.resolvePDFJSImports();
-  return await image.decodePDFText(...args);
+  return await image.getPDFMeta(...args);
+};
+const extractPDFText = async (...args) => {
+  await utils.resolvePDFJSImports();
+  return await image.extractPDFText(...args);
 };
 const getImagesFromPage = async (...args) => {
   await utils.resolvePDFJSImports();
@@ -13,5 +17,9 @@ const getImagesFromPage = async (...args) => {
 };
 
 exports.defineUnPDFConfig = utils.defineUnPDFConfig;
-exports.decodePDFText = decodePDFText;
+exports.getDocumentProxy = utils.getDocumentProxy;
+exports.getResolvedPDFJS = utils.getResolvedPDFJS;
+exports.resolvePDFJSImports = utils.resolvePDFJSImports;
+exports.extractPDFText = extractPDFText;
 exports.getImagesFromPage = getImagesFromPage;
+exports.getPDFMeta = getPDFMeta;

package/dist/index.node.d.cts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.cjs';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.cjs';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.node.d.mts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.mjs';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.mjs';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.node.d.ts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.js';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.js';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.node.mjs

@@ -1,14 +1,18 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.0f3aa1eb.mjs';
-import { r as resolvePDFJSImports } from './shared/unpdf.5b4a24ed.mjs';
-export { d as defineUnPDFConfig } from './shared/unpdf.5b4a24ed.mjs';
+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';
 
-const decodePDFText = async (...args) => {
+const getPDFMeta = async (...args) => {
   await resolvePDFJSImports();
-  return await decodePDFText$1(...args);
+  return await getPDFMeta$1(...args);
+};
+const extractPDFText = async (...args) => {
+  await resolvePDFJSImports();
+  return await extractPDFText$1(...args);
 };
 const getImagesFromPage = async (...args) => {
   await resolvePDFJSImports();
   return await getImagesFromPage$1(...args);
 };
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta, resolvePDFJSImports };

package/dist/index.web.cjs

@@ -1,11 +1,15 @@
 'use strict';
 
-const image = require('./shared/unpdf.ff73f2a9.cjs');
-const utils = require('./shared/unpdf.54007d6f.cjs');
+const image = require('./shared/unpdf.3a651ae7.cjs');
+const utils = require('./shared/unpdf.15eec1ee.cjs');
 
-const decodePDFText = async (...args) => {
+const getPDFMeta = async (...args) => {
   await utils.resolvePDFJSImports();
-  return await image.decodePDFText(...args);
+  return await image.getPDFMeta(...args);
+};
+const extractPDFText = async (...args) => {
+  await utils.resolvePDFJSImports();
+  return await image.extractPDFText(...args);
 };
 const getImagesFromPage = async (...args) => {
   await utils.resolvePDFJSImports();
@@ -13,5 +17,9 @@ const getImagesFromPage = async (...args) => {
 };
 
 exports.defineUnPDFConfig = utils.defineUnPDFConfig;
-exports.decodePDFText = decodePDFText;
+exports.getDocumentProxy = utils.getDocumentProxy;
+exports.getResolvedPDFJS = utils.getResolvedPDFJS;
+exports.resolvePDFJSImports = utils.resolvePDFJSImports;
+exports.extractPDFText = extractPDFText;
 exports.getImagesFromPage = getImagesFromPage;
+exports.getPDFMeta = getPDFMeta;

package/dist/index.web.d.cts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.cjs';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.cjs';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.web.d.mts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.mjs';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.mjs';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.web.d.ts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.js';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.js';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.web.mjs

@@ -1,14 +1,18 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.0f3aa1eb.mjs';
-import { r as resolvePDFJSImports } from './shared/unpdf.5b4a24ed.mjs';
-export { d as defineUnPDFConfig } from './shared/unpdf.5b4a24ed.mjs';
+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';
 
-const decodePDFText = async (...args) => {
+const getPDFMeta = async (...args) => {
   await resolvePDFJSImports();
-  return await decodePDFText$1(...args);
+  return await getPDFMeta$1(...args);
+};
+const extractPDFText = async (...args) => {
+  await resolvePDFJSImports();
+  return await extractPDFText$1(...args);
 };
 const getImagesFromPage = async (...args) => {
   await resolvePDFJSImports();
   return await getImagesFromPage$1(...args);
 };
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta, resolvePDFJSImports };

package/dist/index.worker.cjs

@@ -1,8 +1,11 @@
 'use strict';
 
-const utils = require('./shared/unpdf.54007d6f.cjs');
+const utils = require('./shared/unpdf.15eec1ee.cjs');
 
-const decodePDFText = async () => {
+const getPDFMeta = async () => {
+  throw new Error("Not implemented in worker context yet");
+};
+const extractPDFText = async () => {
   throw new Error("Not implemented in worker context yet");
 };
 const getImagesFromPage = async () => {
@@ -10,5 +13,9 @@ const getImagesFromPage = async () => {
 };
 
 exports.defineUnPDFConfig = utils.defineUnPDFConfig;
-exports.decodePDFText = decodePDFText;
+exports.getDocumentProxy = utils.getDocumentProxy;
+exports.getResolvedPDFJS = utils.getResolvedPDFJS;
+exports.resolvePDFJSImports = utils.resolvePDFJSImports;
+exports.extractPDFText = extractPDFText;
 exports.getImagesFromPage = getImagesFromPage;
+exports.getPDFMeta = getPDFMeta;

package/dist/index.worker.d.cts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.cjs';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.cjs';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.worker.d.mts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.mjs';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.mjs';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.worker.d.ts

@@ -1,8 +1,10 @@
-import { d as decodePDFText$1, g as getImagesFromPage$1 } from './shared/unpdf.72be7352.js';
-export { a as defineUnPDFConfig } from './shared/unpdf.72be7352.js';
+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 'pdfjs-dist/types/src/display/api';
 import 'pdfjs-dist';
 
-declare const decodePDFText: typeof decodePDFText$1;
+declare const getPDFMeta: typeof getPDFMeta$1;
+declare const extractPDFText: typeof extractPDFText$1;
 declare const getImagesFromPage: typeof getImagesFromPage$1;
 
-export { decodePDFText, getImagesFromPage };
+export { extractPDFText, getImagesFromPage, getPDFMeta };

package/dist/index.worker.mjs

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

package/dist/shared/{unpdf.54007d6f.cjs → unpdf.15eec1ee.cjs}

@@ -2,7 +2,7 @@
 
 let resolvedModule;
 async function getDocumentProxy(data) {
-  const { getDocument } = getResolvedPDFJS();
+  const { getDocument } = await getResolvedPDFJS();
   const pdf = await getDocument({
     data,
     useWorkerFetch: false,
@@ -21,7 +21,9 @@ async function defineUnPDFConfig({ pdfjs }) {
     }
   }
 }
-function getResolvedPDFJS() {
+async function getResolvedPDFJS() {
+  if (!resolvedModule)
+    await resolvePDFJSImports();
   return resolvedModule;
 }
 async function resolvePDFJSImports() {

package/dist/shared/unpdf.3a0402b0.d.cts

@@ -0,0 +1,35 @@
+import * as pdfjs_dist_types_src_display_api from 'pdfjs-dist/types/src/display/api';
+import PDFJS from 'pdfjs-dist';
+
+declare function getPDFMeta(data: ArrayBuffer): Promise<{
+    info: Record<string, any>;
+    metadata: Record<string, any>;
+}>;
+
+declare function extractPDFText(data: ArrayBuffer, { mergePages }?: {
+    mergePages?: boolean;
+}): Promise<{
+    totalPages: number;
+    text: string | string[];
+}>;
+
+declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
+
+interface UnPDFConfiguration {
+    /**
+     * By default, UnPDF will use the latest version of PDF.js. If you want to
+     * use an older version or the legacy build, set a promise that resolves to
+     * the PDF.js module.
+     *
+     * @example
+     * () => import('pdfjs-dist/legacy/build/pdf.js')
+     */
+    pdfjs?: () => Promise<typeof PDFJS>;
+}
+
+declare function getDocumentProxy(data: ArrayBuffer): Promise<pdfjs_dist_types_src_display_api.PDFDocumentProxy>;
+declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
+declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
+declare function resolvePDFJSImports(): 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

@@ -0,0 +1,35 @@
+import * as pdfjs_dist_types_src_display_api from 'pdfjs-dist/types/src/display/api';
+import PDFJS from 'pdfjs-dist';
+
+declare function getPDFMeta(data: ArrayBuffer): Promise<{
+    info: Record<string, any>;
+    metadata: Record<string, any>;
+}>;
+
+declare function extractPDFText(data: ArrayBuffer, { mergePages }?: {
+    mergePages?: boolean;
+}): Promise<{
+    totalPages: number;
+    text: string | string[];
+}>;
+
+declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
+
+interface UnPDFConfiguration {
+    /**
+     * By default, UnPDF will use the latest version of PDF.js. If you want to
+     * use an older version or the legacy build, set a promise that resolves to
+     * the PDF.js module.
+     *
+     * @example
+     * () => import('pdfjs-dist/legacy/build/pdf.js')
+     */
+    pdfjs?: () => Promise<typeof PDFJS>;
+}
+
+declare function getDocumentProxy(data: ArrayBuffer): Promise<pdfjs_dist_types_src_display_api.PDFDocumentProxy>;
+declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
+declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
+declare function resolvePDFJSImports(): 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

@@ -0,0 +1,35 @@
+import * as pdfjs_dist_types_src_display_api from 'pdfjs-dist/types/src/display/api';
+import PDFJS from 'pdfjs-dist';
+
+declare function getPDFMeta(data: ArrayBuffer): Promise<{
+    info: Record<string, any>;
+    metadata: Record<string, any>;
+}>;
+
+declare function extractPDFText(data: ArrayBuffer, { mergePages }?: {
+    mergePages?: boolean;
+}): Promise<{
+    totalPages: number;
+    text: string | string[];
+}>;
+
+declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
+
+interface UnPDFConfiguration {
+    /**
+     * By default, UnPDF will use the latest version of PDF.js. If you want to
+     * use an older version or the legacy build, set a promise that resolves to
+     * the PDF.js module.
+     *
+     * @example
+     * () => import('pdfjs-dist/legacy/build/pdf.js')
+     */
+    pdfjs?: () => Promise<typeof PDFJS>;
+}
+
+declare function getDocumentProxy(data: ArrayBuffer): Promise<pdfjs_dist_types_src_display_api.PDFDocumentProxy>;
+declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
+declare function getResolvedPDFJS(): Promise<typeof PDFJS>;
+declare function resolvePDFJSImports(): 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.ff73f2a9.cjs → unpdf.3a651ae7.cjs}

@@ -1,18 +1,24 @@
 'use strict';
 
-const utils = require('./unpdf.54007d6f.cjs');
+const utils = require('./unpdf.15eec1ee.cjs');
 
-async function decodePDFText(data, { mergePages = false } = {}) {
+async function getPDFMeta(data) {
   const pdf = await utils.getDocumentProxy(data);
   const meta = await pdf.getMetadata().catch(() => null);
+  return {
+    info: meta?.info ?? {},
+    metadata: meta?.metadata?.getAll() ?? {}
+  };
+}
+
+async function extractPDFText(data, { mergePages = false } = {}) {
+  const pdf = await utils.getDocumentProxy(data);
   const texts = await Promise.all(
     Array.from({ length: pdf.numPages }, (_, i) => getPageText(pdf, i + 1))
   );
   const filteredTexts = texts.filter(Boolean);
   return {
     totalPages: pdf.numPages,
-    info: meta?.info,
-    metadata: meta?.metadata?.getAll(),
     text: mergePages ? filteredTexts.join("\n\n") : filteredTexts
   };
 }
@@ -29,7 +35,7 @@ async function getImagesFromPage(data, pageNumber) {
   const pdf = await utils.getDocumentProxy(data);
   const page = await pdf.getPage(pageNumber);
   const operatorList = await page.getOperatorList();
-  const { OPS } = utils.getResolvedPDFJS();
+  const { OPS } = await utils.getResolvedPDFJS();
   const images = [];
   for (const op of operatorList.fnArray) {
     if (op !== OPS.paintImageXObject)
@@ -41,5 +47,6 @@ async function getImagesFromPage(data, pageNumber) {
   return images;
 }
 
-exports.decodePDFText = decodePDFText;
+exports.extractPDFText = extractPDFText;
 exports.getImagesFromPage = getImagesFromPage;
+exports.getPDFMeta = getPDFMeta;

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

@@ -1,6 +1,6 @@
 let resolvedModule;
 async function getDocumentProxy(data) {
-  const { getDocument } = getResolvedPDFJS();
+  const { getDocument } = await getResolvedPDFJS();
   const pdf = await getDocument({
     data,
     useWorkerFetch: false,
@@ -19,7 +19,9 @@ async function defineUnPDFConfig({ pdfjs }) {
     }
   }
 }
-function getResolvedPDFJS() {
+async function getResolvedPDFJS() {
+  if (!resolvedModule)
+    await resolvePDFJSImports();
   return resolvedModule;
 }
 async function resolvePDFJSImports() {

package/dist/shared/{unpdf.0f3aa1eb.mjs → unpdf.d5a4740d.mjs}

@@ -1,16 +1,22 @@
-import { g as getDocumentProxy, a as getResolvedPDFJS } from './unpdf.5b4a24ed.mjs';
+import { g as getDocumentProxy, a as getResolvedPDFJS } from './unpdf.9db6f9f8.mjs';
 
-async function decodePDFText(data, { mergePages = false } = {}) {
+async function getPDFMeta(data) {
   const pdf = await getDocumentProxy(data);
   const meta = await pdf.getMetadata().catch(() => null);
+  return {
+    info: meta?.info ?? {},
+    metadata: meta?.metadata?.getAll() ?? {}
+  };
+}
+
+async function extractPDFText(data, { mergePages = false } = {}) {
+  const pdf = await getDocumentProxy(data);
   const texts = await Promise.all(
     Array.from({ length: pdf.numPages }, (_, i) => getPageText(pdf, i + 1))
   );
   const filteredTexts = texts.filter(Boolean);
   return {
     totalPages: pdf.numPages,
-    info: meta?.info,
-    metadata: meta?.metadata?.getAll(),
     text: mergePages ? filteredTexts.join("\n\n") : filteredTexts
   };
 }
@@ -27,7 +33,7 @@ async function getImagesFromPage(data, pageNumber) {
   const pdf = await getDocumentProxy(data);
   const page = await pdf.getPage(pageNumber);
   const operatorList = await page.getOperatorList();
-  const { OPS } = getResolvedPDFJS();
+  const { OPS } = await getResolvedPDFJS();
   const images = [];
   for (const op of operatorList.fnArray) {
     if (op !== OPS.paintImageXObject)
@@ -39,4 +45,4 @@ async function getImagesFromPage(data, pageNumber) {
   return images;
 }
 
-export { decodePDFText as d, getImagesFromPage as g };
+export { getImagesFromPage as a, extractPDFText as e, getPDFMeta as g };

package/package.json

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

package/dist/shared/unpdf.72be7352.d.cts

@@ -1,29 +0,0 @@
-import PDFJS from 'pdfjs-dist';
-
-interface PDFContent {
-    totalPages: number;
-    info?: Record<string, any>;
-    metadata?: any;
-    text: string | string[];
-}
-interface UnPDFConfiguration {
-    /**
-     * By default, UnPDF will use the latest version of PDF.js. If you want to
-     * use an older version or the legacy build, set a promise that resolves to
-     * the PDF.js module.
-     *
-     * @example
-     * () => import('pdfjs-dist/legacy/build/pdf.js')
-     */
-    pdfjs?: () => Promise<typeof PDFJS>;
-}
-
-declare function decodePDFText(data: ArrayBuffer, { mergePages }?: {
-    mergePages?: boolean;
-}): Promise<PDFContent>;
-
-declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
-
-declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
-
-export { defineUnPDFConfig as a, decodePDFText as d, getImagesFromPage as g };

package/dist/shared/unpdf.72be7352.d.mts

@@ -1,29 +0,0 @@
-import PDFJS from 'pdfjs-dist';
-
-interface PDFContent {
-    totalPages: number;
-    info?: Record<string, any>;
-    metadata?: any;
-    text: string | string[];
-}
-interface UnPDFConfiguration {
-    /**
-     * By default, UnPDF will use the latest version of PDF.js. If you want to
-     * use an older version or the legacy build, set a promise that resolves to
-     * the PDF.js module.
-     *
-     * @example
-     * () => import('pdfjs-dist/legacy/build/pdf.js')
-     */
-    pdfjs?: () => Promise<typeof PDFJS>;
-}
-
-declare function decodePDFText(data: ArrayBuffer, { mergePages }?: {
-    mergePages?: boolean;
-}): Promise<PDFContent>;
-
-declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
-
-declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
-
-export { defineUnPDFConfig as a, decodePDFText as d, getImagesFromPage as g };

package/dist/shared/unpdf.72be7352.d.ts

@@ -1,29 +0,0 @@
-import PDFJS from 'pdfjs-dist';
-
-interface PDFContent {
-    totalPages: number;
-    info?: Record<string, any>;
-    metadata?: any;
-    text: string | string[];
-}
-interface UnPDFConfiguration {
-    /**
-     * By default, UnPDF will use the latest version of PDF.js. If you want to
-     * use an older version or the legacy build, set a promise that resolves to
-     * the PDF.js module.
-     *
-     * @example
-     * () => import('pdfjs-dist/legacy/build/pdf.js')
-     */
-    pdfjs?: () => Promise<typeof PDFJS>;
-}
-
-declare function decodePDFText(data: ArrayBuffer, { mergePages }?: {
-    mergePages?: boolean;
-}): Promise<PDFContent>;
-
-declare function getImagesFromPage(data: ArrayBuffer, pageNumber: number): Promise<ArrayBuffer[]>;
-
-declare function defineUnPDFConfig({ pdfjs }: UnPDFConfiguration): Promise<void>;
-
-export { defineUnPDFConfig as a, decodePDFText as d, getImagesFromPage as g };