atlas_rb 1.2.2 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29da2e41c70d17572c6c24002ba0ff25beb2ad6cdd940dee157a83133c86efaf
-  data.tar.gz: 9e16fed8e22867c37647a12de104135d78f57995ba5e6decd4929ac6a402bae7
+  metadata.gz: d65fea7329731bd0fa0a397a19f5764a05e88397c522baf28721e4a08282e2d3
+  data.tar.gz: 7b2db70c9e1a7d9e8fad5194bcb045baeed562561b1c36a60c174e2c1fc5d0aa
 SHA512:
-  metadata.gz: 7ba5a0216a5cc5dacce4f6822078eb07d71aa4e14b31142c83dd823c0ec177efa92e1712eac0b235c125870611dcd4633817066c5ee70a98d6f85adbec614a7f
-  data.tar.gz: b176fc377d6d802e356c5f0a0fd487c6c899d4b5e323e3017eb773fd11e06dd8ebb415329a4c4e81aef5f55f0086602fc33a6cb82c4699709e0a3209c542a48d
+  metadata.gz: 335c7d4bd02d6bdb6f297cf86857c042d515680fb8e36991d98a7a7bf4fdd1e52470f0dda4b40605f79d0618c7260a64f2125af2a3100a693c920b51ebc1c1f5
+  data.tar.gz: ce1bc4b16ce482975af0785138574aa6b42fc2cc05ddfee777adbef2834b733bdb93df5390cfc4e9a5012af4b9483cf5676f7213edc8e79afc0fd886d2b84545

data/.version

@@ -1 +1 @@
-1.2.2
+1.3.0

data/CHANGELOG.md

@@ -1,6 +1,33 @@
 # Changelog
 
-## Unreleased
+## 1.3.0
+
+### Added — `AtlasRb::Resource.find_many` (batch resolve by NOID)
+
+A binding for Atlas's `POST /resources/find_many`. Resolves a set of NOIDs
+to lightweight digests in **one** round-trip, replacing the `find`-per-id
+fan-out that several Cerberus surfaces (breadcrumbs, linked-member lists,
+load-destination pickers) paid on every render.
+
+```ruby
+nodes   = AtlasRb::Resource.find_many(["col-456", "col-457", "missing"])
+by_noid = nodes.index_by { |n| n["noid"] }
+by_noid["col-456"].title   # => "Some Collection"
+```
+
+- Each digest is `{ "id", "noid", "klass", "title", "thumbnail",
+  "tombstoned" }` — not the full typed payload. `title` / `thumbnail` are
+  `null` for resources off the Modsable backbone (FileSet/Blob).
+- The ids ride in the request **body**, so the list isn't bounded by URL
+  length. Returns one `AtlasRb::Mash` per resolved resource.
+- The result is **unordered** and **may be shorter than the input**:
+  unresolvable ids are dropped, tombstoned ones come back flagged
+  (`"tombstoned" => true`). Index by `"noid"` — don't assume positional
+  correspondence with the input.
+- Resolves NOIDs (alternate ids) only; raw Valkyrie ids are not a supported
+  input.
+
+## 1.2.2
 
 ### Added — `AtlasRb::AuditEvent.emit` (session-scoped audit events)
 

data/Gemfile.lock

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

data/README.md

@@ -312,6 +312,27 @@ The two mutations raise the same way `reparent` does — `LinkedMemberError`
 on a structural `422` (carrying the envelope's `error` code as `#code`) and
 `ForbiddenError` on a `403` — instead of swallowing the envelope.
 
+### Batch resolve (`Resource.find_many`)
+
+When you have a *set* of NOIDs and only need each one's title / klass /
+thumbnail — breadcrumb chains, linked-member lists, load-destination
+pickers — resolve them in one round-trip instead of a `find`-per-id
+fan-out:
+
+```ruby
+nodes   = AtlasRb::Resource.find_many(["col-456", "col-457", "missing"])
+by_noid = nodes.index_by { |n| n["noid"] }
+by_noid["col-456"].title   # => "Some Collection"
+```
+
+Each entry is a lightweight digest — `{ "id", "noid", "klass", "title",
+"thumbnail", "tombstoned" }` — not the full typed payload. The ids travel
+in the request body (no URL-length ceiling). The result is **unordered**
+and **may be shorter than the input**: unresolvable ids are dropped and
+tombstoned resources come back flagged (`"tombstoned" => true`), so index
+by `"noid"` rather than assuming positional correspondence. NOIDs only —
+raw Valkyrie ids are not a supported input.
+
 ## End-to-end example
 
 JSON responses come back as `AtlasRb::Mash` (a `Hashie::Mash` subclass), so

data/lib/atlas_rb/resource.rb

@@ -47,6 +47,44 @@ module AtlasRb
                         "resource" => result.first[1])
     end
 
+    # Resolve many resources by NOID in a single round-trip.
+    #
+    # Wraps Atlas's `POST /resources/find_many`, which returns one lightweight
+    # digest per resolvable resource — `{ "id", "noid", "klass", "title",
+    # "thumbnail", "tombstoned" }` — rather than full typed payloads. Use it
+    # anywhere a set of ids would otherwise be resolved with a `find`-per-id
+    # fan-out (breadcrumb chains, linked-member lists, load-destination
+    # pickers): one HTTP call instead of N.
+    #
+    # The ids travel in the request **body**, so the list is not bounded by
+    # URL length. The result is **unordered** and **may be shorter than the
+    # input** — unresolvable ids are dropped silently, and tombstoned
+    # resources come back flagged (`"tombstoned" => true`) rather than
+    # omitted. Index the result by `"noid"`; do not assume positional
+    # correspondence with `ids`.
+    #
+    # @param ids [Array<String>] resource NOIDs to resolve. (Raw Valkyrie ids
+    #   are not a supported input — the endpoint resolves alternate ids only.)
+    # @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 [Array<AtlasRb::Mash>] one digest Mash per resolved resource
+    #   (dot- or string-keyed access); empty when nothing resolved.
+    #
+    # @example Resolve a set of collection titles in one call
+    #   nodes  = AtlasRb::Resource.find_many(["col-456", "col-457", "missing"])
+    #   by_noid = nodes.index_by { |n| n["noid"] }
+    #   by_noid["col-456"].title   # => "Some Collection"
+    def self.find_many(ids, nuid: nil, on_behalf_of: nil)
+      JSON.parse(
+        connection({}, nuid, on_behalf_of: on_behalf_of)
+          .post('/resources/find_many', JSON.dump(ids: Array(ids)))&.body
+      ).map { |node| AtlasRb::Mash.new(node) }
+    end
+
     # Validate a MODS XML document against Atlas's schema *without* persisting it.
     #
     # Useful for surfacing validation errors in UIs before the user commits.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.3.0
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-03 00:00:00.000000000 Z
+date: 2026-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday