discourse/plugins/chat/spec/services/chat/leave_channel_spec.rb
Loïc Guitaut 41584ab40c DEV: Provide user input to services using params key
Currently in services, we don’t make a distinction between input
parameters, options and dependencies.

This can lead to user input modifying the service behavior, whereas it
was not the developer intention.

This patch addresses the issue by changing how data is provided to
services:
- `params` is now used to hold all data coming from outside (typically
  user input from a controller) and a contract will take its values from
  `params`.
- `options` is a new key to provide options to a service. This typically
  allows changing a service behavior at runtime. It is, of course,
  totally optional.
- `dependencies` is actually anything else provided to the service (like
  `guardian`) and available directly from the context object.

The `service_params` helper in controllers has been updated to reflect
those changes, so most of the existing services didn’t need specific
changes.

The options block has the same DSL as contracts, as it’s also based on
`ActiveModel`. There aren’t any validations, though. Here’s an example:
```ruby
options do
  attribute :allow_changing_hidden, :boolean, default: false
end
```
And here’s an example of how to call a service with the new keys:
```ruby
MyService.call(params: { key1: value1, … }, options: { my_option: true }, guardian:, …)
```
2024-10-25 09:57:59 +02:00

127 lines
3.8 KiB
Ruby

# frozen_string_literal: true
RSpec.describe Chat::LeaveChannel do
describe described_class::Contract, type: :model do
it { is_expected.to validate_presence_of(:channel_id) }
end
describe ".call" do
subject(:result) { described_class.call(params:, **dependencies) }
fab!(:channel_1) { Fabricate(:chat_channel) }
fab!(:current_user) { Fabricate(:user) }
let(:guardian) { Guardian.new(current_user) }
let(:channel_id) { channel_1.id }
let(:params) { { channel_id: } }
let(:dependencies) { { guardian: } }
before { SiteSetting.direct_message_enabled_groups = Group::AUTO_GROUPS[:everyone] }
context "when all steps pass" do
context "when category channel" do
context "with existing membership" do
before do
channel_1.add(current_user)
Chat::Channel.ensure_consistency!
end
it { is_expected.to run_successfully }
it "unfollows the channel" do
membership = channel_1.membership_for(current_user)
expect { result }.to change { membership.reload.following }.from(true).to(false)
end
it "recomputes user count" do
expect { result }.to change { channel_1.reload.user_count }.from(1).to(0)
end
end
context "with no existing membership" do
it { is_expected.to run_successfully }
it "does nothing" do
expect { result }.to_not change { Chat::UserChatChannelMembership }
end
end
end
context "when group channel" do
context "with existing membership" do
fab!(:channel_1) do
Fabricate(:direct_message_channel, group: true, users: [current_user, Fabricate(:user)])
end
before { Chat::Channel.ensure_consistency! }
it { is_expected.to run_successfully }
it "leaves the channel" do
membership = channel_1.membership_for(current_user)
result
expect(Chat::UserChatChannelMembership.exists?(membership.id)).to eq(false)
expect(
channel_1.chatable.direct_message_users.where(user_id: current_user.id).exists?,
).to eq(false)
end
it "recomputes user count" do
expect { result }.to change { channel_1.reload.user_count }.from(2).to(1)
end
end
context "with no existing membership" do
it { is_expected.to run_successfully }
it "does nothing" do
expect { result }.to_not change { Chat::UserChatChannelMembership }
end
end
end
context "when direct channel" do
context "with existing membership" do
fab!(:channel_1) do
Fabricate(:direct_message_channel, users: [current_user, Fabricate(:user)])
end
before { Chat::Channel.ensure_consistency! }
it { is_expected.to run_successfully }
it "unfollows the channel" do
membership = channel_1.membership_for(current_user)
expect { result }.to change { membership.reload.following }.from(true).to(false)
expect(
channel_1.chatable.direct_message_users.where(user_id: current_user.id).exists?,
).to eq(true)
end
it "recomputes user count" do
expect { result }.to_not change { channel_1.reload.user_count }
end
end
context "with no existing membership" do
it { is_expected.to run_successfully }
it "does nothing" do
expect { result }.to_not change { Chat::UserChatChannelMembership }
end
end
end
end
context "when channel is not found" do
before { params[:channel_id] = -999 }
it { is_expected.to fail_to_find_a_model(:channel) }
end
end
end