atlas_rb 1.23.0 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8df0d572649e0456aa2a8e77b436114aa3a91a2fbfe0e6c05ce2a8426dd7c6ff
-  data.tar.gz: e368597905337f62111f4e649eb88a75f5e06c85202ff3dcf5cc3e99d283d948
+  metadata.gz: 6c096f45a9cfbbd11efce0d0d79f193341ff5d77081f920580ca20e1621423f1
+  data.tar.gz: 885250be775307675bb65533467f33edd8630e70a4dc8c249b1bd06d7ba26e2f
 SHA512:
-  metadata.gz: 005ae8ac014dab468bbfb9c5da901c926ba2c746d78c3bedadda431e310d3d21b99f547b91f8e33563784ba45a782cefa4155c7fcfc35a09c11c8e9f43d9fe5b
-  data.tar.gz: 2d35888d562851ec0ad7cd9419faceee619568723f98c1a34e172ac01f33c56e2ae8491eedae2d851067969acfdd02bf6439364d3b2517448cfadb0a13436fa9
+  metadata.gz: 2d20b72fafff966ece826ff60782ebb33dad8826390ce682e663409affa982350fbfad3a1e1206c850a96f850b619a7964116c4bc8ef2377d2b4fc471726eb07
+  data.tar.gz: e8e92d11281fadf833efb1eaff9b3d41e65662202981bc4837c68adf00761c789d9aa42d82a8081caa3f010bbc455a57a4cf051458c5ebea0fa382f80f5b51bb

data/.version

@@ -1 +1 @@
-1.23.0
+1.24.0

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.24.0
+
+These bindings need Atlas 0.6.213 or later.
+
+### Added — `reason:` on `Resource.tombstone`
+
+```ruby
+AtlasRb::Resource.tombstone(work_id, reason: "Removed from view by legal order", nuid: admin_nuid)
+```
+
+The library's withdrawal policy requires a note saying why an object was
+removed, and fixes its wording. `reason:` must be one of the policy's five
+notes, word for word. Atlas answers `422` with `invalid_reason` for any other
+value, and the call returns that raw response as before. The note carries no
+date: read `tombstoned_at` for that.
+
+Community, Collection, Work and FileSet reads return the note as
+`tombstone_reason`, including the `410` body of a tombstoned read. A restore
+clears it. Omit the keyword to tombstone with no note, as before.
+
 ## 1.23.0
 
 These bindings need Atlas 0.6.212 or later.

data/Gemfile.lock

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

data/README.md

@@ -543,7 +543,7 @@ write. The whole surface:
 | `Resource.set_permissions(id, acl)` | `PATCH /resources/{id}/permissions` |
 | `Resource.set_thumbnails(id, thumbnail:, thumbnail_2x:, preview:)` | `PATCH /resources/{id}/thumbnails` |
 | `Resource.reparent(id, parent_id)` | `PATCH /resources/{id}/parent` |
-| `Resource.tombstone(id)` | `POST /resources/{id}/tombstone` |
+| `Resource.tombstone(id, reason:)` | `POST /resources/{id}/tombstone` |
 | `Admin::Resource.restore(id)` | `POST /resources/{id}/restore` |
 | `Admin::Resource.destroy(id, confirm: :i_understand)` | `DELETE /resources/{id}` |
 

data/lib/atlas_rb/resource_writes.rb

@@ -144,14 +144,23 @@ module AtlasRb
     # {Work.file_sets}. Atlas refuses a FileSet from anyone outside the admin and
     # devolved-admin tiers with `403`, even a user who can edit the Work.
     #
+    # `reason:` records why the resource was removed (Atlas 0.6.213 or later).
+    # It must be one of the removal notes the library's withdrawal policy
+    # allows, word for word; Atlas answers `422` with `invalid_reason` for any
+    # other value. The note carries no date: read `tombstoned_at` for that.
+    # The resource returns it as `tombstone_reason`, and a restore clears it.
+    #
     # @param id [String] the resource's NOID.
+    # @param reason [String, nil] one of the policy's removal notes, or `nil`
+    #   for none.
     # @param nuid [String, nil] the acting user's NUID, stamped on the resource
     #   as `tombstoned_by`.
     # @param on_behalf_of [String, nil] optional NUID for the `On-Behalf-Of`
     #   header.
     # @return [Faraday::Response] the raw response — read `status` yourself.
-    def self.tombstone(id, nuid: nil, on_behalf_of: nil)
-      connection({}, nuid, on_behalf_of: on_behalf_of).post('/resources/' + id + '/tombstone')
+    def self.tombstone(id, reason: nil, nuid: nil, on_behalf_of: nil)
+      connection({}, nuid, on_behalf_of: on_behalf_of)
+        .post('/resources/' + id + '/tombstone', { reason: reason }.compact.to_json)
     end
 
     # Atlas answers a write with the resource under its type key, matching what

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.23.0
+  version: 1.24.0
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-30 00:00:00.000000000 Z
+date: 2026-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday