atlas_rb 1.3.4 → 1.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f1d65e6631474391c3971b939e6394049b6b5f4198a14ffd55bd5e9c51d2bbf
-  data.tar.gz: d3371babc6a6aca8141a3692b399fd9989d5f8f29341ac376e3d1bed5850d0f4
+  metadata.gz: e15c24fddbec1fba3da8aef5e85d769ddf4861e9bccad136957b342515e34dab
+  data.tar.gz: 2044a925120234a5e3fa1553fc3fc4ec2b3dad05c4215af58697c157fc84cdff
 SHA512:
-  metadata.gz: f9450d1ed3d4c77708b619c4c48686c35606cee0d8633d9fcd448440127398b613f2d664fb672bbfaccb0bf44143ccbf8731aac29e3d967f09b56177ab7517ae
-  data.tar.gz: acb806ac1e60026594bac52eb124415439daa77ceb219cc5465dc961d16ab78b2dc481fe64256a5cbf109e67347170ac15e2f484fb7d19ea248b69406a950834
+  metadata.gz: a62880ec96483584dc82cacd3a186822ec7af2f64893ede345ccc73f071462106f21b753579dcb6eb9c391018860f828881d4fa7cbe191da4f3e8a76b27d6574
+  data.tar.gz: b4f66124c5b5c51e550a13b3c60a01a4ce9d6efaa771577be41d46d8f4172967d5124441db1a2a55c44717b92898175643c35d74afe550405a5d57a75fe73767

data/.version

@@ -1 +1 @@
-1.3.4
+1.3.6

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.3.5
+
+### Added — `Compilation.list(q:)` title filter
+
+`Compilation.list` accepts `q:`, a case-insensitive title substring
+filter (Atlas v0.6.60, `GET /compilations?q=<term>`). The filter applies
+before pagination, so the returned `"pagination"` block describes the
+filtered result. Backs the Cerberus Add-to-set typeahead.
+
+```ruby
+AtlasRb::Compilation.list(q: "course", nuid: "000000002")
+```
+
 ## 1.3.4
 
 ### Added — Compilation (DRS "Sets") bindings

data/Gemfile.lock

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

data/lib/atlas_rb/compilation.rb

@@ -57,10 +57,13 @@ module AtlasRb
     #
     # Defaults to the acting user's own Sets. Pass `owner:` to list another
     # user's — that is admin-only and raises {AtlasRb::ForbiddenError} for
-    # anyone else. There is no public browse surface.
+    # anyone else. There is no public browse surface. Pass `q:` to narrow
+    # by case-insensitive title substring; the filter applies before
+    # pagination, so the `"pagination"` block describes the filtered result.
     #
     # @param owner [String, nil] NUID whose Sets to list (admin-only when it
     #   isn't the acting user). Omit for "my Sets".
+    # @param q [String, nil] case-insensitive title substring filter.
     # @param page [Integer, nil] 1-indexed page number.
     # @param per_page [Integer, nil] page size override.
     # @param nuid [String, nil] optional acting user's NUID, forwarded as the
@@ -78,9 +81,13 @@ module AtlasRb
     #
     # @example Another user's Sets (admin)
     #   AtlasRb::Compilation.list(owner: "000000002", nuid: "000000004")
-    def self.list(owner: nil, page: nil, per_page: nil, nuid: nil, on_behalf_of: nil)
+    #
+    # @example Title typeahead
+    #   AtlasRb::Compilation.list(q: "course", nuid: "000000002")
+    def self.list(owner: nil, q: nil, page: nil, per_page: nil, nuid: nil, on_behalf_of: nil)
       params = {}
       params[:owner]    = owner    if owner
+      params[:q]        = q        if q
       params[:page]     = page     if page
       params[:per_page] = per_page if per_page
       AtlasRb::Mash.new(JSON.parse(

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.4
+  version: 1.3.6
 platform: ruby
 authors:
 - David Cliff