Add pay on_load hook

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ### Unreleased
 
+* Introduce `:pay` load hook - @excid3
+  Rails no longer allows autoloading during the initialization process. The on_load hook allows you to run code after autoloading, so we can register webhook listeners once autoloading is available.
+
+  To use this, wrap your webhook subscribe calls in the `on_load(:pay)` hook:
+
+  ```ruby
+    ActiveSupport.on_load(:pay) do
+      Pay::Webhooks.delegator.subscribe "stripe.charge.succeded", ChargeSucceeded
+    end
+  ```
+
 ### 6.3.4
 
 * Import Stimulus.js from dist folder on unpkg

docs/7_webhooks.md

@@ -64,7 +64,9 @@ class MyChargeSucceededProcessor
   end
 end
 
-Pay::Webhooks.delegator.subscribe "stripe.charge.succeeded", MyChargeSucceededProcessor.new
+ActiveSupport.on_load(:pay) do
+  Pay::Webhooks.delegator.subscribe "stripe.charge.succeeded", MyChargeSucceededProcessor.new
+end
 ```
 
 ### Unsubscribing from a webhook listener

lib/pay/engine.rb

@@ -17,6 +17,10 @@ class Engine < ::Rails::Engine
       end
     end
 
+    config.after_initialize do
+      ActiveSupport.run_load_hooks(:pay, Pay)
+    end
+
     # Add webhook subscribers before app initializers define extras
     # This keeps the processing in order so that changes have happened before user-defined webhook processors
     config.before_initialize do

test/dummy/app/webhooks/charge_succeeded.rb

@@ -0,0 +1,5 @@
+class ChargeSucceeded
+  def call(event)
+    Rails.logger.debug event
+  end
+end

test/dummy/config/initializers/pay.rb

@@ -10,3 +10,7 @@
   config.application_name = "My App"
   config.support_email = "support@example.org"
 end
+
+ActiveSupport.on_load(:pay) do
+  Pay::Webhooks.delegator.subscribe "stripe.charge.succeeded", ChargeSucceeded.new
+end