docpdf 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b68eda5d7355d1d3a227ef71f44d41f95dc7ccbfe7b08af17739e629c9ab26dc
-  data.tar.gz: 23e0ab911eb89df49eeac3634b50ef6d8bf8f7b74a8861067e2a0e44f3946e82
+  metadata.gz: 4fa01d67dead11a1f62eb4ff7f6f387599b97ec99d0c91bd5644e60e98fd26a6
+  data.tar.gz: 1dc447f55133af1a3ff94ad3aaaeca8014a1560cdd6db5cf2d85ab30220afa1e
 SHA512:
-  metadata.gz: 14aff5944d6ac087f241b078c557e480974f322ca2cbcf3c9d08136e6b37f6598ca1bbd17e14267b060632e83e54491dbb5dc6a42b15768eb64883bbe3fd7838
-  data.tar.gz: cb43492ce6e3b7257e3c6cc01281904c509dcb473f77e932361ae986f0f39cda9af3bc0a4080b2e8c7d24e2c13adf6d4a8b93230ed455eef6b6ed74ede98e301
+  metadata.gz: 3cfa330a65d41f8c24866b04da28d15a795df5c826f2459a9ae1c46c86c470147e92c6ff75952579d3bfd3b6fd4804747a712b868fc829102fab3ece963d0a2d
+  data.tar.gz: aa22481e4dfbb0966c9f95b1ecd5924680c491729a3c0ac8b873d2aca03c49b4889a936ce57400a3681594c5ac18078da66c8fa78b20cbed9da211316115f883

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.1.7] - 2026-10-08
+
+### Fixed
+- The HexaPDF stamper raised `ConversionError` on PDFs with spec violations HexaPDF cannot correct, even though viewers render them fine. One example is a tagged PDF exported from Canva with a structure element missing its parent. The stamper now corrects what HexaPDF can and writes the rest as it came in, the way the `hexapdf` CLI does.
+- `DocPDF.convert` raised `NameError: uninitialized constant DocPDF::InputNormalizer::Pathname` on Ruby 3.3 and 3.4 when nothing else had loaded `pathname`. Bundler and Rails both load it, so only plain Ruby scripts were affected. `DocPDF.watermark` with a file path and `font_file` given as a hash hit the same error. DocPDF now requires `pathname` itself.
+
 ## [0.1.6] - 2026-09-18
 
 ### Added

data/lib/docpdf/adapters/stampers/hexapdf.rb

@@ -22,7 +22,7 @@ module DocPDF
               page.canvas(type: :overlay).xobject(stamp_form, at: [0, 0]) if page_indices.nil? || page_indices.include?(idx)
             end
 
-            write_to_string(doc)
+            write_to_string_leniently(doc)
           rescue HexaPDF::Error, Errno::ENOENT => e
             raise ConversionError, "HexaPDF failed to stamp PDF: #{e.message}"
           end
@@ -125,11 +125,23 @@ module DocPDF
             doc.config["font.map"] = (doc.config["font.map"] || {}).merge(name => map)
           end
 
-          def write_to_string(doc)
+          def write_to_string(doc, **write_options)
             io = StringIO.new
-            doc.write(io)
+            doc.write(io, **write_options)
             io.string
           end
+
+          # The caller's PDF may break the spec in ways HexaPDF cannot repair, like a
+          # tagged PDF whose structure elements have no parent. Viewers open those
+          # fine, so correct what can be corrected and write the rest as it came in,
+          # the way the hexapdf CLI does. Objects are validated one at a time because
+          # Document#validate stops at the first one it cannot correct, and the stamp
+          # form only becomes an indirect object when validation reaches its page.
+          def write_to_string_leniently(doc)
+            doc.trailer.validate(auto_correct: true)
+            doc.each { |obj| obj.validate(auto_correct: true) }
+            write_to_string(doc, validate: false)
+          end
         end
       end
     end

data/lib/docpdf/font_files.rb

@@ -1,3 +1,5 @@
+require "pathname"
+
 module DocPDF
   # Prawn's built-in AFM fonts only cover Windows-1252, so any text outside it
   # fails to render. Pointing an adapter at a TrueType file lifts that limit.

data/lib/docpdf/input_normalizer.rb

@@ -1,3 +1,5 @@
+require "pathname"
+
 module DocPDF
   class InputNormalizer
     attr_reader :data, :filename, :source_filename, :mime_type

data/lib/docpdf/version.rb

@@ -1,3 +1,3 @@
 module DocPDF
-  VERSION = "0.1.6"
+  VERSION = "0.1.7"
 end

data/lib/docpdf/watermarker.rb

@@ -1,3 +1,5 @@
+require "pathname"
+
 module DocPDF
   class Watermarker
     POSITIONS = %i[center top bottom left right top_left top_right bottom_left bottom_right].freeze

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docpdf
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Velocity Labs, LLC