atlas_rb 0.0.100 → 0.0.101

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6446cf5f1b041885d75f8d42740e5e865b0bb6db3569ed1926c93c78893862a
-  data.tar.gz: dc02805c46b618cc9b2ed2c28e4679eb537ff3467e0b0a974977c1799e2c7056
+  metadata.gz: 94b1cf416b2dbd60cd0e87960302dc5bb4be7207576608ecbe521cdb28d20255
+  data.tar.gz: d3d716929b9d246d761385142858e95e628f4e50510a3c583dd90ae8e70613c4
 SHA512:
-  metadata.gz: df30f4678e31a4de0ca0ef7d2ea4967fe4b4c56d77aec8f133bba36399ce4838ca0b86ff715b4fa7d3e7c40fb9682feed00ff6f2e6c39aebd907605e5d1150d4
-  data.tar.gz: dff59d92028e8f5b15ef7b270ffd6b53771dcd20c64406706e0e4367c520bff1f7854e087b7da152247bec514aa542ba438c1848149cfd257d2085a9d637d769
+  metadata.gz: 1c232e3e98c972d7c551106e5befb4b52f0b5befcba7ae15eeaf32ac1f2471062a90f4034a04e63caa3991625b6a5f4ca95de15cc395b0abaca8e62ad92ee5d3
+  data.tar.gz: 660c2326caa5f323fb83236144f6f41318e3b375d8e1d7a39ab48742c2acc86567686fef8cd2bf01136e91a8a300a53762c1ad9f2d3f449195a592a6dfa43178

data/.version

@@ -1 +1 @@
-0.0.100
+0.0.101

data/Gemfile.lock

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

data/lib/atlas_rb/collection.rb

@@ -58,12 +58,15 @@ module AtlasRb
     # Delete a Collection.
     #
     # @param id [String] the Collection ID.
+    # @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.
     # @return [Faraday::Response] the raw delete response.
     #
     # @example
     #   AtlasRb::Collection.destroy("col-456")
-    def self.destroy(id)
-      connection({}).delete(ROUTE + id)
+    def self.destroy(id, nuid: nil)
+      connection({}, nuid).delete(ROUTE + id)
     end
 
     # Tombstone (withdraw) a Collection.
@@ -107,13 +110,16 @@ module AtlasRb
     # {Resource.find} (or {Work.find}) when a full payload is needed.
     #
     # @param id [String] the Collection ID.
+    # @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.
     # @return [Array<String>] child noids from `GET /collections/<id>/children`.
     #
     # @example
     #   AtlasRb::Collection.children("col-456")
     #   # => ["w-789", "w-790"]
-    def self.children(id)
-      JSON.parse(connection({}).get(ROUTE + id + '/children')&.body)
+    def self.children(id, nuid: nil)
+      JSON.parse(connection({}, nuid).get(ROUTE + id + '/children')&.body)
     end
 
     # Replace a Collection's metadata by uploading a MODS XML document.

data/lib/atlas_rb/community.rb

@@ -62,12 +62,15 @@ module AtlasRb
     # Delete a Community.
     #
     # @param id [String] the Community ID.
+    # @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.
     # @return [Faraday::Response] the raw delete response.
     #
     # @example
     #   AtlasRb::Community.destroy("c-123")
-    def self.destroy(id)
-      connection({}).delete(ROUTE + id)
+    def self.destroy(id, nuid: nil)
+      connection({}, nuid).delete(ROUTE + id)
     end
 
     # Tombstone (withdraw) a Community.
@@ -112,13 +115,16 @@ module AtlasRb
     # needed.
     #
     # @param id [String] the parent Community ID.
+    # @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.
     # @return [Array<String>] child noids from `GET /communities/<id>/children`.
     #
     # @example
     #   AtlasRb::Community.children("c-123")
     #   # => ["fn106x926", "kw52j804p"]
-    def self.children(id)
-      JSON.parse(connection({}).get(ROUTE + id + '/children')&.body)
+    def self.children(id, nuid: nil)
+      JSON.parse(connection({}, nuid).get(ROUTE + id + '/children')&.body)
     end
 
     # Replace a Community's metadata by uploading a MODS XML document.

data/lib/atlas_rb/delegate.rb

@@ -23,14 +23,17 @@ module AtlasRb
     # Fetch a single Delegate by NOID or `valkyrie_id`.
     #
     # @param id [String] the Delegate's NOID or `valkyrie_id`.
+    # @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.
     # @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"]
+    def self.find(id, nuid: nil)
+      AtlasRb::Mash.new(JSON.parse(connection({}, nuid).get(ROUTE + id)&.body))["delegate"]
     end
   end
 end

data/lib/atlas_rb/file_set.rb

@@ -17,12 +17,15 @@ module AtlasRb
     # Fetch a single FileSet by ID.
     #
     # @param id [String] the FileSet ID.
+    # @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.
     # @return [Hash] the `"file_set"` object, already unwrapped.
     #
     # @example
     #   AtlasRb::FileSet.find("fs-001")
-    def self.find(id)
-      AtlasRb::Mash.new(JSON.parse(connection({}).get(ROUTE + id)&.body))["file_set"]
+    def self.find(id, nuid: nil)
+      AtlasRb::Mash.new(JSON.parse(connection({}, nuid).get(ROUTE + id)&.body))["file_set"]
     end
 
     # Create a new FileSet under a Work.
@@ -34,6 +37,9 @@ module AtlasRb
     # @param idempotency_key [String, nil] optional UUID. A repeat call with
     #   the same key returns the originally-created FileSet instead of
     #   creating a new one. See {AtlasRb::Work.create} for full semantics.
+    # @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.
     # @return [Hash] the created `"file_set"` payload, including its `"id"`
     #   which can then be passed to {.update} to attach a binary.
     #
@@ -44,9 +50,9 @@ module AtlasRb
     # @example Retry-safe bulk-deposit create
     #   key = SecureRandom.uuid
     #   AtlasRb::FileSet.create("w-789", "primary", idempotency_key: key)
-    def self.create(id, classification, idempotency_key: nil)
+    def self.create(id, classification, idempotency_key: nil, nuid: nil)
       AtlasRb::Mash.new(JSON.parse(
-        connection({ work_id: id, classification: classification }, nil,
+        connection({ work_id: id, classification: classification }, nuid,
                    idempotency_key: idempotency_key).post(ROUTE)&.body
       ))["file_set"]
     end
@@ -54,12 +60,15 @@ module AtlasRb
     # Delete a FileSet.
     #
     # @param id [String] the FileSet ID.
+    # @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.
     # @return [Faraday::Response] the raw delete response.
     #
     # @example
     #   AtlasRb::FileSet.destroy("fs-001")
-    def self.destroy(id)
-      connection({}).delete(ROUTE + id)
+    def self.destroy(id, nuid: nil)
+      connection({}, nuid).delete(ROUTE + id)
     end
 
     # Attach (or replace) the binary content backing this FileSet.
@@ -71,16 +80,19 @@ module AtlasRb
     #
     # @param id [String] the FileSet ID.
     # @param blob_path [String] path to the binary file on disk.
+    # @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.
     # @return [Hash] the parsed JSON response from the patch.
     #
     # @example
     #   AtlasRb::FileSet.update("fs-001", "/tmp/article.pdf")
-    def self.update(id, blob_path)
+    def self.update(id, blob_path, nuid: nil)
       # Need to figure out blob vs XML
       payload = { binary: Faraday::Multipart::FilePart.new(File.open(blob_path),
                                                           "application/octet-stream",
                                                           File.basename(blob_path)) }
-      AtlasRb::Mash.new(JSON.parse(multipart({}).patch(ROUTE + id, payload)&.body))
+      AtlasRb::Mash.new(JSON.parse(multipart(nuid).patch(ROUTE + id, payload)&.body))
     end
   end
 end

data/lib/atlas_rb/work.rb

@@ -39,6 +39,9 @@ module AtlasRb
     #   `in_progress` flag matches. Omit (or pass `nil`) for "all works".
     # @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
+    #   `User:` header. Required for cerberus-token requests; legacy bearer
+    #   tokens still resolve without it.
     # @return [AtlasRb::Mash] `{ "works" => [...], "pagination" => {...} }`.
     #   Each entry in `"works"` is a Work summary (`id`, `title`,
     #   `description`, `in_progress`).
@@ -48,12 +51,12 @@ module AtlasRb
     #
     # @example Page through all works
     #   AtlasRb::Work.list(page: 2, per_page: 50)
-    def self.list(in_progress: nil, page: nil, per_page: nil)
+    def self.list(in_progress: nil, page: nil, per_page: nil, nuid: nil)
       params = {}
       params[:in_progress] = in_progress unless in_progress.nil?
       params[:page]        = page        if page
       params[:per_page]    = per_page    if per_page
-      AtlasRb::Mash.new(JSON.parse(connection(params).get(ROUTE)&.body))
+      AtlasRb::Mash.new(JSON.parse(connection(params, nuid).get(ROUTE)&.body))
     end
 
     # Create a new Work in an existing Collection.
@@ -102,12 +105,15 @@ module AtlasRb
     # Delete a Work.
     #
     # @param id [String] the Work ID.
+    # @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.
     # @return [Faraday::Response] the raw delete response.
     #
     # @example
     #   AtlasRb::Work.destroy("w-789")
-    def self.destroy(id)
-      connection({}).delete(ROUTE + id)
+    def self.destroy(id, nuid: nil)
+      connection({}, nuid).delete(ROUTE + id)
     end
 
     # Tombstone (withdraw) a Work.

metadata

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