iiif_print 3.0.12 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4551ae83d8bd370109a2532c3bd4cbeab4e97b8cc33f6044ece488eb2e3788c
-  data.tar.gz: 33ca8e19b35d2b25b3bca1a032a711079313646115988e56eae71945ba7e9f04
+  metadata.gz: 4050e3e2e6c79d5d93bc63e2801f75bb13a7a1985dc2729ead3c0a15c4855075
+  data.tar.gz: b0d627fa5b6d190d0fbdae66e2db116e77eb74bf3473630c008a61dd794ed600
 SHA512:
-  metadata.gz: 7f38d9d98db8f547d5fb9af63e44cfb1ef5e616cc7e513d70ccee194f830668a2f259923fe7be7ba5fe19be834a46d56494e3988ac1f20fe219d6b5a0b589b94
-  data.tar.gz: 3630e05021abcc8dc82788c1dc88bdc7ecfbfa21214280ea291e89c3d8f23fe03740a9dcc19baa8c8c527c10b931b0256f03b762776cc53caf2c6fd45a0a0d8e
+  metadata.gz: c9f52bc069331756409eae5f67b878b2801c46d14e44fa36804faed750cfb2c07c5159015e5e236c084b0dcf8e0d2412d2d907905c43a07feba068c475761160
+  data.tar.gz: 7f58c71b8f933df6cec597f766494091a3c33fcd4734a14118ee7213d80262d52ebd3196b452267136913dfcba3a614fbc81dfbf7399edacb44687a6defa7876

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: /app/samvera/hyrax-webapp
   specs:
-    iiif_print (3.0.12)
+    iiif_print (3.1.0)
       blacklight_iiif_search (>= 1.0, < 3.0)
       derivative-rodeo (~> 0.5)
       hyrax (>= 2.5, < 6)

data/README.md

@@ -121,7 +121,17 @@ We created IiifPrint with an assumption of ActiveFedora.  However, as Hyrax now
 
 ### IIIF URL configuration
 
-If you set EXTERNAL_IIIF_URL in your environment, then IiifPrint will use that URL as the root for your IIIF URLs. It will also switch from using the file set ID to using the SHA1 of the file as the identifier. This enables using serverless_iiif or Cantaloupe (refered to as the service) by pointing the service to the same S3 bucket that FCREPO writes the uploaded files to. By setting it up that way you do not need the service to connect to FCREPO or Hyrax at all, both natively support connecting to an S3 bucket to get their data.
+If you set `EXTERNAL_IIIF_URL` in your environment, IiifPrint will use that URL as the root for your IIIF URLs. It will also switch from using the file set ID to using the file's checksum hex digest as the identifier. In Wings/Fedora mode the digest is stored as a `urn:sha1:HEX` string; in Valkyrie mode it is stored as a plain hex string — IiifPrint handles both automatically.
+
+This enables using serverless_iiif or Cantaloupe (referred to as the service) by pointing the service to the same S3 bucket that the repository writes uploaded files to. By setting it up that way you do not need the service to connect to Fedora or Hyrax at all — both natively support connecting to an S3 bucket to retrieve file content.
+
+If your S3 bucket organises files under a folder prefix (e.g. a `staging/` or `production/` subfolder), set `IIIF_S3_FOLDER_PREFIX` to that prefix. IiifPrint will prepend it to the digest identifier and percent-encode the separator so the combined value is a single IIIF path segment:
+
+```
+EXTERNAL_IIIF_URL=https://iiif.example.org
+IIIF_S3_FOLDER_PREFIX=staging
+# → identifier used: staging%2F<hex-digest>
+```
 
 ### Model level configurations
 

data/app/models/concerns/iiif_print/solr_document_decorator.rb

@@ -2,8 +2,17 @@
 
 module IiifPrint
   module SolrDocumentDecorator
+    def digest_hex
+      raw = digest
+      return nil if raw.blank?
+      # Wings/Fedora stores "urn:sha1:HEX" or "urn:md5:HEX"; Valkyrie stores a plain hex string.
+      raw[/\Aurn:[^:]+:([\w]+)\z/, 1] || raw
+    end
+
     def digest_sha1
-      digest[/urn:sha1:([\w]+)/, 1]
+      Deprecation.warn(self, "#digest_sha1 is deprecated; use #digest_hex instead. " \
+                             "#digest_sha1 will be removed in the next major version.")
+      digest_hex
     end
 
     def method_missing(method_name, *args, &block)

data/app/presenters/iiif_print/iiif_manifest_presenter/display_image_presenter_decorator.rb

@@ -1,3 +1,5 @@
+require 'cgi'
+
 # mixin to provide URL for IIIF Content Search service
 module IiifPrint
   module IiifManifestPresenter
@@ -82,7 +84,13 @@ module IiifPrint
       end
 
       def external_latest_file_id
-        @latest_file_id ||= digest_sha1
+        hex = digest_hex
+        return nil if hex.blank?
+
+        prefix = ENV['IIIF_S3_FOLDER_PREFIX'].presence
+        return hex unless prefix
+
+        CGI.escape("#{prefix}/#{hex}")
       end
 
       def iiif_image_url_builder(url_builder:)

data/app/transactions/hyrax/transactions/iiif_print_container_decorator.rb

@@ -1,5 +1,15 @@
 # frozen_string_literal: true
 
+begin
+  require 'dry/container'
+rescue LoadError
+  nil
+end
+
+# dry-transaction >= 0.15 dropped dry-container, so Dry::Container::Mixin is unavailable in those
+# environments. Guard the entire decorator so iiif_print still boots in Hyrax 2.x / newer dry-rb.
+return unless defined?(Dry::Container)
+
 module Hyrax
   module Transactions
     ##

data/lib/iiif_print/version.rb

@@ -1,3 +1,3 @@
 module IiifPrint
-  VERSION = '3.0.12'.freeze
+  VERSION = '3.1.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: iiif_print
 version: !ruby/object:Gem::Version
-  version: 3.0.12
+  version: 3.1.0
 platform: ruby
 authors:
 - Sean Upton
@@ -14,7 +14,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-06 00:00:00.000000000 Z
+date: 2026-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: blacklight_iiif_search
@@ -511,7 +511,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.3.20
 signing_key:
 specification_version: 4
 summary: IiifPrint is a gem (Rails "engine") for Hyrax-based digital repository applications