pdfjs-serverless 1.2.2 → 1.3.0

package/README.md

@@ -2,12 +2,10 @@
 
 A redistribution of Mozilla's [PDF.js](https://github.com/mozilla/pdf.js) as a single bundle for edge and serverless runtimes, like Cloudflare Workers. Use it as a drop-in replacement for `pdfjs-dist` to parse PDF documents and extract text content – no extra dependencies needed.
 
-The whole export is about 1.6 MB (minified).
+The whole export is about 1.6 MB (minified) and ships the complete PDF.js type declarations.
 
 ## Installation
 
-Run the following command to add `pdfjs-serverless` to your project.
-
 ```bash
 # pnpm
 pnpm add pdfjs-serverless
@@ -74,17 +72,18 @@ export default {
 }
 ```
 
+Ready-to-run examples for Cloudflare Workers and Pages Functions live in [`examples/`](./examples).
+
 ## How It Works
 
 > [!NOTE]
 > `pdfjs-serverless` is currently built from PDF.js v5.6.205.
 
-Heart and soul of this package is the [`rollup.config.ts`](./rollup.config.ts) file. It uses [Rollup](https://rollupjs.org/) to bundle PDF.js into a single file for serverless environments. The key techniques:
+Heart and soul of this package is the [`rolldown.config.ts`](./rolldown.config.ts) file. It uses [Rolldown](https://rolldown.rs/) to bundle PDF.js into a single file for serverless environments. The key techniques:
 
-- **String replacements** strip browser-specific references (e.g. `typeof window`) from the PDF.js source.
-- **Node.js compatibility** is enforced by mocking `@napi-rs/canvas` and setting `isNodeJS` to `true` – paradoxical, but it unlocks the right code paths.
+- **String replacements** rewrite the environment detection: `isNodeJS` becomes `typeof window === "undefined"`, so serverless runtimes take the Node.js code paths – paradoxical, but it unlocks the right branches. The `@napi-rs/canvas` import is bridged to `globalThis[Symbol.for("pdfjs-serverless.canvasModule")]` – assign an API-compatible canvas module to that symbol to enable rendering, otherwise accessing it throws a descriptive error.
 - **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 `FinalizationRegistry` (unavailable in Cloudflare Workers).
+- **Mocks and polyfills** provide missing globals: `DOMMatrix`, `navigator` and `FinalizationRegistry` are stubbed in [`src/mocks.mjs`](./src/mocks.mjs); `Promise.withResolvers`, `Uint8Array.prototype.toHex` and friends are polyfilled in [`src/polyfills.mjs`](./src/polyfills.mjs).
 
 ## Inspiration