Add Rails 8 patches: routing_ext for 8.1+, whitelist→allowlist rename

- Add Rails 8.1+ routing support in routing_ext.rb where @scope no longer
  supports []= and Resource.new/SingletonResource.new signatures changed
- Rename exception_class_whitelist → exception_class_allowlist and
  whitelist_all_exceptions → allow_all_exceptions per upstream convention
- Add deprecated wrapper methods for old names with deprecation warnings
- Update callers in acts_as_resource_controller.rb and operation_dispatcher.rb

Cherry-picked from cerebris/jsonapi-resources#1480

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: lukemelia

lib/jsonapi/acts_as_resource_controller.rb

@@ -264,7 +264,7 @@ def handle_exceptions(e)
       when JSONAPI::Exceptions::Error
         render_errors(e.errors)
       else
-        if JSONAPI.configuration.exception_class_whitelisted?(e)
+        if JSONAPI.configuration.exception_class_allowed?(e)
           fail e
         else
           (self.class.server_error_callbacks || []).each { |callback|

lib/jsonapi/configuration.rb

@@ -24,8 +24,8 @@ class Configuration
                 :top_level_meta_page_count_key,
                 :allow_transactions,
                 :include_backtraces_in_errors,
-                :exception_class_whitelist,
-                :whitelist_all_exceptions,
+                :exception_class_allowlist,
+                :allow_all_exceptions,
                 :always_include_to_one_linkage_data,
                 :always_include_to_many_linkage_data,
                 :cache_formatters,
@@ -83,12 +83,12 @@ def initialize
       # raise a Pundit::NotAuthorizedError at some point during operations
       # processing. If you want to use Rails' `rescue_from` macro to
       # catch this error and render a 403 status code, you should add
-      # the `Pundit::NotAuthorizedError` to the `exception_class_whitelist`.
-      self.exception_class_whitelist = []
+      # the `Pundit::NotAuthorizedError` to the `exception_class_allowlist`.
+      self.exception_class_allowlist = []
 
-      # If enabled, will override configuration option `exception_class_whitelist`
-      # and whitelist all exceptions.
-      self.whitelist_all_exceptions = false
+      # If enabled, will override configuration option `exception_class_allowlist`
+      # and allow all exceptions.
+      self.allow_all_exceptions = false
 
       # Resource Linkage
       # Controls the serialization of resource linkage for non compound documents
@@ -202,9 +202,9 @@ def route_formatter
       return formatter
     end
 
-    def exception_class_whitelisted?(e)
-      @whitelist_all_exceptions ||
-        @exception_class_whitelist.flatten.any? { |k| e.class.ancestors.map(&:to_s).include?(k.to_s) }
+    def exception_class_allowed?(e)
+      @allow_all_exceptions ||
+        @exception_class_allowlist.flatten.any? { |k| e.class.ancestors.map(&:to_s).include?(k.to_s) }
     end
 
     def default_processor_klass=(default_processor_klass)
@@ -235,9 +235,27 @@ def default_processor_klass=(default_processor_klass)
 
     attr_writer :include_backtraces_in_errors
 
-    attr_writer :exception_class_whitelist
+    attr_writer :exception_class_allowlist
+
+    attr_writer :allow_all_exceptions
+
+    # Deprecated: use exception_class_allowlist= instead
+    def exception_class_whitelist=(val)
+      JSONAPI.warn_deprecated('`exception_class_whitelist` has been replaced by `exception_class_allowlist`')
+      self.exception_class_allowlist = val
+    end
+
+    # Deprecated: use allow_all_exceptions= instead
+    def whitelist_all_exceptions=(val)
+      JSONAPI.warn_deprecated('`whitelist_all_exceptions` has been replaced by `allow_all_exceptions`')
+      self.allow_all_exceptions = val
+    end
 
-    attr_writer :whitelist_all_exceptions
+    # Deprecated: use exception_class_allowed? instead
+    def exception_class_whitelisted?(e)
+      JSONAPI.warn_deprecated('`exception_class_whitelisted?` has been replaced by `exception_class_allowed?`')
+      exception_class_allowed?(e)
+    end
 
     attr_writer :always_include_to_one_linkage_data
 

lib/jsonapi/operation_dispatcher.rb

@@ -62,7 +62,7 @@ def process_operation(operation)
     def with_default_handling(&block)
       block.yield
     rescue => e
-      if JSONAPI.configuration.exception_class_whitelisted?(e)
+      if JSONAPI.configuration.exception_class_allowed?(e)
         raise e
       else
         @server_error_callbacks.each { |callback|

lib/jsonapi/routing_ext.rb

@@ -46,18 +46,30 @@ def jsonapi_resource(*resources, &_block)
 
           resource @resource_type, options do
             # :nocov:
-            if @scope.respond_to? :[]=
+            if @scope.respond_to?(:[]=)
               # Rails 4
               @scope[:jsonapi_resource] = @resource_type
 
+              if block_given?
+                yield
+              else
+                jsonapi_relationships
+              end
+            elsif Rails::VERSION::MAJOR >= 8 && Rails::VERSION::MINOR >= 1
+              # Rails 8.1+
+              # Rails 8.1 changed Scope to not support []= and Resource.new signature
+              # Use instance variable to track resource type
+              @jsonapi_resource_type = @resource_type
               if block_given?
                 yield
               else
                 jsonapi_relationships
               end
             else
-              # Rails 5
-              jsonapi_resource_scope(SingletonResource.new(@resource_type, api_only?, @scope[:shallow], options), @resource_type) do
+              # Rails 5-8.0
+              resource_arg = SingletonResource.new(@resource_type, api_only?, @scope[:shallow], options)
+
+              jsonapi_resource_scope(resource_arg, @resource_type) do
                 if block_given?
                   yield
                 else
@@ -121,17 +133,29 @@ def jsonapi_resources(*resources, &_block)
 
           resources @resource_type, options do
             # :nocov:
-            if @scope.respond_to? :[]=
+            if @scope.respond_to?(:[]=)
               # Rails 4
               @scope[:jsonapi_resource] = @resource_type
               if block_given?
                 yield
               else
                 jsonapi_relationships
               end
+            elsif Rails::VERSION::MAJOR >= 8 && Rails::VERSION::MINOR >= 1
+              # Rails 8.1+
+              # Rails 8.1 changed Scope to not support []= and Resource.new signature
+              # Use instance variable to track resource type
+              @jsonapi_resource_type = @resource_type
+              if block_given?
+                yield
+              else
+                jsonapi_relationships
+              end
             else
-              # Rails 5
-              jsonapi_resource_scope(Resource.new(@resource_type, api_only?, @scope[:shallow], options), @resource_type) do
+              # Rails 5-8.0
+              resource_arg = Resource.new(@resource_type, api_only?, @scope[:shallow], options)
+
+              jsonapi_resource_scope(resource_arg, @resource_type) do
                 if block_given?
                   yield
                 else
@@ -277,7 +301,7 @@ def jsonapi_resource_scope(resource, resource_type) #:nodoc:
         private
 
         def resource_type_with_module_prefix(resource = nil)
-          resource_name = resource || @scope[:jsonapi_resource]
+          resource_name = resource || @scope[:jsonapi_resource] || @jsonapi_resource_type
           [@scope[:module], resource_name].compact.collect(&:to_s).join('/')
         end
       end