qpdf-compress 0.2.0 → 0.4.1

package/CHANGELOG.md

@@ -0,0 +1,124 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.4.0] - 2026-03-31
+
+### Added
+
+- **Grayscale detection**: automatically converts RGB images where R==G==B to DeviceGray (3× raw data reduction)
+- **Bitonal conversion**: converts 8-bit grayscale images that are effectively B&W to 1-bit (8× raw data reduction)
+- **TrueType font subsetting**: strips unused glyph outlines from `/FontFile2` font programs via custom binary parser (cmap format 0/4, composite glyph dependency resolution, glyf/loca/hmtx table rebuilding)
+- **Soft mask optimization**: losslessly optimizes JPEG `/SMask` transparency streams
+- **ICC profile stripping**: replaces ICCBased color spaces with Device equivalents on images and page resources
+- **Form flattening**: stamps widget annotation appearances into page content and removes `/AcroForm`
+- **Page tree flattening**: pushes inherited attributes to individual pages for optimal QPDFWriter output
+- **Content stream coalescing**: merges multiple content streams per page into one
+- **Content stream minification**: normalizes whitespace and trims numeric formatting (trailing/leading zeros)
+- **Non-image stream deduplication**: deduplicates identical font, ICC, and other non-image streams via FNV-1a hash + full byte comparison
+- **Embedded file stripping**: removes `/EmbeddedFiles` from the document name tree
+- **JavaScript removal**: strips `/OpenAction`, `/AA`, and `/JavaScript` from catalog, pages, and annotations
+- **Accurate DPI calculation**: content stream CTM matrix parser (~170 lines) tracks `q`/`Q`/`cm`/`Do` operators to find actual rendered image dimensions, with MediaBox fallback
+
+### Fixed
+
+- **Grayscale JPEG inflation**: `convertGrayscaleImages` now skips DCTDecode images — previously replacing JPEG with raw gray + Flate inflated photographic images 2–4× in lossless mode
+- **Font subset size comparison**: compares uncompressed sizes instead of uncompressed subset vs Flate-compressed original
+- **Stream dedup safety**: `deduplicateStreams` now checks `/DecodeParms` equality — identical raw bytes with different decode parameters produce different content
+- **Content stream decoding**: decoded once per page in `subsetFonts` instead of redundantly per font
+
+### Changed
+
+- Split `images.cc` into `images.cc` (image operations) and `optimize.cc` (structural optimizations)
+- Added `font_subset.cc`/`font_subset.h` for TrueType binary parsing
+- Source: 5 `.cc` files, 4 headers, ~3000 lines total
+
+## [0.3.0] - 2026-03-30
+
+### Changed
+
+- **BREAKING**: Replaced `mode: 'lossy' | 'lossless'` with `lossy?: boolean` (default `false`)
+- **BREAKING**: Removed `quality` parameter — quality is now automatically determined per mode
+- **BREAKING**: Removed `maxDpi` parameter — DPI is now automatically determined per mode
+- **BREAKING**: Options parameter is now optional — `compress(input)` defaults to lossless
+- Lossless: pure structural optimization — no image re-encoding or downscaling
+- Lossy: skip images at q ≤ 65, re-encode at q75, downscale to 72 DPI
+
+## [0.2.0] - 2026-03-30
+
+### Added
+
+- CMYK → RGB conversion for JPEG images
+- ICCBased color space support (extracts and converts embedded ICC profiles)
+- PNG optimization (re-encodes as JPEG when beneficial)
+- DPI downscaling (configurable max DPI, default 75)
+- Metadata stripping (XMP, document info, thumbnails) — enabled by default
+- Unused font removal
+- Auto quality mode — estimates existing JPEG quality and skips re-encoding when already below target
+
+## [0.1.3] - 2026-03-30
+
+### Fixed
+
+- Included `<cstdio>` before `<jpeglib.h>` for Linux compatibility
+- Restored Node 20 to CI matrix (matching engines `>=20.11.0`)
+- Used static import for `Readable` instead of dynamic `import()`
+
+### Added
+
+- Build provenance attestation for prebuilt binaries via `actions/attest-build-provenance`
+
+## [0.1.2] - 2026-03-30
+
+### Fixed
+
+- Fixed Linux cross-build tarball structure (prebuilds now install correctly)
+- Fixed Debian Bookworm cross-builds (use `libjpeg62-turbo-dev` package)
+- Moved `setjmp` before `jpeg_create_*` calls to prevent UB on allocation failure
+- Used `uint64_t` for FNV-1a image dedup hash (correct on 32-bit ARM)
+- Added component count validation in `encodeJpeg`
+- Wrapped web `ReadableStream` with `Readable.fromWeb()` in install script
+- Made `strerror` calls thread-safe by copying to `std::string`
+
+### Changed
+
+- Bumped minimum Node.js version to 20.11.0 (`import.meta.dirname` requirement)
+- Updated CI matrix to Node 22 and 24
+
+## [0.1.1] - 2026-03-30
+
+### Changed
+
+- Replaced stb_image_write with libjpeg-turbo for lossy JPEG encoding (better quality per byte)
+- Split monolithic `qpdf_addon.cc` into focused modules: `jpeg.cc`, `images.cc`, `qpdf_addon.cc`
+- Extracted shared `forEachImage()` template helper
+- Bumped minimum Node.js version to 20.11.0
+
+### Fixed
+
+- Removed global mutex that serialized concurrent compress() calls
+- Isolated setjmp/longjmp in C-style functions to avoid UB with C++ destructors
+- Fixed prebuild tarball structure so install script finds the .node file
+- Added mode validation (reject invalid mode strings)
+
+## [0.1.0] - 2026-03-30
+
+### Added
+
+- Native PDF compression via QPDF 12.3.2 with single `compress()` API
+- Flate compression (level 9) for all streams
+- Lossless JPEG optimization via libjpeg-turbo
+- Image deduplication (content-hash based)
+- PDF repair merged into compress pipeline
+- Prebuilt binaries for macOS (arm64, x64), Linux glibc (x64, arm64, arm), Linux musl (x64, arm64), Windows (x64, arm64)
+- Automatic prebuild download with source compilation fallback
+- N-API addon for ABI stability across Node.js versions
+
+### Infrastructure
+
+- CI matrix: 3 OS × 3 Node versions (20, 22, 24)
+- Release pipeline with prebuild generation and npm provenance
+- QEMU-based cross-compilation for Linux arm64/arm and musl variants
+- vcpkg integration for Windows static linking

package/README.md

@@ -14,14 +14,11 @@ Native PDF compression for Node.js — powered by [QPDF](https://qpdf.sourceforg
 ```typescript
 import { compress } from 'qpdf-compress';
 
-// lossless — optimize without touching image quality
-const optimized = await compress(pdfBuffer, { mode: 'lossless' });
+// lossless (default) — pure structural optimization
+const optimized = await compress(pdfBuffer);
 
-// lossy — auto quality, downscale to 75 DPI, strip metadata
-const smaller = await compress(pdfBuffer, { mode: 'lossy' });
-
-// lossy with explicit quality
-const tiny = await compress(pdfBuffer, { mode: 'lossy', quality: 50 });
+// lossy — image recompression + downscale to 72 DPI
+const smaller = await compress(pdfBuffer, { lossy: true });
 ```
 
 ## 💡 Why qpdf-compress?
@@ -31,7 +28,7 @@ const tiny = await compress(pdfBuffer, { mode: 'lossy', quality: 50 });
 - Native C++ — no WASM overhead, no shell-out to CLI tools
 - Non-blocking — all operations run off the main thread via N-API AsyncWorker
 - Multi-pass optimization — image dedup, JPEG Huffman optimization, Flate level 9
-- Smart defaults — DPI downscaling, metadata stripping, adaptive JPEG quality
+- Smart defaults — metadata stripping, image dedup, lossless JPEG Huffman optimization
 
 **🛠️ Developer experience**
 
@@ -56,20 +53,28 @@ const tiny = await compress(pdfBuffer, { mode: 'lossy', quality: 50 });
 
 ### 📊 How it compares
 
-|                           | **qpdf-compress**        | qpdf CLI          | Ghostscript       |
-| ------------------------- | ------------------------ | ----------------- | ----------------- |
-| Integration               | Native Node.js addon     | Shell exec        | Shell exec        |
-| Async I/O                 | ✅ Non-blocking          | ❌ Blocks on exec | ❌ Blocks on exec |
-| Image deduplication       | ✅                       | ❌                | ❌                |
-| JPEG Huffman optimization | ✅ Lossless (libjpeg)    | ❌                | ❌                |
-| Lossy image compression   | ✅ Auto or fixed quality | ❌                | ✅                |
-| CMYK → RGB conversion     | ✅ Automatic             | ❌                | ✅                |
-| DPI downscaling           | ✅ Configurable          | ❌                | ✅                |
-| Metadata stripping        | ✅ Default on            | ✅ Manual flag    | ✅                |
-| Unused font removal       | ✅ Automatic             | ❌                | ❌                |
-| PDF repair                | ✅ Automatic             | ✅ Manual flag    | ⚠️ Partial        |
-| License                   | Apache-2.0               | Apache-2.0        | AGPL-3.0 ⚠️       |
-| Dependencies              | None¹                    | System binary     | System binary     |
+|                           | **qpdf-compress**     | qpdf CLI          | Ghostscript       |
+| ------------------------- | --------------------- | ----------------- | ----------------- |
+| Integration               | Native Node.js addon  | Shell exec        | Shell exec        |
+| Async I/O                 | ✅ Non-blocking       | ❌ Blocks on exec | ❌ Blocks on exec |
+| Image deduplication       | ✅                    | ❌                | ❌                |
+| JPEG Huffman optimization | ✅ Lossless (libjpeg) | ❌                | ❌                |
+| Lossy image compression   | ✅ Auto quality       | ❌                | ✅                |
+| CMYK → RGB conversion     | ✅ Automatic          | ❌                | ✅                |
+| DPI downscaling           | ✅ Lossy mode         | ❌                | ✅                |
+| Grayscale detection       | ✅ Automatic          | ❌                | ❌                |
+| Bitonal conversion        | ✅ Automatic          | ❌                | ❌                |
+| Font subsetting           | ✅ TrueType glyph     | ❌                | ❌                |
+| Unused font removal       | ✅ Automatic          | ❌                | ❌                |
+| ICC profile stripping     | ✅ Automatic          | ❌                | ❌                |
+| Form flattening           | ✅ Automatic          | ❌                | ❌                |
+| Stream deduplication      | ✅ Automatic          | ❌                | ❌                |
+| Content minification      | ✅ Automatic          | ❌                | ❌                |
+| JS/embedded file removal  | ✅ Automatic          | ❌                | ❌                |
+| Metadata stripping        | ✅ Default on         | ✅ Manual flag    | ✅                |
+| PDF repair                | ✅ Automatic          | ✅ Manual flag    | ⚠️ Partial        |
+| License                   | Apache-2.0            | Apache-2.0        | AGPL-3.0 ⚠️       |
+| Dependencies              | None¹                 | System binary     | System binary     |
 
 ¹ QPDF is statically linked — no runtime dependencies. Prebuilt binaries downloaded at install.
 
@@ -116,76 +121,101 @@ vcpkg install zlib libjpeg-turbo --triplet x64-windows-static
 ```typescript
 import { compress } from 'qpdf-compress';
 
-// lossless — optimize streams without touching image quality
-const optimized = await compress(pdfBuffer, { mode: 'lossless' });
-
-// lossy — auto quality per image (skips JPEGs ≤ q90, encodes rest at q85)
-const smaller = await compress(pdfBuffer, { mode: 'lossy' });
+// lossless (default) — pure structural optimization, no image re-encoding
+const optimized = await compress(pdfBuffer);
 
-// lossy with explicit quality (1–100)
-const tiny = await compress(pdfBuffer, { mode: 'lossy', quality: 50 });
-
-// control DPI downscaling (default: 75, 0 = disabled)
-const highRes = await compress(pdfBuffer, { mode: 'lossless', maxDpi: 150 });
-const noDpi = await compress(pdfBuffer, { mode: 'lossless', maxDpi: 0 });
+// lossy — image recompression + downscale to 72 DPI
+const smaller = await compress(pdfBuffer, { lossy: true });
 
 // keep metadata (stripped by default)
-const withMeta = await compress(pdfBuffer, { mode: 'lossless', stripMetadata: false });
+const withMeta = await compress(pdfBuffer, { stripMetadata: false });
 
 // file path input (avoids copying into memory twice)
-const result = await compress('/path/to/file.pdf', { mode: 'lossless' });
+const result = await compress('/path/to/file.pdf');
 
 // write directly to file instead of returning a Buffer
-await compress(pdfBuffer, { mode: 'lossless', output: '/path/to/output.pdf' });
+await compress(pdfBuffer, { output: '/path/to/output.pdf' });
 
 // damaged PDFs are automatically repaired during compression
-const fixed = await compress(damagedBuffer, { mode: 'lossless' });
+const fixed = await compress(damagedBuffer);
 ```
 
 ## 📖 API
 
-### `compress(input, options): Promise<Buffer>`
+### `compress(input, options?): Promise<Buffer>`
 
 ### `compress(input, options & { output: string }): Promise<void>`
 
 Compresses a PDF document. Automatically repairs damaged PDFs.
 
-| Parameter               | Type                    | Description                                                          |
-| ----------------------- | ----------------------- | -------------------------------------------------------------------- |
-| `input`                 | `Buffer \| string`      | PDF data or file path                                                |
-| `options.mode`          | `'lossy' \| 'lossless'` | Compression mode                                                     |
-| `options.quality`       | `number`                | JPEG quality 1–100 (lossy only). Omit for auto quality (recommended) |
-| `options.maxDpi`        | `number`                | Downscale images exceeding this DPI. Default: `75`. `0` = disabled   |
-| `options.stripMetadata` | `boolean`               | Remove XMP metadata, document info, and thumbnails. Default: `true`  |
-| `options.output`        | `string`                | Write to file path instead of returning a `Buffer`                   |
+| Parameter               | Type               | Description                                                         |
+| ----------------------- | ------------------ | ------------------------------------------------------------------- |
+| `input`                 | `Buffer \| string` | PDF data or file path                                               |
+| `options.lossy`         | `boolean`          | Enable lossy compression. Default: `false`                          |
+| `options.stripMetadata` | `boolean`          | Remove XMP metadata, document info, and thumbnails. Default: `true` |
+| `options.output`        | `string`           | Write to file path instead of returning a `Buffer`                  |
 
 **Both modes:**
 
-- Deduplicates identical images across pages
+- Deduplicates identical images and non-image streams across pages
+- Detects and converts RGB images that are actually grayscale (3× raw data reduction)
+- Converts effectively black-and-white grayscale images to 1-bit (8× raw data reduction)
 - Optimizes embedded JPEG Huffman tables (2–15% savings, zero quality loss)
+- Optimizes soft mask (transparency) JPEG streams
+- Removes unused font resources from pages
+- Subsets TrueType fonts — strips unused glyph outlines from font programs
+- Strips ICC color profiles, replacing with Device equivalents
+- Flattens interactive forms (AcroForm) into page content
+- Flattens page tree (pushes inherited attributes to pages)
+- Coalesces multiple content streams per page into one
+- Minifies content streams (whitespace normalization, numeric formatting)
+- Strips embedded files and JavaScript actions
 - Recompresses all decodable streams with Flate level 9
 - Generates object streams for smaller metadata overhead
-- Removes unreferenced objects and unused fonts
-- Downscales images exceeding `maxDpi` (default: 75 DPI)
+- Removes unreferenced objects
 - Strips XMP metadata, document info, and thumbnails (default: on)
-- Converts CMYK and ICCBased color spaces to RGB
 - Automatically repairs damaged PDFs
 
-**Lossy mode** (in addition to the above):
+**Lossless (default):**
 
-- Extracts 8-bit RGB, grayscale, and CMYK images
-- **Auto quality** (default): skips existing JPEGs at q ≤ 90, encodes the rest at q85
-- **Explicit quality**: recompresses all images at the specified quality (1–100)
-- Only replaces images where JPEG is actually smaller
-- Skips re-encoding when estimated quality is already at or below target
+- Pure structural optimization — no image re-encoding or downscaling
+- Visually identical to the original
+
+**Lossy** (`lossy: true`):
+
+- Re-encodes JPEGs above q65 at q75 (skips images already at or below target)
+- Downscales images exceeding 72 DPI using CTM-based rendered size detection
+- Converts CMYK and ICCBased color spaces to RGB
+- Only replaces images where the result is actually smaller
 - Skips tiny images (< 50×50 px)
 
 ## ⚙️ How it works
 
-This package embeds [QPDF](https://github.com/qpdf/qpdf) (v12.3.2) as a statically linked C++ library, exposed to Node.js via N-API. Lossless JPEG optimization uses [libjpeg-turbo](https://libjpeg-turbo.org/) at the DCT coefficient level. Image recompression in lossy mode also uses libjpeg-turbo for JPEG encoding.
+This package embeds [QPDF](https://github.com/qpdf/qpdf) (v12.3.2) as a statically linked C++ library, exposed to Node.js via N-API. Lossless JPEG optimization uses [libjpeg-turbo](https://libjpeg-turbo.org/) at the DCT coefficient level. Image recompression in lossy mode also uses libjpeg-turbo for JPEG encoding. TrueType font subsetting is handled by a custom binary parser that reads cmap tables, resolves composite glyph dependencies, and rebuilds glyf/loca/hmtx tables with only the used glyphs.
 
 All operations run in a background thread via `Napi::AsyncWorker`, so the event loop is never blocked.
 
+### Compression pipeline (execution order)
+
+1. Deduplicate identical images
+2. Convert grayscale RGB images to DeviceGray
+3. Convert bitonal grayscale images to 1-bit
+4. Flatten page tree (push inherited attributes)
+5. _(lossy only)_ Re-encode high-quality JPEGs at q75
+6. _(lossy only)_ Downscale images above 72 DPI
+7. Optimize existing JPEG Huffman tables
+8. Optimize soft mask JPEG streams
+9. Remove unused font resources
+10. Subset TrueType fonts (strip unused glyphs)
+11. Strip ICC color profiles
+12. Flatten interactive forms into page content
+13. Coalesce multiple content streams per page
+14. Minify content streams
+15. Deduplicate identical non-image streams
+16. Strip embedded files and JavaScript
+17. _(optional)_ Strip metadata
+18. QPDFWriter: Flate 9, object streams, unreferenced object removal
+
 ## License
 
 Apache-2.0

package/binding.gyp

@@ -5,7 +5,9 @@
       "sources": [
         "src/qpdf_addon.cc",
         "src/jpeg.cc",
-        "src/images.cc"
+        "src/images.cc",
+        "src/optimize.cc",
+        "src/font_subset.cc"
       ],
       "include_dirs": [
         "<!@(node -p \"require('node-addon-api').include\")",

package/dist/index.d.ts

@@ -3,16 +3,18 @@ type PdfInput = Buffer | string;
 /**
  * Compresses a PDF document. Automatically repairs damaged PDFs.
  *
- * In lossless mode, deduplicates images, optimizes embedded JPEG Huffman
- * tables, recompresses all streams with Flate level 9, generates object
- * streams, and removes unreferenced objects.
+ * By default (lossless), deduplicates images, re-encodes very high quality
+ * JPEGs (q91+) at q85, downscales images to 150 DPI, optimizes embedded
+ * JPEG Huffman tables, recompresses all streams with Flate level 9,
+ * generates object streams, and removes unreferenced objects.
  *
- * In lossy mode, additionally recompresses embedded images as JPEG at the
- * specified quality. Text, vectors, and fonts are preserved.
+ * With `lossy: true`, uses more aggressive image re-encoding (skips JPEGs
+ * at q65 or below, re-encodes the rest at q75) and downscales to 72 DPI.
+ * Text, vectors, and fonts are preserved.
  */
 export declare function compress(input: PdfInput, options: CompressOptions & {
     output: string;
 }): Promise<void>;
-export declare function compress(input: PdfInput, options: CompressOptions): Promise<Buffer>;
+export declare function compress(input: PdfInput, options?: CompressOptions): Promise<Buffer>;
 export type { CompressOptions } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAY/D,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhC;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAAC;AACjB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAgCrF,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAY/D,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAAC;AACjB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAqBtF,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -22,22 +22,11 @@ export async function compress(input, options) {
     else {
         throw new TypeError('Input must be a Buffer or file path string');
     }
-    const mode = options.mode;
-    if (mode !== 'lossy' && mode !== 'lossless') {
-        throw new TypeError("Mode must be 'lossy' or 'lossless'");
-    }
-    const quality = options.quality ?? 0;
-    if (quality !== 0 && (quality < 1 || quality > 100)) {
-        throw new RangeError('Quality must be between 1 and 100');
-    }
-    const maxDpi = options.maxDpi ?? 75;
-    const stripMetadata = options.stripMetadata ?? true;
+    const stripMetadata = options?.stripMetadata ?? true;
     return addon.compress(input, {
-        mode,
-        quality,
-        ...(maxDpi > 0 ? { maxDpi } : {}),
+        ...(options?.lossy ? { lossy: true } : {}),
         ...(stripMetadata ? { stripMetadata: true } : {}),
-        ...(options.output ? { output: options.output } : {}),
+        ...(options?.output ? { output: options.output } : {}),
     });
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAC9D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,KAAK,GAAgB,OAAO,CAAC,qCAAqC,CAAC,CAAC;AAmB1E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAe,EAAE,OAAwB;IACtE,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5C,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACrC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,UAAU,CAAC,mCAAmC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;IACpD,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE;QAC3B,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAA2B,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAC9D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,KAAK,GAAgB,OAAO,CAAC,qCAAqC,CAAC,CAAC;AAqB1E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAe,EAAE,OAAyB;IACvE,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,IAAI,CAAC;IACrD,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE;QAC3B,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAA2B,CAAC;AAC/B,CAAC"}

package/dist/types.d.ts

@@ -1,10 +1,6 @@
 export interface CompressOptions {
-    /** Compression mode. */
-    readonly mode: 'lossy' | 'lossless';
-    /** JPEG quality for lossy mode (1–100). When omitted, automatically determines optimal quality per image (capped at 85). */
-    readonly quality?: number;
-    /** Maximum image DPI. Images exceeding this are downscaled. 0 = no limit. Default: 75. */
-    readonly maxDpi?: number;
+    /** Enable lossy compression for more aggressive size reduction. Default: false. */
+    readonly lossy?: boolean;
     /** Remove XMP metadata, document info, and thumbnails. Default: true. */
     readonly stripMetadata?: boolean;
     /** Write to this file path instead of returning a Buffer. */
@@ -12,9 +8,7 @@ export interface CompressOptions {
 }
 export interface NativeAddon {
     compress(input: Buffer | string, options: {
-        mode: 'lossy' | 'lossless';
-        quality: number;
-        maxDpi?: number;
+        lossy?: boolean;
         stripMetadata?: boolean;
         output?: string;
     }): Promise<Buffer | undefined>;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IACpC,4HAA4H;IAC5H,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CACN,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,EAAE;QACP,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CACN,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAChC"}

package/lib/index.ts

@@ -18,19 +18,21 @@ type PdfInput = Buffer | string;
 /**
  * Compresses a PDF document. Automatically repairs damaged PDFs.
  *
- * In lossless mode, deduplicates images, optimizes embedded JPEG Huffman
- * tables, recompresses all streams with Flate level 9, generates object
- * streams, and removes unreferenced objects.
+ * By default (lossless), deduplicates images, re-encodes very high quality
+ * JPEGs (q91+) at q85, downscales images to 150 DPI, optimizes embedded
+ * JPEG Huffman tables, recompresses all streams with Flate level 9,
+ * generates object streams, and removes unreferenced objects.
  *
- * In lossy mode, additionally recompresses embedded images as JPEG at the
- * specified quality. Text, vectors, and fonts are preserved.
+ * With `lossy: true`, uses more aggressive image re-encoding (skips JPEGs
+ * at q65 or below, re-encodes the rest at q75) and downscales to 72 DPI.
+ * Text, vectors, and fonts are preserved.
  */
 export function compress(
   input: PdfInput,
   options: CompressOptions & { output: string },
 ): Promise<void>;
-export function compress(input: PdfInput, options: CompressOptions): Promise<Buffer>;
-export async function compress(input: PdfInput, options: CompressOptions): Promise<Buffer | void> {
+export function compress(input: PdfInput, options?: CompressOptions): Promise<Buffer>;
+export async function compress(input: PdfInput, options?: CompressOptions): Promise<Buffer | void> {
   if (Buffer.isBuffer(input)) {
     if (input.length === 0) {
       throw new TypeError('Input buffer cannot be empty');
@@ -42,22 +44,11 @@ export async function compress(input: PdfInput, options: CompressOptions): Promi
   } else {
     throw new TypeError('Input must be a Buffer or file path string');
   }
-  const mode = options.mode;
-  if (mode !== 'lossy' && mode !== 'lossless') {
-    throw new TypeError("Mode must be 'lossy' or 'lossless'");
-  }
-  const quality = options.quality ?? 0;
-  if (quality !== 0 && (quality < 1 || quality > 100)) {
-    throw new RangeError('Quality must be between 1 and 100');
-  }
-  const maxDpi = options.maxDpi ?? 75;
-  const stripMetadata = options.stripMetadata ?? true;
+  const stripMetadata = options?.stripMetadata ?? true;
   return addon.compress(input, {
-    mode,
-    quality,
-    ...(maxDpi > 0 ? { maxDpi } : {}),
+    ...(options?.lossy ? { lossy: true } : {}),
     ...(stripMetadata ? { stripMetadata: true } : {}),
-    ...(options.output ? { output: options.output } : {}),
+    ...(options?.output ? { output: options.output } : {}),
   }) as Promise<Buffer | void>;
 }
 

package/lib/types.ts

@@ -1,10 +1,6 @@
 export interface CompressOptions {
-  /** Compression mode. */
-  readonly mode: 'lossy' | 'lossless';
-  /** JPEG quality for lossy mode (1–100). When omitted, automatically determines optimal quality per image (capped at 85). */
-  readonly quality?: number;
-  /** Maximum image DPI. Images exceeding this are downscaled. 0 = no limit. Default: 75. */
-  readonly maxDpi?: number;
+  /** Enable lossy compression for more aggressive size reduction. Default: false. */
+  readonly lossy?: boolean;
   /** Remove XMP metadata, document info, and thumbnails. Default: true. */
   readonly stripMetadata?: boolean;
   /** Write to this file path instead of returning a Buffer. */
@@ -15,9 +11,7 @@ export interface NativeAddon {
   compress(
     input: Buffer | string,
     options: {
-      mode: 'lossy' | 'lossless';
-      quality: number; // 0 = auto, 1–100 = fixed
-      maxDpi?: number;
+      lossy?: boolean;
       stripMetadata?: boolean;
       output?: string;
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qpdf-compress",
-  "version": "0.2.0",
+  "version": "0.4.1",
   "description": "Native PDF compression for Node.js, powered by QPDF",
   "license": "Apache-2.0",
   "type": "module",
@@ -38,7 +38,10 @@
     "src",
     "lib",
     "scripts",
-    "binding.gyp"
+    "binding.gyp",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "repository": {
     "type": "git",