Files

alam00000 2c85ca74e9 feat: separate AGPL libraries and add dynamic WASM loading

- Add WASM settings page for configuring external AGPL modules
- Implement dynamic loading for PyMuPDF, Ghostscript, and CoherentPDF
- Add Cloudflare Worker proxy for serving WASM files with CORS
- Update all affected tool pages to check WASM availability
- Add showWasmRequiredDialog for missing module configuration

Documentation:
- Update README, licensing.html, and docs to clarify AGPL components
  are not bundled and must be configured separately
- Add WASM-PROXY.md deployment guide with recommended source URLs
- Rename "CPDF" to "CoherentPDF" for consistency

2026-01-27 15:26:26 +05:30

3.0 KiB

Raw Blame History

WASM Proxy Setup Guide

BentoPDF uses a Cloudflare Worker to proxy WASM library requests, bypassing CORS restrictions when loading AGPL-licensed components (PyMuPDF, Ghostscript, CoherentPDF) from external sources.

Quick Start

1. Deploy the Worker

cd cloudflare
npx wrangler login
npx wrangler deploy -c wasm-wrangler.toml

2. Configure Source URLs

Set environment secrets with the base URLs for your WASM files:

# Option A: Interactive prompts
npx wrangler secret put PYMUPDF_SOURCE -c wasm-wrangler.toml
npx wrangler secret put GS_SOURCE -c wasm-wrangler.toml
npx wrangler secret put CPDF_SOURCE -c wasm-wrangler.toml

# Option B: Set via Cloudflare Dashboard
# Go to Workers & Pages > bentopdf-wasm-proxy > Settings > Variables

Recommended Source URLs:

PYMUPDF_SOURCE: https://cdn.jsdelivr.net/npm/@bentopdf/pymupdf-wasm@0.1.9/
GS_SOURCE: https://cdn.jsdelivr.net/npm/@bentopdf/gs-wasm/assets/
CPDF_SOURCE: https://cdn.jsdelivr.net/npm/coherentpdf/dist/

Note: You can use your own hosted WASM files instead of the recommended URLs. Just ensure your files match the expected directory structure and file names that BentoPDF expects for each module.

3. Configure BentoPDF

In BentoPDF's Advanced Settings (wasm-settings.html), enter:

Module	URL
PyMuPDF	`https://bentopdf-wasm-proxy.<your-subdomain>.workers.dev/pymupdf/`
Ghostscript	`https://bentopdf-wasm-proxy.<your-subdomain>.workers.dev/gs/`
CoherentPDF	`https://bentopdf-wasm-proxy.<your-subdomain>.workers.dev/cpdf/`

Custom Domain (Optional)

To use a custom domain like wasm.bentopdf.com:

Add route in wasm-wrangler.toml:

routes = [
  { pattern = "wasm.bentopdf.com/*", zone_name = "bentopdf.com" }
]

Add DNS record in Cloudflare:
- Type: AAAA
- Name: wasm
- Content: 100::
- Proxied: Yes
Redeploy:

npx wrangler deploy -c wasm-wrangler.toml

Security Features

Origin validation: Only allows requests from configured origins
Rate limiting: 100 requests/minute per IP (requires KV namespace)
File type restrictions: Only WASM-related files (.js, .wasm, .data, etc.)
Size limits: Max 100MB per file
Caching: Reduces origin requests and improves performance

Self-Hosting Notes

Update ALLOWED_ORIGINS in wasm-proxy-worker.js to include your domain
Host your WASM files on any origin (R2, S3, or any CDN)
Set source URLs as secrets in your worker

Endpoints

Endpoint	Description
`/`	Health check, shows configured modules
`/pymupdf/*`	PyMuPDF WASM files
`/gs/*`	Ghostscript WASM files
`/cpdf/*`	CoherentPDF files

3.0 KiB Raw Blame History