verikloak-rails 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6126b5013614bb5cb7c0594126c21456db9762a9e3d307108e5f8c1ce197155
-  data.tar.gz: e8504432260a732881946e72cb5551e00178108ba641b802b78c4ca42879e664
+  metadata.gz: d96aa5ed90bc1dbc922ec263fecbccdb8dd122e51accced8776a969211e4f549
+  data.tar.gz: d7cc87f1b7cf857fbc707962860a596f35efa32f167c76e1bf50362090f6d5b6
 SHA512:
-  metadata.gz: ecaf3de303c489d429c6157232f3159333ddec36e87ac0499784181e944c9fe25f59aceb72452b69f297bc7ff0761c069df13cf78ab776c5311a04d6d6c0e9be
-  data.tar.gz: e335daefda43368d7c0b58b87372214a8e999bad0424c7e5e2e4e5d5f1ced49b51190e900865ff34d1a277a72eb6fd172b64fc559f0eb246fac4f1d114902bfc
+  metadata.gz: 518cf212cede738ce3e392a93f413b654ba138d4768afbe20811274129f93139aef1afbe5c24cbf3309cf7d99c978cf9a4ff6d8443b01cc7dae543da97f04c7c
+  data.tar.gz: 412639b3aa790ffae71cf53dc427e213ba5b9ae426270cbc6af3e1e0ce26c028abc98db14b0bce58153601f10a7b86c566b4ffdbfd7dcd954175008a6d146025

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.2.7] - 2025-09-23
+
+### Fixed
+- Handle `RuntimeError` exceptions from `ActionDispatch::MiddlewareStack#insert_after` in Rails 8+
+- Add `inserted` flag to prevent duplicate middleware insertion when fallback is used
+- Enhance error handling to gracefully handle all middleware insertion failures
+
+### Changed
+- Update middleware insertion candidates logic for better Rails version compatibility
+  - Rails 8+ now raises `RuntimeError` instead of the deprecated `ActionDispatch::MiddlewareStack::MiddlewareNotFound`
+  - Broaden exception handling to catch `StandardError` for robustness across Rails versions
+  - Improve logging and debugging information for middleware insertion failures
+
 ## [0.2.6] - 2025-09-23
 
 ### Fixed

data/lib/verikloak/rails/railtie.rb

@@ -136,13 +136,59 @@ module Verikloak
         # @param base_options [Hash] options to pass to the middleware
         # @return [void]
         def insert_middleware_after(stack, base_options)
-          after = Verikloak::Rails.config.middleware_insert_after || ::Rails::Rack::Logger
-          if after
-            stack.insert_after after,
-                               ::Verikloak::Middleware,
-                               **base_options
+          candidates = middleware_insert_after_candidates
+          inserted = false
+
+          candidates.each do |candidate|
+            next unless candidate
+
+            begin
+              stack.insert_after candidate,
+                                 ::Verikloak::Middleware,
+                                 **base_options
+              inserted = true
+              break
+            rescue StandardError => e
+              # Handle middleware insertion failures:
+              # - Rails 8+: RuntimeError for missing middleware
+              # - Earlier versions: ActionDispatch::MiddlewareStack::MiddlewareNotFound
+              log_middleware_insertion_warning(candidate, e)
+            end
+          end
+
+          # Only use as fallback if insertion after a specific middleware failed
+          stack.use ::Verikloak::Middleware, **base_options unless inserted
+        end
+
+        # Build list of middleware to try as insertion points.
+        # Starts with the configured value (if any) and falls back to defaults
+        # that exist across supported Rails versions.
+        #
+        # @return [Array<Object>] ordered list of potential middleware targets
+        def middleware_insert_after_candidates
+          configured = Verikloak::Rails.config.middleware_insert_after
+
+          defaults = []
+          defaults << ::Rails::Rack::Logger if defined?(::Rails::Rack::Logger)
+          defaults << ::ActionDispatch::Executor if defined?(::ActionDispatch::Executor)
+          defaults << ::Rack::Head if defined?(::Rack::Head)
+          defaults << ::Rack::Runtime if defined?(::Rack::Runtime)
+
+          ([configured] + defaults).compact.uniq
+        end
+
+        # Log when a middleware insertion target cannot be found.
+        #
+        # @param candidate [Object] middleware we attempted to insert after
+        # @param error [StandardError] the exception raised during insertion
+        # @return [void]
+        def log_middleware_insertion_warning(candidate, error)
+          candidate_name = candidate.is_a?(Class) ? candidate.name : candidate.class.name
+          message = "[verikloak] Unable to insert after #{candidate_name}: #{error.message}"
+          if defined?(::Rails) && ::Rails.respond_to?(:logger) && ::Rails.logger
+            ::Rails.logger.warn(message)
           else
-            stack.use ::Verikloak::Middleware, **base_options
+            warn(message)
           end
         end
       end

data/lib/verikloak/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Verikloak
   module Rails
-    VERSION = '0.2.6'
+    VERSION = '0.2.7'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: verikloak-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - taiyaky
@@ -94,7 +94,7 @@ metadata:
   source_code_uri: https://github.com/taiyaky/verikloak-rails
   changelog_uri: https://github.com/taiyaky/verikloak-rails/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/taiyaky/verikloak-rails/issues
-  documentation_uri: https://rubydoc.info/gems/verikloak-rails/0.2.6
+  documentation_uri: https://rubydoc.info/gems/verikloak-rails/0.2.7
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: