atlas_rb 0.0.92 → 0.0.94

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ecdf5a4da61e030d7220fc9094a43bd91a850eaa1c599179d75c3d5381b300a
-  data.tar.gz: eea705d4f0601b112b2182848241c5439ef4beb10b87e87939e73ea70eb30907
+  metadata.gz: ed41f31beac084721efa710b8ed828897ee1634ce3dd399171180e7ed9cb7111
+  data.tar.gz: 66066b767f77db9265294fdf019c2e35dd6b795de3f9c0b5509affeb9f11e39f
 SHA512:
-  metadata.gz: 4aa3b1a2367bde1309f589eebf0bf9bf8ff9f744dc1cdf5648c820cd4d38b4e2afa496a9b50308947f00cb9ceab4d10df4e92018d7715ad7928aa415fb556e0c
-  data.tar.gz: b006492ee9c5adde683c863d06cf7cbd233848709e6aa6176e0e6b2fbd663f81f70166b0e7da4889a9005e47c7ecd3cc39e7aa58bde32461b15b4448b18d786d
+  metadata.gz: 9bffda9eb2af9d591e28c245ee041375d4e0dc0d884c26a86caf6fc1433c4dad1534a5e804f18a7b4b9a69cb03f1d679d96df7358d66c59357ad3830d5c5c04e
+  data.tar.gz: 53fd40e34d0ea636d3b987f9739f364bb9528453f3514b2bb107dcc8db29ddaa28fbbe2380c330a77478c2c574ecb39e76ca6259998217fe896fe11f32255df8

data/.version

@@ -1 +1 @@
-0.0.92
+0.0.94

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (0.0.92)
+    atlas_rb (0.0.94)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)
@@ -11,7 +11,7 @@ GEM
   remote: https://rubygems.org/
   specs:
     diff-lcs (1.6.1)
-    faraday (2.14.1)
+    faraday (2.14.2)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger

data/lib/atlas_rb/delegate.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module AtlasRb
+  # A server-managed derivative asset attached to a {Work} — thumbnails,
+  # previews, and other generated representations.
+  #
+  # Unlike a {Blob}, a Delegate is not user-uploaded binary content; it is
+  # produced and addressed by Atlas itself. Each Delegate exposes a `uri`
+  # pointing at the underlying bytes plus enough metadata
+  # (`mime_type`, `original_filename`, `label`, `use`) for clients to
+  # render or link to it without fetching the bytes first.
+  #
+  # Lookups accept either the resource NOID or the `valkyrie_id`: Atlas
+  # redirects NOIDs to `/delegates/:valkyrie_id` and Faraday transparently
+  # follows the redirect.
+  #
+  # See also: {Work}, {Blob}.
+  class Delegate < Resource
+    # Atlas REST endpoint prefix for this resource.
+    # @api private
+    ROUTE = "/delegates/"
+
+    # Fetch a single Delegate by NOID or `valkyrie_id`.
+    #
+    # @param id [String] the Delegate's NOID or `valkyrie_id`.
+    # @return [AtlasRb::Mash] the `"delegate"` object, already unwrapped —
+    #   includes `id`, `valkyrie_id`, `use`, `uri`, `mime_type`,
+    #   `original_filename`, `label`, and tombstone fields.
+    #
+    # @example
+    #   AtlasRb::Delegate.find("d-555")
+    def self.find(id)
+      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id)&.body))["delegate"]
+    end
+  end
+end

data/lib/atlas_rb/work.rb

@@ -189,19 +189,28 @@ module AtlasRb
       AtlasRb::Mash.new(JSON.parse(connection({ metadata: values }).patch(ROUTE + id)&.body))
     end
 
-    # List the {FileSet}s and {Blob}s attached to a Work.
+    # List the assets attached to a Work — {Blob}s and {Delegate}s alike.
     #
     # Useful for building download UIs — the response includes enough to
-    # render each file's display name, size, and download URL.
+    # render each entry's display name, size or `uri`, and download URL.
+    # The shape is polymorphic: Blob-backed entries carry fields like
+    # `size`, while Delegate-backed entries carry `uri`. Callers should
+    # duck-type on the field they need rather than expecting a single
+    # schema.
     #
     # @param id [String] the Work ID.
-    # @return [Array<AtlasRb::Mash>] the listing from `GET /works/<id>/files`,
-    #   one entry per attached file.
+    # @return [Array<AtlasRb::Mash>] the listing from `GET /works/<id>/assets`,
+    #   one entry per attached asset.
     #
     # @example
-    #   AtlasRb::Work.files("w-789").each { |f| puts f.label }
+    #   AtlasRb::Work.assets("w-789").each { |a| puts a.label }
+    def self.assets(id)
+      JSON.parse(connection({}).get(ROUTE + id + '/assets')&.body).map { |entry| AtlasRb::Mash.new(entry) }
+    end
+
+    # @deprecated Use {.assets} instead. Will be removed in the next release.
     def self.files(id)
-      JSON.parse(connection({}).get(ROUTE + id + '/files')&.body).map { |entry| AtlasRb::Mash.new(entry) }
+      assets(id)
     end
 
     # Fetch the Work's MODS representation in the requested format.

data/lib/atlas_rb.rb

@@ -13,6 +13,7 @@ require_relative "atlas_rb/collection"
 require_relative "atlas_rb/work"
 require_relative "atlas_rb/file_set"
 require_relative "atlas_rb/blob"
+require_relative "atlas_rb/delegate"
 require_relative "atlas_rb/user"
 
 # Ruby client for the Atlas API — Northeastern University's institutional

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 0.0.92
+  version: 0.0.94
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-13 00:00:00.000000000 Z
+date: 2026-05-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -118,6 +118,7 @@ files:
 - lib/atlas_rb/blob.rb
 - lib/atlas_rb/collection.rb
 - lib/atlas_rb/community.rb
+- lib/atlas_rb/delegate.rb
 - lib/atlas_rb/faraday_helper.rb
 - lib/atlas_rb/file_set.rb
 - lib/atlas_rb/mash.rb