compress-pdf-lib 1.0.0 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compress-pdf-lib",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Client-side PDF compression: pdf.js render + mozjpeg (WASM) encoding via a parallel worker pool + pdf-lib rebuild. No server, no UI. Ships as raw ESM source for Vite-based apps (React + Vite, Astro).",
   "type": "module",
   "main": "src/index.js",

package/src/compress.js

@@ -238,7 +238,7 @@ async function normalizeInput(input) {
    RENDER + COMPRESS ONE PAGE
 ============================================================ */
 
-async function processPage(pdf, pool, pageNumber, totalPages, { quality, resolution }) {
+async function processPage(pdf, pool, pageNumber, totalPages, { quality, resolution, scale: fixedScale }) {
   let page = null;
   let canvas = null;
   let bitmap = null;
@@ -252,9 +252,28 @@ async function processPage(pdf, pool, pageNumber, totalPages, { quality, resolut
 
     const largestDimension = Math.max(pdfWidth, pdfHeight);
 
-    let scale = resolution / largestDimension;
-    scale = Math.max(scale, 0.25);
-    scale = Math.min(scale, 3);
+    let scale;
+
+    if (typeof fixedScale === "number") {
+      /*
+       * Direct scale multiplier — same units as pdf.js's own
+       * page.getViewport({ scale }). 1 = native ~72 DPI, 2 = ~144 DPI,
+       * 3 = ~216 DPI (max allowed). Proportional across any page size,
+       * unlike a fixed pixel target.
+       */
+      scale = Math.max(0.25, Math.min(fixedScale, 3));
+    } else if (resolution === "original" || resolution === Infinity) {
+      /*
+       * No downscaling — render at the max allowed multiplier so page
+       * quality is limited only by the JPEG quality setting, not by
+       * resizing.
+       */
+      scale = 3;
+    } else {
+      scale = resolution / largestDimension;
+      scale = Math.max(scale, 0.25);
+      scale = Math.min(scale, 3);
+    }
 
     const viewport = page.getViewport({ scale });
     const width = Math.ceil(viewport.width);
@@ -326,7 +345,7 @@ async function processPage(pdf, pool, pageNumber, totalPages, { quality, resolut
    PARALLEL PAGE PIPELINE
 ============================================================ */
 
-async function processPages(pdf, pool, totalPages, { quality, resolution, workers, onProgress }) {
+async function processPages(pdf, pool, totalPages, { quality, resolution, scale, workers, onProgress }) {
   const results = new Array(totalPages);
 
   const renderConcurrency = Math.max(1, Math.min(workers, 4));
@@ -345,6 +364,7 @@ async function processPages(pdf, pool, totalPages, { quality, resolution, worker
       const result = await processPage(pdf, pool, pageNumber, totalPages, {
         quality,
         resolution,
+        scale,
       });
 
       results[pageNumber - 1] = result;
@@ -475,13 +495,27 @@ async function buildPdf(compressedPages, { originalBytes, startedAt, workersUsed
  * @param {File|Blob|ArrayBuffer|ArrayBufferView} input
  * @param {Object} [options]
  * @param {number} [options.quality=65] - JPEG quality, 0-100
- * @param {number} [options.resolution=1600] - max px on the longest page side
+ * @param {number|"original"} [options.resolution=1600] - max px on the longest
+ *   page side. Pass "original" (or Infinity) to skip downscaling entirely and
+ *   rely on `quality` alone — renders at the max supported multiplier (3x).
+ *   Ignored if `scale` is set.
+ * @param {number} [options.scale] - direct render-scale multiplier (same units
+ *   as pdf.js's `page.getViewport({ scale })`), clamped to 0.25–3.
+ *   1 = native ~72 DPI, 2 ≈ 144 DPI, 3 ≈ 216 DPI (max). Proportional across
+ *   any page size, unlike `resolution`'s fixed pixel target. Takes
+ *   precedence over `resolution` when provided.
  * @param {number} [options.workers] - override auto-detected worker count
  * @param {(update: object) => void} [options.onProgress] - optional progress callback
  * @returns {Promise<{file: File|Blob, stats: object}>}
  */
 export async function compressPDF(input, options = {}) {
-  const { quality = 65, resolution = 1600, workers: workerOverride, onProgress } = options;
+  const {
+    quality = 65,
+    resolution = 1600,
+    scale,
+    workers: workerOverride,
+    onProgress,
+  } = options;
 
   const startedAt = performance.now();
 
@@ -506,6 +540,7 @@ export async function compressPDF(input, options = {}) {
     const compressedPages = await processPages(pdf, pool, totalPages, {
       quality,
       resolution,
+      scale,
       workers: workerCount,
       onProgress,
     });
@@ -534,4 +569,4 @@ export async function compressPDF(input, options = {}) {
 
     pool.destroy();
   }
-}
+}