qpdf-compress 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,131 @@
+# 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.5.0] - 2026-04-04
+
+### Added
+
+- `concurrency()` — get/set max concurrent compress operations dispatched to the libuv thread pool (default: CPU cores, powered by p-limit)
+- Husky + lint-staged pre-commit hook (Prettier + ESLint on staged files)
+
+## [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

@@ -189,6 +189,24 @@ Compresses a PDF document. Automatically repairs damaged PDFs.
 - Only replaces images where the result is actually smaller
 - Skips tiny images (< 50×50 px)
 
+### `concurrency(value?): number`
+
+Gets or sets the maximum number of concurrent compress operations dispatched to the thread pool.
+
+The default is the number of CPU cores (`os.availableParallelism()`). A value of `0` resets to the default.
+
+Excess calls are queued in JavaScript, preventing libuv thread pool starvation.
+
+```typescript
+import { compress, concurrency } from 'qpdf-compress';
+
+concurrency(); // 8 (CPU cores)
+concurrency(2); // limit to 2 concurrent operations
+concurrency(0); // reset to default
+```
+
+---
+
 ## ⚙️ 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. 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.

package/dist/concurrency.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Gets or sets the maximum number of concurrent operations.
+ *
+ * The default value is the number of CPU cores (`os.availableParallelism()`).
+ * A value of `0` resets to the default.
+ */
+export declare function concurrency(value?: number): number;
+export declare function withConcurrency<T>(fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../lib/concurrency.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEnE"}

package/dist/concurrency.js

@@ -0,0 +1,22 @@
+import { availableParallelism } from 'node:os';
+import pLimit from 'p-limit';
+let limit = pLimit(availableParallelism());
+/**
+ * Gets or sets the maximum number of concurrent operations.
+ *
+ * The default value is the number of CPU cores (`os.availableParallelism()`).
+ * A value of `0` resets to the default.
+ */
+export function concurrency(value) {
+    if (value !== undefined) {
+        if (!Number.isInteger(value) || value < 0) {
+            throw new TypeError('Concurrency must be a non-negative integer');
+        }
+        limit = pLimit(value === 0 ? availableParallelism() : value);
+    }
+    return limit.concurrency;
+}
+export function withConcurrency(fn) {
+    return limit(fn);
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../lib/concurrency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,MAA8B,MAAM,SAAS,CAAC;AAErD,IAAI,KAAK,GAAkB,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC,WAAW,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,EAAoB;IACrD,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -16,5 +16,6 @@ export declare function compress(input: PdfInput, options: CompressOptions & {
     output: string;
 }): Promise<void>;
 export declare function compress(input: PdfInput, options?: CompressOptions): Promise<Buffer>;
+export { concurrency } from './concurrency.js';
 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;;;;;;;;;;;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAIA,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;AAuBtF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 import { createRequire } from 'node:module';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { withConcurrency } from './concurrency.js';
 const require = createRequire(import.meta.url);
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const addonDir = resolve(__dirname, '..', 'build', 'Release');
@@ -23,10 +24,11 @@ export async function compress(input, options) {
         throw new TypeError('Input must be a Buffer or file path string');
     }
     const stripMetadata = options?.stripMetadata ?? true;
-    return addon.compress(input, {
+    return withConcurrency(() => addon.compress(input, {
         ...(options?.lossy ? { lossy: true } : {}),
         ...(stripMetadata ? { stripMetadata: true } : {}),
         ...(options?.output ? { output: options.output } : {}),
-    });
+    }));
 }
+export { concurrency } from './concurrency.js';
 //# 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;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"}
+{"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;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,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,eAAe,CAAC,GAAG,EAAE,CAC1B,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE;QACpB,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,CAAC,CACuB,CAAC;AAC9B,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/concurrency.ts

@@ -0,0 +1,24 @@
+import { availableParallelism } from 'node:os';
+import pLimit, { type LimitFunction } from 'p-limit';
+
+let limit: LimitFunction = pLimit(availableParallelism());
+
+/**
+ * Gets or sets the maximum number of concurrent operations.
+ *
+ * The default value is the number of CPU cores (`os.availableParallelism()`).
+ * A value of `0` resets to the default.
+ */
+export function concurrency(value?: number): number {
+  if (value !== undefined) {
+    if (!Number.isInteger(value) || value < 0) {
+      throw new TypeError('Concurrency must be a non-negative integer');
+    }
+    limit = pLimit(value === 0 ? availableParallelism() : value);
+  }
+  return limit.concurrency;
+}
+
+export function withConcurrency<T>(fn: () => Promise<T>): Promise<T> {
+  return limit(fn);
+}

package/lib/index.ts

@@ -1,6 +1,7 @@
 import { createRequire } from 'node:module';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { withConcurrency } from './concurrency.js';
 import type { CompressOptions, NativeAddon } from './types.js';
 
 const require = createRequire(import.meta.url);
@@ -45,11 +46,14 @@ export async function compress(input: PdfInput, options?: CompressOptions): Prom
     throw new TypeError('Input must be a Buffer or file path string');
   }
   const stripMetadata = options?.stripMetadata ?? true;
-  return addon.compress(input, {
-    ...(options?.lossy ? { lossy: true } : {}),
-    ...(stripMetadata ? { stripMetadata: true } : {}),
-    ...(options?.output ? { output: options.output } : {}),
-  }) as Promise<Buffer | void>;
+  return withConcurrency(() =>
+    addon.compress(input, {
+      ...(options?.lossy ? { lossy: true } : {}),
+      ...(stripMetadata ? { stripMetadata: true } : {}),
+      ...(options?.output ? { output: options.output } : {}),
+    }),
+  ) as Promise<Buffer | void>;
 }
 
+export { concurrency } from './concurrency.js';
 export type { CompressOptions } from './types.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qpdf-compress",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "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",
@@ -71,10 +74,16 @@
     "lint": "eslint --fix .",
     "lint:check": "eslint .",
     "format": "prettier --write .",
-    "format:check": "prettier --check ."
+    "format:check": "prettier --check .",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.{ts,js,json,md,yaml,yml}": "prettier --write",
+    "*.{ts,js}": "eslint --max-warnings 0"
   },
   "dependencies": {
-    "node-addon-api": "^8.0.0"
+    "node-addon-api": "^8.0.0",
+    "p-limit": "^7.3.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -82,10 +91,12 @@
     "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
     "node-gyp": "^11.0.0",
     "prettier": "^3.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.57.2",
     "vitest": "^4.1.2"
   }
-}
+}