atlas_rb 1.8.0 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3d2bc949790f66ee7081de2e94d427f69869fcb301c45d4b9399c072f466820
-  data.tar.gz: 466abe63f27507e1845bc1126b739d2bfa396f7c79c447b1bf57e5be42352f4c
+  metadata.gz: de8129aceabcd06af713b7bddf2e4be8ff259bc3f8095af41d9e63cc2f03c17b
+  data.tar.gz: 9a45c13597c30c4b0c09c9dfb0bf199edb7d919d050f10faaadc32cc2024af3b
 SHA512:
-  metadata.gz: 87494a7060c9b9f192edb404ecffd98ea5b8f4859f4b507e25e7a8d66717d34af7c240f3d99df13163f5e822163d5d3f146df4e9898937a5cb0687b80d12cae1
-  data.tar.gz: 04b3221d9ae88ff6bd1b4586321dbd4eda20a4f6753cedfbf465ad4ad2d27214f5252a6e7dd4259e10a24b813eda4a966a7a39fd243244ad295b9c9a749cd5a6
+  metadata.gz: ee4d49599431a9052c3f3bc55d2d336bb967fedc61edb2815dda42cee74d2250b6700a51ea88c5b74a959fe2f562923e4486831bba66ceb7d5b0236fa74b054c
+  data.tar.gz: 75e2208c86cc1d3e6e13a1bcde956d2d821a7e6e5a141004b2bc2743b550778bd621bcc70aed2528122fabcb931f60a2bc356ed99226a9ece39b125b4d3a3f09

data/.version

@@ -1 +1 @@
-1.8.0
+1.8.1

data/Gemfile.lock

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

data/lib/atlas_rb/blob.rb

@@ -39,6 +39,49 @@ module AtlasRb
       ))['blob']
     end
 
+    # Resolve a content Blob to its parent FileSet and containing Work noids.
+    #
+    # Wraps `GET /files/<id>/ancestry`. The download path is keyed only by the
+    # blob id, so a consumer recording a download/stream impression against the
+    # containing Work resolves it here — instead of threading the work noid
+    # through the download URL. Reads on the Blob floor (no admin gate). An
+    # unknown id yields a `404` (raw Faraday response); either value is `nil`
+    # when unresolvable (e.g. an orphan blob with no FileSet parent).
+    #
+    # @param id [String] the Blob ID.
+    # @param nuid [String, nil] optional acting user's NUID. On the relay-signing
+    #   path it is signed into the assertion `sub`; on the BYO-JWT (`ATLAS_JWT`)
+    #   path it is ignored (identity lives in the token).
+    # @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] `{ "file_set" => "<noid>", "work" => "<noid>" }`
+    #   (either value `nil` when unresolvable).
+    #
+    # @example
+    #   AtlasRb::Blob.ancestry("b-321")
+    #   # => { "file_set" => "fs-654", "work" => "w-789" }
+    def self.ancestry(id, nuid: nil, on_behalf_of: nil)
+      AtlasRb::Mash.new(JSON.parse(
+        connection({}, nuid, on_behalf_of: on_behalf_of).get("#{ROUTE}#{id}/ancestry")&.body
+      ))
+    end
+
+    # Convenience over {.ancestry}: the containing Work's noid for a content
+    # Blob (or `nil` when unresolvable). The shape Cerberus's impression-capture
+    # job wants — roll a download up to its Work from the blob id alone.
+    #
+    # @param id [String] the Blob ID.
+    # @param nuid [String, nil] optional acting user's NUID (see {.ancestry}).
+    # @param on_behalf_of [String, nil] optional `On-Behalf-Of` NUID (see {.ancestry}).
+    # @return [String, nil] the containing Work's noid, or `nil` when unresolvable.
+    #
+    # @example
+    #   AtlasRb::Blob.work("b-321") # => "w-789"
+    def self.work(id, nuid: nil, on_behalf_of: nil)
+      ancestry(id, nuid: nuid, on_behalf_of: on_behalf_of)['work']
+    end
+
     # Stream the Blob's binary content through a caller-supplied block.
     #
     # The body is **not** buffered — each chunk Faraday receives is yielded

metadata

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