atlas_rb 1.3.5 → 1.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21def65708de4960bb66f35c923b37b4caff75a7eb4c17721abb2e20982c8afc
-  data.tar.gz: e75048782fac64edb37a5e8a4798b126a2939e70a38770f4b78848bfd77ca160
+  metadata.gz: e15c24fddbec1fba3da8aef5e85d769ddf4861e9bccad136957b342515e34dab
+  data.tar.gz: 2044a925120234a5e3fa1553fc3fc4ec2b3dad05c4215af58697c157fc84cdff
 SHA512:
-  metadata.gz: 4e9a70d364d40dfc8f21b42d29c0eae9905b52d76858d855375af12590d2250f13b70af67be75d95384658041ac5676c37d4d78664cc8d8d623fab07cc45b246
-  data.tar.gz: ea5156c1b8f0c842ed2ad3dc342fafd3153c0d9fd733c73a840a6aa6f8ff404bdd1854e026502a6a1f0e4a94b8c7959c0f8596a961c6aa204a82c1f5ca559653
+  metadata.gz: a62880ec96483584dc82cacd3a186822ec7af2f64893ede345ccc73f071462106f21b753579dcb6eb9c391018860f828881d4fa7cbe191da4f3e8a76b27d6574
+  data.tar.gz: b4f66124c5b5c51e550a13b3c60a01a4ce9d6efaa771577be41d46d8f4172967d5124441db1a2a55c44717b92898175643c35d74afe550405a5d57a75fe73767

data/.version

@@ -1 +1 @@
-1.3.5
+1.3.6

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (1.3.5)
+    atlas_rb (1.3.6)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)

data/lib/atlas_rb/file_set.rb

@@ -123,5 +123,42 @@ module AtlasRb
         multipart(nuid, on_behalf_of: on_behalf_of).patch(ROUTE + id, payload)&.body
       ))
     end
+
+    # Persist the per-page IIIF image-service pointer on a FileSet.
+    #
+    # Purpose-specific PATCH for the `service_file` Delegate role — the
+    # Cantaloupe image-service base URI for this page's JP2, from which a
+    # viewer derives any size on demand via `info.json`. Atlas upserts the
+    # Delegate (re-setting never mints a duplicate), nesting it in a
+    # `:derivative` FileSet under the page; it surfaces in the ordered
+    # page listing ({Work.file_sets}) for IIIF manifest assembly.
+    #
+    # Sibling of {Work.set_thumbnails} / {Work.set_image_derivatives} —
+    # a machine-set IIIF URI, not user-authored descriptive content.
+    #
+    # @param id [String] the FileSet ID.
+    # @param uri [String] the IIIF image-service base URI for the page.
+    # @param nuid [String, nil] optional acting user's NUID, forwarded as the
+    #   `User:` header. Required for cerberus-token requests; legacy bearer
+    #   tokens still resolve without it.
+    # @param on_behalf_of [String, nil] optional NUID for the `On-Behalf-Of`
+    #   header. Falls through to {AtlasRb.config}.default_on_behalf_of when
+    #   omitted.
+    # @return [AtlasRb::Mash] the updated `"file_set"` payload.
+    # @raise [AtlasRb::StaleResourceError] if Atlas reports an optimistic-lock
+    #   conflict that exhausted its internal retry budget (HTTP 409 with
+    #   `error: "stale_resource"`).
+    #
+    # @example
+    #   AtlasRb::FileSet.set_iiif_service(
+    #     "fs-001",
+    #     "https://iiif.example.edu/iiif/3/abc.jp2"
+    #   )
+    def self.set_iiif_service(id, uri, nuid: nil, on_behalf_of: nil)
+      AtlasRb::Mash.new(JSON.parse(
+        connection({}, nuid, on_behalf_of: on_behalf_of)
+          .patch(ROUTE + id + "/iiif_service", JSON.dump({ uri: uri }))&.body
+      ))
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.3.5
+  version: 1.3.6
 platform: ruby
 authors:
 - David Cliff