verikloak-bff 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fbec3da2912582f3684c1682fb75b45f9d26c3a1ebf3b7a41d4a5392fbe36c1
-  data.tar.gz: d1b5b9f750bd3cdbbf3308f1581c8327c039f87b660cde73a799a83740f818ae
+  metadata.gz: 2e2d5b0966fddd564dcd1b6e48fb871f3239542204176f0291f4249f5770b713
+  data.tar.gz: c1f1c43a58c7428263757d2f051c3f988921d84b30fc5fbdc8995f0c5d55ef4c
 SHA512:
-  metadata.gz: 33655caab83ec29f7159264b660aadb878a61c3ca52c4f23e4256cdb30519384833d7ea8244de5c8252368227ef3999691eb1aa282d907c42e94db69fb39ecb3
-  data.tar.gz: d1442646ce08bd0a98ca211f781f0ba623d58d51323ed86492c01cee60086a27c5f27c1fd8d65e4b7ab5ea10c52a9bf6b4942e09c0be80cc8e4d250d6bfb4f48
+  metadata.gz: a4c8c80a0fccd793d93b2ef98374fd0bca253d5a36ff4d690dbd67de622bebd92ad27ef141d3c65c56ddd8c1934b9e9818a51eb3ef0a40b780ad0bc491263503
+  data.tar.gz: 339f5c58833ebb8ef19b511725c3f540e7506f097032235852088e0594dc917702723f8084f1abbdfd050b41f738486665d1c8b93891fb9fc7293c31d6e0483d

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.2.3] - 2025-09-23
+
+### Changed
+- Stop inserting `Verikloak::BFF::HeaderGuard` automatically via the Railtie and provide a `rails g verikloak:bff:install` generator that drops an initializer to opt in when the core middleware is ready.
+
 ## [0.2.2] - 2025-09-23
 
 ### Changed

data/README.md

@@ -31,12 +31,16 @@ use Verikloak::BFF::HeaderGuard, trusted_proxies: ['127.0.0.1', '10.0.0.0/8']
 ```
 
 ### Rails Applications
-Simply add to your Gemfile and the middleware will be automatically integrated:
+Add the gem to your Gemfile and run the install generator to drop an initializer that wires the middleware into Rails:
 ```ruby
 gem 'verikloak-bff'
 ```
 
-The gem automatically inserts `Verikloak::BFF::HeaderGuard` into the Rails middleware stack after the core `Verikloak::Middleware`. If the core middleware is not present (e.g., discovery not configured), it gracefully skips insertion with a warning, allowing Rails to boot normally.
+```sh
+bin/rails g verikloak:bff:install
+```
+
+The generated initializer inserts `Verikloak::BFF::HeaderGuard` after the core `Verikloak::Middleware` during boot. If the core middleware is not present (for example, when verikloak-rails has not been fully configured yet), the initializer logs a warning and allows Rails to boot normally.
 
 For detailed configuration, proxy setup examples, and troubleshooting, see [docs/rails.md](docs/rails.md).
 

data/lib/generators/verikloak/bff/install/install_generator.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'rails/generators/base'
+
+module Verikloak
+  module BFF
+    # Namespace for Rails generators related to Verikloak BFF
+    module Generators
+      # Rails generator for installing Verikloak BFF middleware integration.
+      #
+      # This generator creates a Rails initializer that safely inserts the
+      # Verikloak::BFF::HeaderGuard middleware into the Rails middleware stack.
+      # It replaces automatic middleware insertion to avoid boot failures when
+      # core Verikloak middleware is not yet configured.
+      #
+      # @example Basic usage
+      #   rails g verikloak:bff:install
+      #
+      # @example Custom initializer path
+      #   rails g verikloak:bff:install --initializer=config/initializers/custom_bff.rb
+      #
+      # @see Verikloak::BFF::Rails::Middleware
+      class InstallGenerator < ::Rails::Generators::Base
+        source_root File.expand_path('templates', __dir__)
+
+        # Configuration option for specifying the initializer file path.
+        #
+        # @option options [String] :initializer ('config/initializers/verikloak_bff.rb')
+        #   The path where the initializer file will be created
+        class_option :initializer, type: :string,
+                                   default: 'config/initializers/verikloak_bff.rb',
+                                   desc: 'Path for the generated initializer'
+
+        # Creates the Rails initializer file from template.
+        #
+        # Generates a Rails initializer that safely inserts the HeaderGuard
+        # middleware into the middleware stack with proper error handling.
+        # The initializer uses Verikloak::BFF::Rails::Middleware.insert_after_core
+        # to ensure graceful handling when core middleware is missing.
+        #
+        # @return [void]
+        def create_initializer
+          template 'initializer.rb.tt', initializer_path
+        end
+
+        private
+
+        # Returns the path where the initializer should be created.
+        #
+        # @return [String] The initializer file path from options
+        def initializer_path
+          options[:initializer]
+        end
+      end
+    end
+  end
+end

data/lib/verikloak/bff/railtie.rb

@@ -5,29 +5,27 @@ require_relative 'rails'
 module Verikloak
   # Module providing Verikloak BFF (Backend for Frontend) functionality
   module BFF
-    # Railtie class for integrating Verikloak BFF middleware into Rails applications
+    # Railtie for integrating Verikloak BFF with Rails applications.
     #
-    # This class automatically inserts Verikloak::BFF::Rails::Middleware into the
-    # Rails initialization process. The middleware is inserted after the
-    # 'verikloak.middleware' initializer and configured with an appropriate logger.
+    # This Railtie provides access to the BFF installation generator instead of
+    # automatically inserting middleware, which could cause boot failures when
+    # core Verikloak middleware is not yet configured.
     #
-    # @example Automatic initialization in Rails applications
-    #   # Simply adding verikloak-bff to Gemfile automatically enables it
-    #   gem 'verikloak-bff'
+    # @example Installing BFF middleware
+    #   rails g verikloak:bff:install
     #
     # @see Verikloak::BFF::Rails::Middleware
     class Railtie < ::Rails::Railtie
-      # Initializer that inserts Verikloak BFF middleware into Rails application
+      # Loads the install generator when Rails generator infrastructure is available.
       #
-      # This initializer runs after 'verikloak.middleware' and inserts
-      # Verikloak::BFF::Rails::Middleware at the appropriate position.
-      # Uses Rails.logger as the logger if available.
+      # Makes the `verikloak:bff:install` generator discoverable through `rails g`
+      # while keeping generators optional for non-Rails environments.
       #
-      # @param app [Rails::Application] Rails application instance
-      initializer 'verikloak.bff.insert_middleware', after: 'verikloak.middleware' do |app|
-        logger = ::Rails.logger if defined?(::Rails.logger)
+      # @return [void]
+      initializer 'verikloak.bff.load_generators' do
+        next unless defined?(Rails::Generators)
 
-        Verikloak::BFF::Rails::Middleware.insert_after_core(app.config.middleware, logger: logger)
+        require_relative '../../generators/verikloak/bff/install/install_generator'
       end
     end
   end

data/lib/verikloak/bff/version.rb

@@ -5,6 +5,6 @@
 # @return [String]
 module Verikloak
   module BFF
-    VERSION = '0.2.2'
+    VERSION = '0.2.3'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: verikloak-bff
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - taiyaky
@@ -78,6 +78,7 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- lib/generators/verikloak/bff/install/install_generator.rb
 - lib/verikloak-bff.rb
 - lib/verikloak/bff.rb
 - lib/verikloak/bff/configuration.rb
@@ -98,7 +99,7 @@ metadata:
   source_code_uri: https://github.com/taiyaky/verikloak-bff
   changelog_uri: https://github.com/taiyaky/verikloak-bff/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/taiyaky/verikloak-bff/issues
-  documentation_uri: https://rubydoc.info/gems/verikloak-bff/0.2.2
+  documentation_uri: https://rubydoc.info/gems/verikloak-bff/0.2.3
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: