Files

Matthew Jackson baa17b0fc7 Add PDF-to-JPEG support in web UI and /convert/pdf endpoint

Web UI now accepts both images and PDFs. Images go through /strip
as before; PDFs go through new /convert/pdf endpoint which renders
all pages via pdftoppm and returns base64 JPEGs. Also updates
page title and layout.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-14 10:01:42 -07:00

1.6 KiB

Raw Permalink Blame History

PostConvert

Image/PDF-to-JPEG conversion microservice. Single-file Node.js/Express app (server.js).

Tech Stack

Node.js 18+ (ES modules), Express
Sharp (image processing), libheif-js (HEIC/HEIF via WASM)
pdftoppm from Poppler (PDF rendering), archiver (ZIP output)
Docker (node:20-bookworm-slim), deployed on Fly.io (sjc region)

Endpoints

GET / — web UI for stripping photo metadata (drag-and-drop, uses /strip)
GET /health — health check
POST /strip — strip metadata from image, return clean JPEG + removed metadata (JSON or raw)
POST /convert — image or first PDF page → JPEG (resize/quality via headers)
POST /convert/pdf — all PDF pages → JSON array of base64 JPEGs

Auth

Bearer token via CONVERTER_TOKEN env var on all endpoints.

Key Design

Single-flight concurrency (1 conversion at a time, 429 if busy)
Resize/quality via headers: x-jpeg-quality, x-max-dimension, x-pdf-dpi, x-without-enlargement
Pixel limit 200M, bounded /tmp, no stack traces leaked, request timeouts
Fly.io auto-scaling 0–10 machines, 2 concurrent connection hard limit

Environment Variables

PORT (default 8080)
CONVERTER_TOKEN (required)
REQ_TIMEOUT_MS (default 120s, range 5–600s)
REQ_TIMEOUT_PDF_MS (default 5m, range 10s–30m)

Development

npm install
node server.js

Docker:

docker build -t postconvert .
docker run -e CONVERTER_TOKEN=secret -p 8080:8080 postconvert

Fly.io Deployment

Tokens are in .env (gitignored). Load with source .env or use dotenv.

Deploy: FLY_API_TOKEN="$FLY_API_TOKEN" fly deploy

1.6 KiB Raw Permalink Blame History Unescape Escape