rubrik 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a28dfceafc9ceb57e6b2a30f82b6e8ca237c8ce3381a05d6793568154775c43a
-  data.tar.gz: 1a0a6f8b8079396583cdf27fae2638a9f24c16f0483c830d54a805dc707982f5
+  metadata.gz: 1092e4bfdff7f05272eab8cf226a09b54737f368c24e883370002a399036ce4a
+  data.tar.gz: 818072d3ea9003599a9ec5fb49af2df99f3f43045e9aa6a81a1e62e8f2c11fd3
 SHA512:
-  metadata.gz: 4b294ed919bade9e09eef834afb47a17f65928b40099a9add84f079df46102e852a7289c7fbacbb745b67929ae14098fc002ebd2b12987a921e4461b5996a406
-  data.tar.gz: 283e213a97967fb54d4c2b21f2ab009e96c434a93b26f3ff34ee4f75cfdcd925bd5cbc633bcb22844822ed4eb2e36efa4158f33b40f633b5ade6af7c9d97d30a
+  metadata.gz: 173091b0ab44b398a10260e267de6ff92fe8083d2668dabe86e79bdb93547151ad9b73e08296c955e3e604ebba4b1f9f74fc44ae91ef661839883cd96f71fe9d
+  data.tar.gz: 60a0c1647190a473703ac1ae1cf1e5d407bc59e4f599b1de6d3111c3dd7105fa8077ec7955fed5df1c5c088dc9a515e7b5b3bd1987a0d42dc2835f5ca8585313

data/README.md

@@ -22,6 +22,7 @@ This gem is under development and may be subjected to breaking changes.
 
 ### PDF Features
 - [x] Modify PDFs with incremental updates (doesn't modify the documents, only append signature appearance)
+- [ ] Encryption Support
 - [ ] Signature appearance (stamp)
 - [ ] External (offline) signatures
 

data/lib/rubrik/document/serialize_object.rb

@@ -15,14 +15,14 @@ module Rubrik
           serialized_objs = obj.flatten.map { |e| SerializeObject[e] }
           "<<#{serialized_objs.join(" ")}>>"
         when Symbol
-          "/#{obj}"
+          serialize_symbol(obj)
         when Array
           serialized_objs = obj.map { |e| SerializeObject[e] }
           "[#{serialized_objs.join(" ")}]"
         when PDF::Reader::Reference
           "#{obj.id} #{obj.gen} R"
         when String
-          "(#{obj})"
+          serialize_string(obj)
         when TrueClass
           "true"
         when FalseClass
@@ -48,6 +48,43 @@ module Rubrik
       end
 
       alias call []
+
+      private
+
+      STRING_ESCAPE_MAP = {
+        "\n" => "\\\n",
+        "\r" => "\\\r",
+        "\t" => "\\\t",
+        "\b" => "\\\b",
+        "\f" => "\\\f",
+        "\\" => "\\\\",
+        "(" => "\\(",
+        ")" => "\\)"
+      }.freeze
+
+      sig {params(string: String).returns(String)}
+      def serialize_string(string)
+        "(#{string.gsub(/[\n\r\t\b\f\\()]/n, STRING_ESCAPE_MAP)})"
+      end
+
+      DELIMITERS = "()<>[]{}/%".bytes.freeze
+      REGULAR_CHARACTERS =
+        "!\"\#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~".bytes.freeze
+
+
+      NAME_ESCAPE_CHARACTERS = (0..255).to_a - REGULAR_CHARACTERS + DELIMITERS + "#".bytes
+      NAME_ESCAPE_CHARACTERS.freeze
+
+      NAME_ESCAPE_MAP = NAME_ESCAPE_CHARACTERS.each_with_object({}) do |char, escape_map|
+        escape_map[char.chr] = "##{char.to_s(16).rjust(2, "0")}"
+      end.freeze
+
+      NAME_ESCAPE_REGEX = /[#{Regexp.escape(NAME_ESCAPE_CHARACTERS.map(&:chr).join)}]/
+
+      sig {params(symbol: Symbol).returns(String)}
+      def serialize_symbol(symbol)
+        "/#{symbol.to_s.b.gsub(NAME_ESCAPE_REGEX, NAME_ESCAPE_MAP)}"
+      end
     end
   end
 end

data/lib/rubrik/document.rb

@@ -76,12 +76,30 @@ module Rubrik
         }
       }
 
-      modified_page = objects.fetch(first_page_reference).dup
-      (modified_page[:Annots] ||= []) << signature_field_id
+      first_page = objects.fetch(first_page_reference)
+      annots = first_page[:Annots]
 
-      modified_objects << {id: first_page_reference, value: modified_page}
+      if annots.is_a?(PDF::Reader::Reference)
+        new_annots = objects.fetch(annots).dup
+        new_annots << signature_field_id
 
-      (interactive_form[:Fields] ||= []) << signature_field_id
+        modified_objects << {id: annots, value: new_annots}
+      else
+        new_first_page = first_page.dup
+        (new_first_page[:Annots] ||= []) << signature_field_id
+
+        modified_objects << {id: first_page_reference, value: new_first_page}
+      end
+
+      fields_entry = interactive_form[:Fields]
+      if fields_entry.is_a?(PDF::Reader::Reference)
+        new_fields_array = objects.fetch(fields_entry).dup
+        new_fields_array << signature_field_id
+
+        modified_objects << {id: fields_entry, value: new_fields_array}
+      else
+        (interactive_form[:Fields] ||= []) << signature_field_id
+      end
 
       signature_value_id
     end
@@ -108,11 +126,22 @@ module Rubrik
       root_ref = objects.trailer[:Root]
       root = T.let(objects.fetch(root_ref), T::Hash[Symbol, T.untyped])
 
-      if root.key?(:AcroForm)
+      interactive_form_value = root[:AcroForm]
+      case interactive_form_value
+      when PDF::Reader::Reference
         form_id = root[:AcroForm]
 
         modified_objects << {id: form_id, value: objects.fetch(form_id).dup}
-      else
+      when Hash
+        interactive_form_id = assign_new_object_id!
+
+        modified_objects << {id: interactive_form_id, value: interactive_form_value.dup}
+
+        new_root = root.dup
+        new_root[:AcroForm] = interactive_form_id
+
+        modified_objects << {id: root_ref, value: new_root}
+      when NilClass
         interactive_form_id = assign_new_object_id!
         modified_objects << {id: interactive_form_id, value: {Fields: []}}
 
@@ -121,6 +150,10 @@ module Rubrik
         updated_root[:AcroForm] = interactive_form_id
 
         modified_objects << {id: root_ref, value: updated_root}
+      else
+        raise Error.new(
+          "Expected dictionary, reference or nil but got " \
+          "#{interactive_form_value.class} on AcroForm entry.")
       end
 
       interactive_form[:SigFlags] = 3 # dont modify, append only

data/lib/rubrik/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rubrik
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubrik
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Tomás Coêlho
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-10-22 00:00:00.000000000 Z
+date: 2023-12-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pdf-reader