Add user_anonymized webhook event (#36208)

Jailyard90Grad · web-flow · commit 15e8a8042fe5 · 2025-11-25T07:43:16.000-08:00
This change adds webhook support for the user anonymization event,
allowing external systems to be notified when a user is anonymized in
Discourse.

Changes:
- Add user_anonymized event type (ID: 310) to WebHookEventType
- Wires up DiscourseEvent listener to trigger webhooks on anonymization
- Add translation string for the event in admin UI
- Add database fixture to seed the event type
- Add comprehensive test coverage

The webhook is triggered when UserAnonymizer.make_anonymous is called
and sends the anonymized user data using WebHookUserSerializer.

Nudged along the path by Claude Code
diff --git a/app/models/web_hook_event_type.rb b/app/models/web_hook_event_type.rb
@@ -59,6 +59,7 @@ class WebHookEventType < ActiveRecord::Base
     user_destroyed: 307,
     user_suspended: 308,
     user_unsuspended: 309,
+    user_anonymized: 310,
     group_created: 401,
     group_updated: 402,
     group_destroyed: 403,
diff --git a/config/initializers/012-web_hook_events.rb b/config/initializers/012-web_hook_events.rb
@@ -47,6 +47,10 @@
   DiscourseEvent.on(event) { |args| WebHook.enqueue_object_hooks(:user, args[:user], event) }
 end
 
+DiscourseEvent.on(:user_anonymized) do |args|
+  WebHook.enqueue_object_hooks(:user, args[:user], :user_anonymized)
+end
+
 %i[group_created group_updated].each do |event|
   DiscourseEvent.on(event) { |group| WebHook.enqueue_object_hooks(:group, group, event) }
 end
diff --git a/config/locales/client.en.yml b/config/locales/client.en.yml
@@ -6623,6 +6623,7 @@ en:
           user_destroyed: "User is deleted"
           user_suspended: "User is suspended"
           user_unsuspended: "User is unsuspended"
+          user_anonymized: "User is anonymized"
         reviewable_event:
           group_name: "Reviewable Events"
           reviewable_created: "Reviewable item is ready"
diff --git a/db/fixtures/007_web_hook_event_types.rb b/db/fixtures/007_web_hook_event_types.rb
@@ -90,6 +90,11 @@
   b.name = "user_unsuspended"
   b.group = WebHookEventType.groups[:user]
 end
+WebHookEventType.seed do |b|
+  b.id = WebHookEventType::TYPES[:user_anonymized]
+  b.name = "user_anonymized"
+  b.group = WebHookEventType.groups[:user]
+end
 WebHookEventType.seed do |b|
   b.id = WebHookEventType::TYPES[:group_created]
   b.name = "group_created"
diff --git a/spec/initializers/web_hook_events_spec.rb b/spec/initializers/web_hook_events_spec.rb
@@ -29,6 +29,28 @@
     end
   end
 
+  describe "user events" do
+    fab!(:user_webhook) do
+      wh = Fabricate(:web_hook)
+      wh.web_hook_event_types = [WebHookEventType.find_by(name: "user_anonymized")]
+      wh.save!
+      wh
+    end
+
+    it "enqueues user_anonymized webhook event" do
+      target_user = Fabricate(:user)
+
+      expect { UserAnonymizer.make_anonymous(target_user, user) }.to change {
+        Jobs::EmitWebHookEvent.jobs.size
+      }.by(1)
+
+      job_args = Jobs::EmitWebHookEvent.jobs.last["args"].first
+      expect(job_args["id"]).to eq(target_user.id)
+      expect(job_args["event_name"]).to eq("user_anonymized")
+      expect(job_args["event_type"]).to eq("user")
+    end
+  end
+
   describe "reviewable events" do
     fab!(:reviewable_webhook) do
       wh = Fabricate(:web_hook, categories: [post.topic.category])
diff --git a/spec/models/web_hook_event_type_spec.rb b/spec/models/web_hook_event_type_spec.rb
@@ -24,6 +24,7 @@
           user_destroyed
           user_suspended
           user_unsuspended
+          user_anonymized
           group_created
           group_updated
           group_destroyed
