kreuzberg 4.6.0 → 4.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 203e9719bcf3cf2cda1252dcd7a5c5782e7b73936a304b626a351894d4fcd909
-  data.tar.gz: 2c02a45c882ef6b6b6935896e9334c46f012aaf8bc6f6669fa3c0110b67398e5
+  metadata.gz: f087c152499deb621223ba54a8ca450bb0510da3b43c880f3969e33ec4b4d5e5
+  data.tar.gz: dba38092babe378ec93e0dd4f307ab44c10519623302fdf14023a52eff6549b2
 SHA512:
-  metadata.gz: d3dde81c8c38b1ee99bed3cae32e477e4c8941d401c6449fc9c3eec3608a5b771b47c20ab3a9679ccf75059fed5e6c09f9d91eefed83a7d9dc59eebf7acb5626
-  data.tar.gz: e590247800d9752175985ee3b8ad0c89c5926f1afa0669a881cf476455c8514332880d30ff35d46a2836cf9cdc18b752296fb06a545f42129b548b5675180a71
+  metadata.gz: 2e2cb3a3636555ac5f7d54bf473e36872efef5cf1796c667f727fa8622792a5cec009799d35c5ccb776997b7c39a0e5d0745266c7c5e5604d22b4e3e3e2f5e1f
+  data.tar.gz: b032174ab9b1366d3d05082ef6cfe3b1b700ff66d265fb28353d69b581aee6989688dd8e01b8c516f7046a8968ca86edd8a80cb72cb48477607eb8104d7facb3

data/README.md

@@ -22,7 +22,7 @@
     <img src="https://img.shields.io/maven-central/v/dev.kreuzberg/kreuzberg?label=Java&color=007ec6" alt="Java">
   </a>
   <a href="https://github.com/kreuzberg-dev/kreuzberg/releases">
-    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/kreuzberg?label=Go&color=007ec6&filter=v4.6.0" alt="Go">
+    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/kreuzberg?label=Go&color=007ec6&filter=v4.6.2" alt="Go">
   </a>
   <a href="https://www.nuget.org/packages/Kreuzberg/">
     <img src="https://img.shields.io/nuget/v/Kreuzberg?label=C%23&color=007ec6" alt="C#">

data/ext/kreuzberg_rb/native/Cargo.lock

@@ -499,6 +499,15 @@ dependencies = [
  "generic-array",
 ]
 
+[[package]]
+name = "block-buffer"
+version = "0.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cdd35008169921d80bc60d3d0ab416eecb028c4cd653352907921d95084790be"
+dependencies = [
+ "hybrid-array",
+]
+
 [[package]]
 name = "block-padding"
 version = "0.3.3"
@@ -726,7 +735,7 @@ version = "0.4.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "773f3b9af64447d2ce9850330c473515014aa235e6a783b02db81ff39e4a3dad"
 dependencies = [
- "crypto-common",
+ "crypto-common 0.1.7",
  "inout",
 ]
 
@@ -877,6 +886,12 @@ dependencies = [
  "web-sys",
 ]
 
+[[package]]
+name = "const-oid"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a6ef517f0926dd24a1582492c791b6a4818a4d94e789a334894aa15b0d12f55c"
+
 [[package]]
 name = "const-random"
 version = "0.1.18"
@@ -1034,6 +1049,15 @@ dependencies = [
  "typenum",
 ]
 
+[[package]]
+name = "crypto-common"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77727bb15fa921304124b128af125e7e3b968275d1b108b379190264f4423710"
+dependencies = [
+ "hybrid-array",
+]
+
 [[package]]
 name = "ctor"
 version = "0.6.3"
@@ -1232,8 +1256,19 @@ version = "0.10.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
 dependencies = [
- "block-buffer",
- "crypto-common",
+ "block-buffer 0.10.4",
+ "crypto-common 0.1.7",
+]
+
+[[package]]
+name = "digest"
+version = "0.11.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4850db49bf08e663084f7fb5c87d202ef91a3907271aff24a94eb97ff039153c"
+dependencies = [
+ "block-buffer 0.12.0",
+ "const-oid",
+ "crypto-common 0.2.1",
 ]
 
 [[package]]
@@ -2061,6 +2096,15 @@ version = "1.0.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
 
+[[package]]
+name = "hybrid-array"
+version = "0.4.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8655f91cd07f2b9d0c24137bd650fe69617773435ee5ec83022377777ce65ef1"
+dependencies = [
+ "typenum",
+]
+
 [[package]]
 name = "hyper"
 version = "1.8.1"
@@ -2612,7 +2656,7 @@ dependencies = [
 
 [[package]]
 name = "kreuzberg"
-version = "4.6.0"
+version = "4.6.2"
 dependencies = [
  "ahash",
  "async-trait",
@@ -2626,6 +2670,7 @@ dependencies = [
  "calamine",
  "cfb 0.14.0",
  "chardetng",
+ "chrono",
  "dashmap",
  "dbase",
  "encoding_rs",
@@ -2658,6 +2703,7 @@ dependencies = [
  "opentelemetry_sdk",
  "org",
  "ort",
+ "outlook-pst",
  "parking_lot",
  "pastey 0.2.1",
  "pkg-config",
@@ -2673,9 +2719,10 @@ dependencies = [
  "serde_json",
  "serde_yaml_ng",
  "sevenz-rust2",
- "sha2",
+ "sha2 0.11.0",
  "snap",
  "tar",
+ "tempfile",
  "text-splitter",
  "thiserror 2.0.18",
  "tiff",
@@ -2696,7 +2743,7 @@ dependencies = [
 
 [[package]]
 name = "kreuzberg-ffi"
-version = "4.6.0"
+version = "4.6.2"
 dependencies = [
  "ahash",
  "async-trait",
@@ -2712,7 +2759,7 @@ dependencies = [
 
 [[package]]
 name = "kreuzberg-paddle-ocr"
-version = "4.6.0"
+version = "4.6.2"
 dependencies = [
  "geo-clipper",
  "geo-types",
@@ -2726,7 +2773,7 @@ dependencies = [
 
 [[package]]
 name = "kreuzberg-pdfium-render"
-version = "4.6.0"
+version = "4.6.2"
 dependencies = [
  "bitflags",
  "bytemuck",
@@ -2749,7 +2796,7 @@ dependencies = [
 
 [[package]]
 name = "kreuzberg-rb"
-version = "4.6.0"
+version = "4.6.2"
 dependencies = [
  "async-trait",
  "html-to-markdown-rs",
@@ -2766,7 +2813,7 @@ dependencies = [
 
 [[package]]
 name = "kreuzberg-tesseract"
-version = "4.6.0"
+version = "4.6.2"
 dependencies = [
  "cc",
  "cmake",
@@ -2931,7 +2978,7 @@ dependencies = [
  "rand 0.10.0",
  "rangemap",
  "rayon",
- "sha2",
+ "sha2 0.10.9",
  "stringprep",
  "thiserror 2.0.18",
  "time",
@@ -3068,7 +3115,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d89e7ee0cfbedfc4da3340218492196241d89eefb6dab27de5df917a6d2e78cf"
 dependencies = [
  "cfg-if",
- "digest",
+ "digest 0.10.7",
 ]
 
 [[package]]
@@ -3540,6 +3587,17 @@ dependencies = [
  "ureq 3.3.0",
 ]
 
+[[package]]
+name = "outlook-pst"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "299eace9d895cc31490927d7de779f8e8f3deb5fb6bd1e68eb192aa1da19bd47"
+dependencies = [
+ "byteorder",
+ "thiserror 2.0.18",
+ "tracing",
+]
+
 [[package]]
 name = "parking_lot"
 version = "0.12.5"
@@ -4652,7 +4710,7 @@ dependencies = [
  "js-sys",
  "lzma-rust2 0.16.2",
  "ppmd-rust",
- "sha2",
+ "sha2 0.10.9",
  "wasm-bindgen",
 ]
 
@@ -4664,7 +4722,18 @@ checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283"
 dependencies = [
  "cfg-if",
  "cpufeatures 0.2.17",
- "digest",
+ "digest 0.10.7",
+]
+
+[[package]]
+name = "sha2"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "446ba717509524cb3f22f17ecc096f10f4822d76ab5c0b9822c5f9c284e825f4"
+dependencies = [
+ "cfg-if",
+ "cpufeatures 0.3.0",
+ "digest 0.11.2",
 ]
 
 [[package]]

data/ext/kreuzberg_rb/native/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "kreuzberg-rb"
-version = "4.6.0"
+version = "4.6.2"
 edition = "2024"
 rust-version = "1.91"
 authors = ["Na'aman Hirschfeld <naaman@kreuzberg.dev>"]
@@ -36,6 +36,7 @@ kreuzberg = { path = "../../../vendor/kreuzberg", default-features = false, feat
     "chunking",
     "chunking-tokenizers",
     "embeddings",
+    "ort-bundled",
     "quality",
     "keywords",
     "api",

data/ext/kreuzberg_rb/native/src/config/types.rs

@@ -875,6 +875,17 @@ pub fn parse_extraction_config(ruby: &Ruby, opts: Option<RHash>) -> Result<Extra
             config.force_ocr = bool::try_convert(val)?;
         }
 
+        if let Some(val) = get_kw(ruby, hash, "force_ocr_pages")
+            && val.equal(ruby.qnil()).ok() != Some(true)
+        {
+            let pages_array = magnus::RArray::try_convert(val)?;
+            let pages: Vec<usize> = pages_array
+                .into_iter()
+                .map(|v| usize::try_convert(v))
+                .collect::<Result<Vec<_>, _>>()?;
+            config.force_ocr_pages = Some(pages);
+        }
+
         if let Some(val) = get_kw(ruby, hash, "include_document_structure") {
             config.include_document_structure = bool::try_convert(val)?;
         }
@@ -1013,6 +1024,13 @@ pub fn parse_extraction_config(ruby: &Ruby, opts: Option<RHash>) -> Result<Extra
                 }
             };
         }
+
+        if let Some(val) = get_kw(ruby, hash, "extraction_timeout_secs")
+            && val.equal(ruby.qnil()).ok() != Some(true)
+        {
+            let secs = u64::try_convert(val)?;
+            config.extraction_timeout_secs = Some(secs);
+        }
     }
 
     Ok(config)

data/ext/kreuzberg_rb/native/src/extraction.rs

@@ -58,6 +58,36 @@ pub fn extract_file(args: &[Value]) -> Result<RHash, Error> {
     extraction_result_to_ruby(&ruby, result)
 }
 
+/// Iterate over PDF pages, yielding (page_index, png_bytes) per page to a Ruby block.
+pub fn render_pdf_pages_iter(path: String, dpi: i32) -> Result<(), Error> {
+    let ruby = Ruby::get().expect("Ruby not initialized");
+    let dpi_opt = if dpi <= 0 { None } else { Some(dpi) };
+
+    let iter = kreuzberg::pdf::PdfPageIterator::from_file(&path, dpi_opt, None)
+        .map_err(|e| kreuzberg_error(e.into()))?;
+
+    for result in iter {
+        let (page_index, png_bytes) = result.map_err(|e| kreuzberg_error(e.into()))?;
+        let rb_index = ruby.integer_from_i64(page_index as i64);
+        let rb_bytes = ruby.str_from_slice(&png_bytes);
+        let _: magnus::Value = ruby.yield_values((rb_index, rb_bytes))?;
+    }
+
+    Ok(())
+}
+
+/// Render a single PDF page to PNG bytes.
+pub fn native_render_pdf_page(path: String, page_index: i64, dpi: i64) -> Result<Vec<u8>, Error> {
+    if page_index < 0 {
+        return Err(crate::error_handling::runtime_error("page_index must be non-negative"));
+    }
+    let pdf_bytes = std::fs::read(&path)
+        .map_err(|e| crate::error_handling::runtime_error(format!("Failed to read file: {}", e)))?;
+    let dpi_opt = if dpi <= 0 { None } else { Some(dpi as i32) };
+    kreuzberg::pdf::render_pdf_page_to_png(&pdf_bytes, page_index as usize, dpi_opt, None)
+        .map_err(|e| kreuzberg_error(e.into()))
+}
+
 /// Extract content from bytes (asynchronous)
 pub fn extract_bytes(args: &[Value]) -> Result<RHash, Error> {
     let ruby = Ruby::get().expect("Ruby not initialized");

data/ext/kreuzberg_rb/native/src/lib.rs

@@ -23,7 +23,7 @@ pub use gc_guarded_value::GcGuardedValue;
 pub use helpers::{get_kw, set_hash_entry, json_value_to_ruby, ruby_value_to_json, cache_root_dir, cache_directories};
 pub use config::parse_extraction_config;
 pub use result::extraction_result_to_ruby;
-pub use extraction::{extract_file_sync, extract_bytes_sync, extract_file, extract_bytes};
+pub use extraction::{extract_file_sync, extract_bytes_sync, extract_file, extract_bytes, render_pdf_pages_iter, native_render_pdf_page};
 pub use batch::{
     batch_extract_files_sync, batch_extract_bytes_sync, batch_extract_files, batch_extract_bytes,
 };
@@ -442,6 +442,10 @@ fn init(ruby: &Ruby) -> Result<(), Error> {
     module.define_module_function("batch_extract_files", function!(batch_extract_files, -1))?;
     module.define_module_function("batch_extract_bytes", function!(batch_extract_bytes, -1))?;
 
+    // PDF page iterator
+    module.define_module_function("native_render_pdf_pages_iter", function!(render_pdf_pages_iter, 2))?;
+    module.define_module_function("native_render_pdf_page", function!(native_render_pdf_page, 3))?;
+
     // Cache functions
     module.define_module_function("clear_cache", function!(ruby_clear_cache, 0))?;
     module.define_module_function("cache_stats", function!(ruby_cache_stats, 0))?;

data/lib/kreuzberg/config.rb

@@ -926,14 +926,14 @@ module Kreuzberg
     #   )
     #
     class Extraction
-      attr_reader :use_cache, :enable_quality_processing, :force_ocr,
+      attr_reader :use_cache, :enable_quality_processing, :force_ocr, :force_ocr_pages,
                   :include_document_structure,
                   :ocr, :chunking, :language_detection, :pdf_options,
                   :images, :postprocessor,
                   :token_reduction, :keywords, :html_options, :pages,
                   :max_concurrent_extractions, :output_format, :result_format,
                   :security_limits, :layout, :concurrency,
-                  :cache_namespace, :cache_ttl_secs
+                  :cache_namespace, :cache_ttl_secs, :extraction_timeout_secs
 
       # Alias for backward compatibility - image_extraction is the canonical name
       alias image_extraction images
@@ -954,11 +954,11 @@ module Kreuzberg
       #
       # Keys that are allowed in the Extraction config
       ALLOWED_KEYS = %i[
-        use_cache enable_quality_processing force_ocr include_document_structure ocr chunking
+        use_cache enable_quality_processing force_ocr force_ocr_pages include_document_structure ocr chunking
         language_detection pdf_options image_extraction
         postprocessor token_reduction keywords html_options pages
         max_concurrent_extractions output_format result_format
-        security_limits layout concurrency cache_namespace cache_ttl_secs
+        security_limits layout concurrency cache_namespace cache_ttl_secs extraction_timeout_secs
       ].freeze
 
       # Aliases for backward compatibility
@@ -1019,6 +1019,7 @@ module Kreuzberg
                      use_cache: true,
                      enable_quality_processing: true,
                      force_ocr: false,
+                     force_ocr_pages: nil,
                      include_document_structure: false,
                      ocr: nil,
                      chunking: nil,
@@ -1037,10 +1038,12 @@ module Kreuzberg
                      layout: nil,
                      concurrency: nil,
                      cache_namespace: nil,
-                     cache_ttl_secs: nil)
+                     cache_ttl_secs: nil,
+                     extraction_timeout_secs: nil)
         kwargs = {
           use_cache: use_cache, enable_quality_processing: enable_quality_processing,
-          force_ocr: force_ocr, include_document_structure: include_document_structure,
+          force_ocr: force_ocr, force_ocr_pages: force_ocr_pages,
+          include_document_structure: include_document_structure,
           ocr: ocr, chunking: chunking, language_detection: language_detection,
           pdf_options: pdf_options, image_extraction: image_extraction,
           postprocessor: postprocessor,
@@ -1050,7 +1053,8 @@ module Kreuzberg
           security_limits: security_limits, layout: layout,
           concurrency: concurrency,
           cache_namespace: cache_namespace,
-          cache_ttl_secs: cache_ttl_secs
+          cache_ttl_secs: cache_ttl_secs,
+          extraction_timeout_secs: extraction_timeout_secs
         }
         extracted = extract_from_hash(hash, kwargs)
 
@@ -1068,6 +1072,7 @@ module Kreuzberg
         @use_cache = params[:use_cache] ? true : false
         @enable_quality_processing = params[:enable_quality_processing] ? true : false
         @force_ocr = params[:force_ocr] ? true : false
+        @force_ocr_pages = params[:force_ocr_pages]
         @include_document_structure = params[:include_document_structure] ? true : false
         @ocr = normalize_config(params[:ocr], OCR)
         @chunking = normalize_config(params[:chunking], Chunking)
@@ -1086,6 +1091,7 @@ module Kreuzberg
         @result_format = validate_result_format(params[:result_format])
         @cache_namespace = params[:cache_namespace]
         @cache_ttl_secs = params[:cache_ttl_secs]&.to_i
+        @extraction_timeout_secs = params[:extraction_timeout_secs]&.to_i
         @security_limits = params[:security_limits]
       end
 
@@ -1118,12 +1124,14 @@ module Kreuzberg
           use_cache: @use_cache,
           enable_quality_processing: @enable_quality_processing,
           force_ocr: @force_ocr,
+          force_ocr_pages: @force_ocr_pages,
           include_document_structure: @include_document_structure,
           max_concurrent_extractions: @max_concurrent_extractions,
           output_format: @output_format,
           result_format: @result_format,
           cache_namespace: @cache_namespace,
-          cache_ttl_secs: @cache_ttl_secs
+          cache_ttl_secs: @cache_ttl_secs,
+          extraction_timeout_secs: @extraction_timeout_secs
         }
       end
 
@@ -1250,6 +1258,8 @@ module Kreuzberg
           @enable_quality_processing = value ? true : false
         when :force_ocr
           @force_ocr = value ? true : false
+        when :force_ocr_pages
+          @force_ocr_pages = value
         when :include_document_structure
           @include_document_structure = value ? true : false
         when :ocr
@@ -1286,6 +1296,8 @@ module Kreuzberg
           @cache_namespace = value
         when :cache_ttl_secs
           @cache_ttl_secs = value&.to_i
+        when :extraction_timeout_secs
+          @extraction_timeout_secs = value&.to_i
         else
           raise ArgumentError, "Unknown configuration key: #{key}"
         end
@@ -1345,6 +1357,7 @@ module Kreuzberg
         @use_cache = merged.use_cache
         @enable_quality_processing = merged.enable_quality_processing
         @force_ocr = merged.force_ocr
+        @force_ocr_pages = merged.force_ocr_pages
         @include_document_structure = merged.include_document_structure
         @ocr = merged.ocr
         @chunking = merged.chunking
@@ -1369,6 +1382,7 @@ module Kreuzberg
         @result_format = merged.result_format
         @cache_namespace = merged.cache_namespace
         @cache_ttl_secs = merged.cache_ttl_secs
+        @extraction_timeout_secs = merged.extraction_timeout_secs
       end
     end
   end

data/lib/kreuzberg/extraction_api.rb

@@ -319,6 +319,43 @@ module Kreuzberg
       results
     end
 
+    # Render a single PDF page as a PNG image.
+    #
+    # @param path [String, Pathname] Path to the PDF file
+    # @param page_index [Integer] Zero-based page index
+    # @param dpi [Integer] Rendering resolution (default 150)
+    # @return [String] PNG-encoded binary string
+    # @raise [Errors::IOError] If the file cannot be read
+    # @raise [Errors::ParsingError] If rendering fails
+    def render_pdf_page(path, page_index, dpi: 150)
+      path_str = path.to_s
+      raise ArgumentError, 'page_index must be non-negative' if page_index.negative?
+      raise Errors::IOError, "File not found: #{path_str}" unless File.exist?(path_str)
+
+      native_render_pdf_page(path_str, page_index, dpi)
+    end
+
+    # Iterate over pages of a PDF lazily, yielding each page as it is rendered.
+    #
+    # Each page is rendered via the native FFI iterator, so only one page is in
+    # memory at a time.
+    #
+    # @param path [String, Pathname] Path to the PDF file
+    # @param dpi [Integer] Rendering resolution (default 150)
+    # @yieldparam page_index [Integer] Zero-based page index
+    # @yieldparam png_bytes [String] PNG-encoded binary string for the page
+    # @return [Enumerator] if no block is given
+    # @raise [Errors::IOError] If the file cannot be read
+    # @raise [Errors::ParsingError] If rendering fails
+    def render_pdf_pages_iter(path, dpi: 150, &block)
+      path_str = path.to_s
+      raise Errors::IOError, "File not found: #{path_str}" unless File.exist?(path_str)
+
+      return enum_for(:render_pdf_pages_iter, path, dpi: dpi) unless block
+
+      native_render_pdf_pages_iter(path_str, dpi, &block)
+    end
+
     def normalize_config(config)
       return {} if config.nil?
       return config if config.is_a?(Hash)

data/lib/kreuzberg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kreuzberg
-  VERSION = '4.6.0'
+  VERSION = '4.6.2'
 end

data/sig/kreuzberg.rbs

@@ -481,7 +481,9 @@ module Kreuzberg
       attr_reader enable_quality_processing: bool
       attr_reader cache_namespace: String?
       attr_reader cache_ttl_secs: Integer?
+      attr_reader extraction_timeout_secs: Integer?
       attr_reader force_ocr: bool
+      attr_reader force_ocr_pages: Array[Integer]?
       attr_reader include_document_structure: bool
       attr_reader ocr: OCR?
       attr_reader chunking: Chunking?
@@ -508,6 +510,7 @@ module Kreuzberg
         ?use_cache: bool,
         ?enable_quality_processing: bool,
         ?force_ocr: bool,
+        ?force_ocr_pages: Array[Integer]?,
         ?include_document_structure: bool,
         ?ocr: (OCR | Hash[Symbol, untyped])?,
         ?chunking: (Chunking | Hash[Symbol, untyped])?,
@@ -525,7 +528,8 @@ module Kreuzberg
         ?output_format: String?,
         ?result_format: String?,
         ?cache_namespace: String?,
-        ?cache_ttl_secs: Integer?
+        ?cache_ttl_secs: Integer?,
+        ?extraction_timeout_secs: Integer?
       ) -> void
       def to_h: () -> Hash[Symbol, untyped]
       def to_json: (*untyped) -> String

data/spec/binding/render_spec.rb

@@ -0,0 +1,91 @@
+# Hand-written binding-specific edge case tests for PDF rendering.
+# Happy-path render tests are auto-generated from fixtures in e2e/.
+# These tests cover error handling, validation, and lifecycle patterns
+# that vary per language and can't be generated uniformly.
+
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'PDF Rendering' do
+  it 'exposes rendering methods' do
+    expect(Kreuzberg).to respond_to(:render_pdf_page)
+    expect(Kreuzberg).to respond_to(:render_pdf_pages_iter)
+  end
+
+  describe '.render_pdf_page' do
+    it 'raises an error for a nonexistent file' do
+      expect do
+        Kreuzberg.render_pdf_page('/nonexistent/path/to/document.pdf', 0)
+      end.to raise_error(Kreuzberg::Errors::IOError)
+    end
+
+    it 'raises an error for an out-of-bounds page index' do
+      pdf_path = test_document_path('pdf/tiny.pdf')
+      skip 'Test PDF not available' unless File.exist?(pdf_path)
+
+      expect do
+        Kreuzberg.render_pdf_page(pdf_path, 9999)
+      end.to raise_error(StandardError)
+    end
+  end
+
+  describe '.render_pdf_page with negative index' do
+    it 'raises ArgumentError for a negative page index' do
+      pdf_path = test_document_path('pdf/tiny.pdf')
+      skip 'Test PDF not available' unless File.exist?(pdf_path)
+
+      expect do
+        Kreuzberg.render_pdf_page(pdf_path, -1)
+      end.to raise_error(ArgumentError)
+    end
+  end
+
+  describe '.render_pdf_pages_iter' do
+    it 'raises an error for a nonexistent file' do
+      expect do
+        Kreuzberg.render_pdf_pages_iter('/nonexistent/path/to/document.pdf') { |_, _| nil }
+      end.to raise_error(Kreuzberg::Errors::IOError)
+    end
+  end
+
+  describe '.render_pdf_page with empty path' do
+    it 'raises an error for an empty path' do
+      expect do
+        Kreuzberg.render_pdf_page('', 0)
+      end.to raise_error(StandardError)
+    end
+  end
+
+  describe '.render_pdf_pages_iter cleanup' do
+    it 'handles iterator cleanup without fully consuming' do
+      pdf_path = test_document_path('pdf/tiny.pdf')
+      skip 'Test PDF not available' unless File.exist?(pdf_path)
+
+      # Iterate but stop immediately — no crash
+      Kreuzberg.render_pdf_pages_iter(pdf_path) do |_page_index, _png_data|
+        break
+      end
+    end
+  end
+
+  describe '.render_pdf_pages_iter early termination' do
+    it 'returns valid PNG for the first page then stops' do
+      pdf_path = test_document_path('pdf/tiny.pdf')
+      skip 'Test PDF not available' unless File.exist?(pdf_path)
+
+      first_png = nil
+      Kreuzberg.render_pdf_pages_iter(pdf_path) do |page_index, png_data|
+        expect(page_index).to eq(0)
+        expect(png_data).to be_a(String)
+        expect(png_data.bytesize).to be > 8
+        # PNG magic bytes
+        expect(png_data.bytes[0..3]).to eq([0x89, 0x50, 0x4E, 0x47])
+        first_png = png_data
+        break
+      end
+
+      expect(first_png).not_to be_nil
+    end
+  end
+end

data/vendor/Cargo.toml

@@ -2,7 +2,7 @@
 members = ["kreuzberg", "kreuzberg-ffi", "kreuzberg-tesseract", "kreuzberg-paddle-ocr", "kreuzberg-pdfium-render"]
 
 [workspace.package]
-version = "4.6.0"
+version = "4.6.2"
 edition = "2024"
 rust-version = "1.91"
 authors = ["Na'aman Hirschfeld <naaman@kreuzberg.dev>"]
@@ -30,8 +30,8 @@ html-to-markdown-rs = { version = "2.29.0", default-features = false }
 image = { version = "0.25.10", default-features = false }
 itertools = "0.14"
 js-sys = "0.3"
-kreuzberg = { path = "./crates/kreuzberg", version = "4.6.0", default-features = false }
-kreuzberg-ffi = { path = "./crates/kreuzberg-ffi", version = "4.6.0" }
+kreuzberg = { path = "./crates/kreuzberg", version = "4.6.2", default-features = false }
+kreuzberg-ffi = { path = "./crates/kreuzberg-ffi", version = "4.6.2" }
 lazy_static = "1.5.0"
 libc = "0.2.183"
 log = "0.4"