@kreuzberg/node 4.6.0 → 4.6.3

package/index.d.ts

@@ -1,5 +1,48 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/**
+ * Lazy PDF page iterator. A more memory-efficient alternative to
+ * `iteratePdfPagesSync`/`iteratePdfPages` when memory is a concern or when
+ * pages should be processed as they are rendered (e.g., sending each page to
+ * a vision model for OCR).
+ *
+ * Renders one page at a time via the `.next()` method. Callers must call
+ * `.close()` when done to free native resources.
+ *
+ * # Example
+ *
+ * ```javascript
+ * const iter = new PdfPageIterator("doc.pdf", 150);
+ * let result;
+ * while ((result = iter.next()) !== null) {
+ *     const { pageIndex, data } = result;
+ *     // process page...
+ * }
+ * iter.close();
+ * ```
+ */
+export declare class JsPdfPageIterator {
+  /**
+   * Create a new PDF page iterator.
+   *
+   * # Parameters
+   *
+   * * `file_path` - Path to the PDF file
+   * * `dpi` - Optional DPI (default 150)
+   */
+  constructor(filePath: string, dpi?: number | undefined | null)
+  /**
+   * Advance the iterator and return the next page.
+   *
+   * Returns `{ pageIndex, data }` or `null` when exhausted.
+   */
+  next(): PdfPageResult | null
+  /** Total number of pages in the PDF. */
+  pageCount(): number
+  /** Free native resources. Safe to call multiple times. */
+  close(): void
+}
+
 /** Opaque handle to a worker pool */
 export declare class JsWorkerPool {
 
@@ -911,6 +954,49 @@ export declare function getValidTokenReductionLevels(): Array<string>
  */
 export declare function getWorkerPoolStats(pool: JsWorkerPool): WorkerPoolStats
 
+/**
+ * Create a PDF page iterator and collect all pages (asynchronous).
+ *
+ * Non-blocking variant of `iteratePdfPagesSync`. Rendering is offloaded
+ * to the worker pool.
+ *
+ * Note: Pages are collected eagerly into an array. For true lazy iteration,
+ * use `new PdfPageIterator(filePath, dpi)` which exposes a `.next()` method
+ * that renders one page at a time.
+ *
+ * # Parameters
+ *
+ * * `file_path` - Path to the PDF file
+ * * `dpi` - Optional DPI (default 150)
+ *
+ * # Returns
+ *
+ * Promise resolving to an array of `PdfPageResult` objects.
+ */
+export declare function iteratePdfPages(filePath: string, dpi?: number | undefined | null): Promise<Array<PdfPageResult>>
+
+/**
+ * Create a PDF page iterator and collect all pages (synchronous).
+ *
+ * Opens the PDF once and renders pages lazily, returning an array of
+ * `{ pageIndex, data }` objects. Each page is rendered one at a time so
+ * only one raw image is in memory at a time.
+ *
+ * Note: Pages are collected eagerly into an array. For true lazy iteration,
+ * use `new PdfPageIterator(filePath, dpi)` which exposes a `.next()` method
+ * that renders one page at a time.
+ *
+ * # Parameters
+ *
+ * * `file_path` - Path to the PDF file
+ * * `dpi` - Optional DPI (default 150)
+ *
+ * # Returns
+ *
+ * Array of `PdfPageResult` objects.
+ */
+export declare function iteratePdfPagesSync(filePath: string, dpi?: number | undefined | null): Array<PdfPageResult>
+
 /**
  * Hardware acceleration configuration for ONNX Runtime inference.
  *
@@ -1055,6 +1141,8 @@ export interface JsExtractionConfig {
   enableQualityProcessing?: boolean
   ocr?: JsOcrConfig
   forceOcr?: boolean
+  /** List of 1-indexed page numbers to force OCR on (None = use force_ocr setting) */
+  forceOcrPages?: Array<number>
   chunking?: JsChunkingConfig
   images?: JsImageExtractionConfig
   pdfOptions?: JsPdfConfig
@@ -1087,6 +1175,8 @@ export interface JsExtractionConfig {
   cacheTtlSecs?: number
   /** Maximum recursion depth for archive extraction (default: 3) */
   maxArchiveDepth?: number
+  /** Default per-file extraction timeout in seconds */
+  extractionTimeoutSecs?: number
 }
 
 export interface JsExtractionResult {
@@ -1112,6 +1202,8 @@ export interface JsFileExtractionConfig {
   enableQualityProcessing?: boolean
   ocr?: JsOcrConfig
   forceOcr?: boolean
+  /** List of 1-indexed page numbers to force OCR on (None = use force_ocr setting) */
+  forceOcrPages?: Array<number>
   chunking?: JsChunkingConfig
   images?: JsImageExtractionConfig
   pdfOptions?: JsPdfConfig
@@ -1129,6 +1221,8 @@ export interface JsFileExtractionConfig {
   includeDocumentStructure?: boolean
   /** Layout detection configuration (None = layout detection disabled) */
   layout?: JsLayoutDetectionConfig
+  /** Per-file extraction timeout in seconds */
+  timeoutSecs?: number
 }
 
 export interface JsHeadingContext {
@@ -1445,6 +1539,28 @@ export declare function listValidators(): Array<string>
  */
 export declare function loadExtractionConfigFromFile(filePath: string): JsExtractionConfig
 
+/**
+ * Get the number of pages in a PDF file without rendering.
+ *
+ * # Parameters
+ *
+ * * `file_path` - Path to the PDF file
+ * * `dpi` - Optional DPI (not used for counting, but validates the PDF)
+ *
+ * # Returns
+ *
+ * Number of pages in the PDF.
+ */
+export declare function pdfPageCount(filePath: string, dpi?: number | undefined | null): number
+
+/** A rendered PDF page with its zero-based index and PNG data. */
+export interface PdfPageResult {
+  /** Zero-based page index. */
+  pageIndex: number
+  /** PNG image data. */
+  data: Buffer
+}
+
 /**
  * Register a custom OCR backend
  *
@@ -1572,6 +1688,38 @@ export declare function registerPostProcessor(processor: object): void
  */
 export declare function registerValidator(validator: object): void
 
+/**
+ * Render a single page of a PDF file to a PNG buffer (asynchronous).
+ *
+ * Non-blocking alternative to `renderPdfPageSync`.
+ *
+ * # Parameters
+ *
+ * * `file_path` - Path to the PDF file
+ * * `page_index` - Zero-based page index
+ * * `dpi` - Optional DPI (default 150)
+ *
+ * # Returns
+ *
+ * Promise resolving to a Buffer containing PNG image data.
+ */
+export declare function renderPdfPage(filePath: string, pageIndex: number, dpi?: number | undefined | null): Promise<Buffer>
+
+/**
+ * Render a single page of a PDF file to a PNG buffer (synchronous).
+ *
+ * # Parameters
+ *
+ * * `file_path` - Path to the PDF file
+ * * `page_index` - Zero-based page index
+ * * `dpi` - Optional DPI (default 150)
+ *
+ * # Returns
+ *
+ * Buffer containing PNG image data.
+ */
+export declare function renderPdfPageSync(filePath: string, pageIndex: number, dpi?: number | undefined | null): Buffer
+
 /**
  * Unregister a document extractor by name.
  *

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-android-arm64')
         const bindingPackageVersion = require('@kreuzberg/node-android-arm64/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-android-arm-eabi')
         const bindingPackageVersion = require('@kreuzberg/node-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-win32-x64-gnu')
         const bindingPackageVersion = require('@kreuzberg/node-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-win32-x64-msvc')
         const bindingPackageVersion = require('@kreuzberg/node-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-win32-ia32-msvc')
         const bindingPackageVersion = require('@kreuzberg/node-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-win32-arm64-msvc')
         const bindingPackageVersion = require('@kreuzberg/node-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@kreuzberg/node-darwin-universal')
       const bindingPackageVersion = require('@kreuzberg/node-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-darwin-x64')
         const bindingPackageVersion = require('@kreuzberg/node-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-darwin-arm64')
         const bindingPackageVersion = require('@kreuzberg/node-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-freebsd-x64')
         const bindingPackageVersion = require('@kreuzberg/node-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-freebsd-arm64')
         const bindingPackageVersion = require('@kreuzberg/node-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-x64-musl')
           const bindingPackageVersion = require('@kreuzberg/node-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-x64-gnu')
           const bindingPackageVersion = require('@kreuzberg/node-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-arm64-musl')
           const bindingPackageVersion = require('@kreuzberg/node-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-arm64-gnu')
           const bindingPackageVersion = require('@kreuzberg/node-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-arm-musleabihf')
           const bindingPackageVersion = require('@kreuzberg/node-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@kreuzberg/node-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-loong64-musl')
           const bindingPackageVersion = require('@kreuzberg/node-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-loong64-gnu')
           const bindingPackageVersion = require('@kreuzberg/node-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-riscv64-musl')
           const bindingPackageVersion = require('@kreuzberg/node-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@kreuzberg/node-linux-riscv64-gnu')
           const bindingPackageVersion = require('@kreuzberg/node-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-linux-ppc64-gnu')
         const bindingPackageVersion = require('@kreuzberg/node-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-linux-s390x-gnu')
         const bindingPackageVersion = require('@kreuzberg/node-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-openharmony-arm64')
         const bindingPackageVersion = require('@kreuzberg/node-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-openharmony-x64')
         const bindingPackageVersion = require('@kreuzberg/node-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@kreuzberg/node-openharmony-arm')
         const bindingPackageVersion = require('@kreuzberg/node-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '4.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 4.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '4.6.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 4.6.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -576,6 +576,7 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
+module.exports.JsPdfPageIterator = nativeBinding.JsPdfPageIterator
 module.exports.JsWorkerPool = nativeBinding.JsWorkerPool
 module.exports.batchExtractBytes = nativeBinding.batchExtractBytes
 module.exports.batchExtractBytesSync = nativeBinding.batchExtractBytesSync
@@ -612,6 +613,8 @@ module.exports.getValidLanguageCodes = nativeBinding.getValidLanguageCodes
 module.exports.getValidOcrBackends = nativeBinding.getValidOcrBackends
 module.exports.getValidTokenReductionLevels = nativeBinding.getValidTokenReductionLevels
 module.exports.getWorkerPoolStats = nativeBinding.getWorkerPoolStats
+module.exports.iteratePdfPages = nativeBinding.iteratePdfPages
+module.exports.iteratePdfPagesSync = nativeBinding.iteratePdfPagesSync
 module.exports.listDocumentExtractors = nativeBinding.listDocumentExtractors
 module.exports.listEmbeddingPresets = nativeBinding.listEmbeddingPresets
 module.exports.listEmbeddingPresets = nativeBinding.listEmbeddingPresets
@@ -619,9 +622,12 @@ module.exports.listOcrBackends = nativeBinding.listOcrBackends
 module.exports.listPostProcessors = nativeBinding.listPostProcessors
 module.exports.listValidators = nativeBinding.listValidators
 module.exports.loadExtractionConfigFromFile = nativeBinding.loadExtractionConfigFromFile
+module.exports.pdfPageCount = nativeBinding.pdfPageCount
 module.exports.registerOcrBackend = nativeBinding.registerOcrBackend
 module.exports.registerPostProcessor = nativeBinding.registerPostProcessor
 module.exports.registerValidator = nativeBinding.registerValidator
+module.exports.renderPdfPage = nativeBinding.renderPdfPage
+module.exports.renderPdfPageSync = nativeBinding.renderPdfPageSync
 module.exports.unregisterDocumentExtractor = nativeBinding.unregisterDocumentExtractor
 module.exports.unregisterOcrBackend = nativeBinding.unregisterOcrBackend
 module.exports.unregisterPostProcessor = nativeBinding.unregisterPostProcessor

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreuzberg/node",
-  "version": "4.6.0",
+  "version": "4.6.3",
   "description": "Kreuzberg document intelligence - Node.js native bindings",
   "author": {
     "name": "Na'aman Hirschfeld",
@@ -90,7 +90,7 @@
     "build": "napi build --platform --release && tsup",
     "build:debug": "napi build --platform",
     "build:ts": "tsup",
-    "prepare": "tsup",
+    "prepare": "tsup || node -e \"var f=require('fs');f.mkdirSync('dist',{recursive:true});f.writeFileSync('dist/cli.js','process.exit(1)')\"",
     "test": "pnpm test:smoke && pnpm test:binding",
     "test:smoke": "vitest run tests/smoke/",
     "test:binding": "vitest run tests/binding/",
@@ -110,21 +110,21 @@
     "@types/archiver": "^7.0.0",
     "@types/node": "^25.5.0",
     "@types/which": "^3.0.4",
-    "@vitest/coverage-v8": "^4.1.1",
+    "@vitest/coverage-v8": "^4.1.2",
     "archiver": "^7.0.1",
     "oxlint": "^1.57.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.1"
+    "vitest": "^4.1.2"
   },
   "dependencies": {
     "@emnapi/runtime": "1.9.1",
     "which": "^6.0.1"
   },
   "optionalDependencies": {
-    "@kreuzberg/node-darwin-arm64": "4.6.0",
-    "@kreuzberg/node-linux-arm64-gnu": "4.6.0",
-    "@kreuzberg/node-linux-x64-gnu": "4.6.0",
-    "@kreuzberg/node-win32-x64-msvc": "4.6.0"
+    "@kreuzberg/node-darwin-arm64": "4.6.3",
+    "@kreuzberg/node-linux-arm64-gnu": "4.6.3",
+    "@kreuzberg/node-linux-x64-gnu": "4.6.3",
+    "@kreuzberg/node-win32-x64-msvc": "4.6.3"
   }
 }