atlas_rb 1.20.0 → 1.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ec8ebfc7fd51516a1d73d28bc426153f99a1d7d91c6b1b1bf80ffc965396b8f
-  data.tar.gz: 284df1abb1bef59118f44483e3ba2b3680daacd03717795417395ee095950f55
+  metadata.gz: 0650d39388fca9d7fbdc0134ee4e76e4a82ed3c659f8c44ea96aac62a397d0c1
+  data.tar.gz: ab674da7f6274991b11921b60c43a93ea6e3e9f3a5ef121109fd3bc99c970cdc
 SHA512:
-  metadata.gz: e3fc55be0dde3a6d5ff4603284de7e7b2ed4e29c628afbab32d2026befbfc2cc93d4304e4a294043319c60d79a5f51f2e06cf0957a4ffd9e28af8ffc56f64e36
-  data.tar.gz: a8dced08d932a266c77d70cfaa90cf7d81c957efce818ce42c5a000508b48d6501ca449a1863f3a73017b2131692c6930bdcd53e282823f7957a43e5e30e38a9
+  metadata.gz: 2c23136adc3f95ccf1b9e0e739f95a2a86b3ee33a1cf5a52f72af625fe5c2ab77cf63c9c78990d2b36ff0d285445f56bae620da21d86af0994d590f867defe51
+  data.tar.gz: edac22a77b8d592ae2e3a0d77117b9ac60d7516d3a13469747ff5cb7f90a782e774d5514218bb5d368818defc538d58158ed608abd400d2cca4aaa606bff9939

data/.version

@@ -1 +1 @@
-1.20.0
+1.21.0

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.21.0
+
+### Added — `System::Work.remove_linked_member`, unlinking a showcase Work
+
+```ruby
+AtlasRb::System::Work.remove_linked_member(work_id, old_showcase_id, on_behalf_of: depositor_nuid)
+# => ["def456"]
+```
+
+The mirror of `System::Work.add_linked_member`, over the same system connection.
+It binds `DELETE /works/:id/linked_members/:collection_id`, which Atlas already
+serves. Atlas runs the same two checks as the add: the Collection must be
+featured, and `on_behalf_of` must own the Work. Otherwise it raises
+`ForbiddenError`.
+
+A depositor holds no `:link_member` grant, so `Work.remove_linked_member` works
+only for an admin. This binding lets Cerberus change a depositor's showcase
+category: remove the link to the old showcase, then add the link to the new one.
+
 ## 1.20.0
 
 ### Added — `System.release_embargoes`, recording lapsed embargoes

data/Gemfile.lock

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

data/lib/atlas_rb/system/work.rb

@@ -2,15 +2,15 @@
 
 module AtlasRb
   module System
-    # Showcase publishing: link a freshly-created Work into a depositor's
+    # Showcase publishing: link a depositor's Work into (or out of) a
     # featured showcase Collection on their behalf, without granting the
     # depositor themselves standing edit rights on that shared Collection.
     #
     # Atlas scopes this narrowly on both sides (see Atlas's `Ability`): the
     # target Collection must be `featured`, and the Work must belong to the
     # `on_behalf_of` NUID — never an arbitrary or private Work. Cerberus's
-    # `WorkDeposit#create_published` ("Publish to my community") is the one
-    # caller today.
+    # `WorkDeposit#create_published` ("Publish to my community") adds the link;
+    # changing a Work's showcase category swaps it with a remove and an add.
     #
     # Always authenticates via {FaradayHelper#system_connection}, so there is
     # no way to issue this as a regular user.
@@ -43,6 +43,35 @@ module AtlasRb
             .post("/works/#{work_id}/linked_members")&.body
         )
       end
+
+      # The mirror of {.add_linked_member}: unlink a depositor's Work from a
+      # featured showcase Collection on their behalf. Atlas applies the same
+      # two checks as the add, so a depositor can undo only a link they could
+      # have made.
+      #
+      # @param work_id [String] the Work ID to unlink.
+      # @param collection_id [String] the (must-be-featured) showcase
+      #   Collection to unlink the Work from.
+      # @param on_behalf_of [String] the depositor NUID this write is
+      #   attributed to; Atlas requires it to match the Work's depositor.
+      # @return [Array<String>] the Work's full set of linked Collection
+      #   noids after the remove.
+      # @raise [AtlasRb::StaleResourceError] optimistic-lock conflict.
+      # @raise [AtlasRb::LinkedMemberError] structural rejection (HTTP 422) —
+      #   e.g. the target Collection does not exist.
+      # @raise [AtlasRb::ForbiddenError] Atlas refused the unlink (HTTP 403) —
+      #   e.g. the target Collection isn't featured, or on_behalf_of doesn't
+      #   own the Work.
+      #
+      # @example Swapping a Work's showcase from Cerberus's Work Edit page
+      #   AtlasRb::System::Work.remove_linked_member(work.id, old_showcase.id, on_behalf_of: depositor_nuid)
+      #   AtlasRb::System::Work.add_linked_member(work.id, new_showcase.id, on_behalf_of: depositor_nuid)
+      def self.remove_linked_member(work_id, collection_id, on_behalf_of:)
+        JSON.parse(
+          system_connection({}, on_behalf_of: on_behalf_of)
+            .delete("/works/#{work_id}/linked_members/#{collection_id}")&.body
+        )
+      end
     end
   end
 end

metadata

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