Skip missing Discord language roles at server limit

Author: ciembor

lib/polish_open_source_rank/contexts/community/infrastructure/discord/discord_role_map.rb

@@ -27,6 +27,7 @@ def role_ids(keys)
               :channels,
               :category_id,
               :channel_creation_disabled,
+              :role_creation_disabled,
               keyword_init: true
             )
 
@@ -95,7 +96,8 @@ def provisioning_state
                 roles: gateway.guild_roles,
                 channels: channels,
                 category_id: ensure_category_id(channels),
-                channel_creation_disabled: false
+                channel_creation_disabled: false,
+                role_creation_disabled: false
               )
             end
 
@@ -117,7 +119,9 @@ def ensure_language_resources(role_keys, state)
             end
 
             def ensure_language_role_and_channel(role_key, state)
-              role = ensure_dynamic_role(role_key, state.roles)
+              role = ensure_dynamic_role(role_key, state)
+              return unless role
+
               ensure_dynamic_channel(role_key, role.fetch('id'), state)
             end
 
@@ -133,14 +137,22 @@ def ensure_category_id(channels)
               category.fetch('id')
             end
 
-            def ensure_dynamic_role(role_key, roles)
+            def ensure_dynamic_role(role_key, state)
+              return if state.role_creation_disabled
+
+              roles = state.roles
               role_name = role_catalog.role_name(role_key)
               role = roles.find { |candidate| candidate.fetch('name') == role_name }
               return role if role
 
               role = gateway.create_role(name: role_name, color: Domain::DiscordLanguageRoleKey.new(role_key).role_color)
               roles << role
               role
+            rescue DiscordApiGateway::Error => e
+              raise unless server_role_limit?(e)
+
+              state.role_creation_disabled = true
+              nil
             end
 
             def ensure_dynamic_channel(role_key, role_id, state)
@@ -181,6 +193,10 @@ def language_role_keys(languages)
             def category_channel_limit?(error)
               error.message.include?('CHANNEL_PARENT_MAX_CHANNELS')
             end
+
+            def server_role_limit?(error)
+              error.message.include?('"code": 30005') || error.message.include?('Maximum number of server roles')
+            end
           end
         end
       end

spec/polish_open_source_rank/contexts/community/infrastructure/discord/discord_role_map_spec.rb

@@ -149,6 +149,31 @@
       end
     end
 
+    context 'when Discord refuses another dynamic role because the server role limit is reached' do
+      before do
+        allow(gateway).to receive(:create_role)
+          .with(name: 'Ruby', color: nil)
+          .and_raise(
+            PolishOpenSourceRank::Contexts::Community::Infrastructure::Discord::DiscordApiGateway::Error,
+            '400 {"message":"Maximum number of server roles reached (250)","code":30005}'
+          )
+      end
+
+      it 'keeps static roles available and omits missing dynamic roles' do
+        ENV['DISCORD_ROLE_TOP_100_PL'] = 'country-role'
+
+        prepared = map.prepare(
+          period_start: '2026-04-01',
+          role_keys: ['DISCORD_ROLE_TOP_100_PL', 'DISCORD_ROLE_LANGUAGE:ruby:Ruby']
+        )
+
+        expect(prepared.managed_role_ids).to include('country-role')
+        expect(prepared.role_ids_by_key).to be_empty
+        expect(gateway_data.fetch(:created_roles)).to be_empty
+        expect(gateway_data.fetch(:created_channels).map { |channel| channel.fetch('name') }).to eq(['Languages'])
+      end
+    end
+
     def discord_gateway_contract
       Object.new.tap do |gateway|
         def gateway.guild_roles; end