feat: reactable#remove_reactions

README.md

@@ -63,13 +63,11 @@ post.add_reactions(user, "😀")
 post.add_reactions(user, ["😞", "🙃"])
 ```
 
-### deleting reactions
+### removing reactions
 
 ```ruby
-post.destroy_reaction_from(user) # returns value like #destroy in ActiveRecord
-
-# #update_reaction_from with a nil reaction also delete the reaction
-post.update_reaction_from(user)
+post.remove_reactions(user, "😀")
+post.remove_reactions(user, ["😞", "🙃"])
 ```
 
 ### private opinion from one reactor

lib/acts_as_reactable/reactable.rb

@@ -50,6 +50,22 @@ def acts_as_reactable
 
           self
         end
+
+        define_method :remove_reactions do |reactor, emoji_or_list = nil|
+          return unless emoji_or_list
+
+          emojis = if emoji_or_list.is_a?(Array)
+            emoji_or_list
+          else
+            [emoji_or_list]
+          end
+
+          reactions
+            .where(reactor: reactor, emoji: emojis.compact.uniq)
+            .destroy_all
+
+          self
+        end
       end
     end
   end

spec/lib/acts_as_reactable/reactable/remove_reactions_spec.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+RSpec.describe ActsAsReactable::Reactable do
+  describe "#remove_reactions" do
+    let(:user) { create(:user) }
+    let(:post) { create(:post, user: user) }
+
+    before do
+      post.add_reactions(user, %w[😀 😭 😎])
+    end
+
+    it "removes one reaction" do
+      expect {
+        post.remove_reactions(user, "😭")
+        expect(post.reactions.map(&:emoji)).to eq(%w[😀 😎])
+      }.to change(ActsAsReactable::Reaction, :count).by(-1)
+    end
+
+    it "removes multiple reactions from an array" do
+      expect {
+        post.remove_reactions(user, %w[😭 😎])
+        expect(post.reactions.map(&:emoji)).to eq(%w[😀])
+      }.to change(ActsAsReactable::Reaction, :count).by(-2)
+    end
+
+    it "ignores invalid emoji" do
+      expect {
+        post.remove_reactions(user, %w[😭 A])
+        expect(post.reactions.map(&:emoji)).to eq(%w[😀 😎])
+      }.to change(ActsAsReactable::Reaction, :count).by(-1)
+    end
+
+    it "ignores non-existing reactions" do
+      expect {
+        post.remove_reactions(user, %w[😭 😍])
+        expect(post.reactions.map(&:emoji)).to eq(%w[😀 😎])
+      }.to change(ActsAsReactable::Reaction, :count).by(-1)
+    end
+
+    it "returns the self - reactable item" do
+      expect(post.remove_reactions(user, %w[😀 😭])).to eq(post)
+    end
+  end
+end