Add _patches, rename _undocumented, unsort args.

.rubocop_todo.yml

@@ -1,15 +1,15 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-09-06 23:33:08 UTC using RuboCop version 1.80.2.
+# on 2025-09-21 13:03:00 UTC using RuboCop version 1.80.2.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 3
+# Offense count: 4
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 50
+  Max: 49
 
 # Offense count: 1
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
@@ -20,7 +20,7 @@ Metrics/BlockLength:
 # Offense count: 1
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 127
+  Max: 132
 
 # Offense count: 2
 # Configuration parameters: AllowedMethods, AllowedPatterns.

README.md

@@ -14,8 +14,8 @@ This is a maintained, machine-readable version of the Slack API Docs, generated
 
 [Known undocumented methods and groups](https://github.com/ErikKalkoken/slackApiDoc) have been added manually.
 
-* [methods](methods/undocumented): Undocumented methods.
-* [groups](groups/undocumented): Undocumented groups.
+* [methods](methods/_undocumented): Undocumented methods.
+* [groups](groups/_undocumented): Undocumented groups.
 
 ### It needs an update!
 

methods/_patches/admin/admin.users.session.invalidate.json

@@ -0,0 +1,11 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "user_id"
+      ],
+      "desc": "Exactly one of these arguments is required to identify the session that is to be invalidated, user_id is preferred and team_id will be deprecated and eventually removed on January 15, 2025.",
+      "mutually_exclusive": true
+    }
+  ]
+}

methods/_patches/chat/chat.postEphemeral.json

@@ -0,0 +1,13 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "attachments",
+        "blocks",
+        "text"
+      ],
+      "desc": "One of these arguments in addition to text is required to describe the content of the message. When attachments or blocks are included, text will be used as fallback text for notifications only.",
+      "mutually_exclusive": false
+    }
+  ]
+}

methods/_patches/chat/chat.postMessage.json

@@ -0,0 +1,13 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "attachments",
+        "blocks",
+        "text"
+      ],
+      "desc": "One of these arguments in addition to text is required to describe the content of the message. When attachments or blocks are included, text will be used as fallback text for notifications only.",
+      "mutually_exclusive": false
+    }
+  ]
+}

methods/_patches/chat/chat.scheduleMessage.json

@@ -0,0 +1,13 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "attachments",
+        "blocks",
+        "text"
+      ],
+      "desc": "One of these arguments in addition to text is required to describe the content of the message. When attachments or blocks are included, text will be used as fallback text for notifications only.",
+      "mutually_exclusive": false
+    }
+  ]
+}

methods/_patches/chat/chat.update.json

@@ -0,0 +1,13 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "attachments",
+        "blocks",
+        "text"
+      ],
+      "desc": "One of these arguments in addition to text is required to describe the content of the message. When attachments or blocks are included, text will be used as fallback text for notifications only.",
+      "mutually_exclusive": false
+    }
+  ]
+}

methods/_patches/functions/functions.distributions.permissions.set.json

@@ -0,0 +1,11 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "permission_type"
+      ],
+      "desc": ".",
+      "mutually_exclusive": true
+    }
+  ]
+}

methods/_patches/views/views.open.json

@@ -0,0 +1,12 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "trigger_id",
+        "interactivity_pointer"
+      ],
+      "desc": "One of these arguments is required to open a view for a user.",
+      "mutually_exclusive": true
+    }
+  ]
+}

methods/_patches/views/views.push.json

@@ -0,0 +1,12 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "trigger_id",
+        "interactivity_pointer"
+      ],
+      "desc": "One of these arguments is required to push a view.",
+      "mutually_exclusive": true
+    }
+  ]
+}

methods/_patches/views/views.update.json

@@ -0,0 +1,12 @@
+{
+  "arg_groups": [
+    {
+      "args": [
+        "external_id",
+        "view_id"
+      ],
+      "desc": "Exactly one of these arguments is required to identify the view that is to be updated.",
+      "mutually_exclusive": true
+    }
+  ]
+}

tasks/events.rake

@@ -6,7 +6,8 @@ namespace :api do
     task :validate do
       schema = File.read('schemas/events.json')
       validator = SlackApi::SpecValidator.new(schema)
-      Dir.glob('events/**/*.json').each do |file|
+      Dir.glob('events/**/*.json').grep_v(%r{/_patches\b}).each do |file|
+        puts file
         abort "Invalid file format: #{file}" unless validator.valid?(file)
       end
     end

tasks/lib/slack_api/methods_generator.rb

@@ -48,6 +48,12 @@ def process_method(data)
         errors: errors
       }.merge(fields)
 
+      patch_filename = "methods/_patches/#{data['group']}/#{data['name']}.json"
+      if File.exist?(patch_filename)
+        puts "(patch) #{patch_filename}"
+        result.merge!(JSON.load_file(patch_filename))
+      end
+
       filename = "methods/#{data['group']}/#{data['name']}.json"
       FileUtils.mkdir_p("methods/#{data['group']}")
       puts filename
@@ -93,7 +99,7 @@ def parse_args(data)
         end
       end
 
-      [args.sort.to_h, fields]
+      [args.to_h, fields]
     end
 
     def massage_type(name, arg, data = {})

tasks/methods.rake

@@ -6,7 +6,8 @@ namespace :api do
     task :validate do
       schema = File.read('schemas/methods.json')
       validator = SlackApi::SpecValidator.new(schema)
-      Dir.glob('methods/**/*.json').each do |file|
+      Dir.glob('methods/**/*.json').grep_v(%r{/_patches\b}).each do |file|
+        puts file
         abort "Invalid file format: #{file}" unless validator.valid?(file)
       end
     end

tasks/update.rake

@@ -11,7 +11,10 @@ namespace :api do
 
     desc 'Delete all generated files except undocumented ones.'
     task :clean_files, :dirs do |_t, args|
-      files = Dir["./{#{Array(args[:dirs]).join(',')}}/*"].grep_v(%r{/undocumented\b})
+      raise 'Missing :dirs' unless args[:dirs]
+
+      # keep _undocumented and _patches
+      files = Dir["./{#{Array(args[:dirs]).join(',')}}/*"].grep_v(%r{/_\w*\b})
       FileUtils.rm_rf files
     end
   end