Merge pull request #44 from cardmagic/fix/defer-active-record-load

Load the record class when Active Record loads

Author: cardmagic

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.13.3 - 2026-08-18
+
+- Stop loading `ActiveRecord::Base` when the gem is required. The engine now
+  loads `SolidObjects::Record` from an `ActiveSupport.on_load(:active_record)`
+  hook, so a host application keeps the normal timing of its own
+  `on_load(:active_record)` and `on_load(:active_record_encryption)` hooks. An
+  application that assigns its Active Record encryption keys in
+  `config/initializers` no longer loses them.
+- Apply the configured `connects_to` in the record class body, so the
+  connection follows the class through a development reload.
+
 ## 0.13.2 - 2026-08-17
 
 - Accept a `key:` on `schedule`, naming a reminder for the item it is waiting

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    solid_objects (0.13.2)
+    solid_objects (0.13.3)
       actioncable (>= 8.0)
       actionpack (>= 8.0)
       actionview (>= 8.0)
@@ -384,7 +384,7 @@ CHECKSUMS
   rubocop-rails-omakase (1.1.0) sha256=2af73ac8ee5852de2919abbd2618af9c15c19b512c4cfc1f9a5d3b6ef009109d
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
   securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
-  solid_objects (0.13.2)
+  solid_objects (0.13.3)
   sqlite3 (2.9.5-aarch64-linux-gnu) sha256=78075b6337d3d182c6d2b4691049ed45cd220826160c9ea18946bf6a1de200dc
   sqlite3 (2.9.5-aarch64-linux-musl) sha256=18c801185deb4adc01ddb281e8f672a39e3d1729979ca91e39439cd3eac0402d
   sqlite3 (2.9.5-arm-linux-gnu) sha256=1bdfca0c7d63998c60b0f4a8e3c8df2d33800ccc4abd2d612eddbbbc92a4c48b

app/models/solid_objects/record.rb

@@ -13,5 +13,7 @@ def configure_connection
         connects_to(**connection_configuration)
       end
     end
+
+    configure_connection
   end
 end

lib/solid_objects/engine.rb

@@ -1,9 +1,9 @@
 # rbs_inline: enabled
 
-require_relative "../../app/models/solid_objects/record"
-
 module SolidObjects
   class Engine < ::Rails::Engine
+    RECORD_PATH = File.expand_path("../../app/models/solid_objects/record.rb", __dir__)
+
     isolate_namespace SolidObjects
 
     config.generators do |generators|
@@ -16,7 +16,9 @@ class Engine < ::Rails::Engine
     end
 
     initializer "solid_objects.database", after: :load_config_initializers do
-      SolidObjects::Record.configure_connection
+      ActiveSupport.on_load(:active_record) do
+        require RECORD_PATH
+      end
     end
 
     initializer "solid_objects.helpers" do

lib/solid_objects/version.rb

@@ -1,5 +1,5 @@
 # rbs_inline: enabled
 
 module SolidObjects
-  VERSION = "0.13.2"
+  VERSION = "0.13.3"
 end

sig/generated/lib/solid_objects/engine.rbs

@@ -2,6 +2,8 @@
 
 module SolidObjects
   class Engine < ::Rails::Engine
+    RECORD_PATH: untyped
+
     include SolidObjects::ActorHelper
   end
 end

test/dummy/config/initializers/encryption_keys.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+Rails.application.config.active_record.encryption.primary_key =
+  "solid-objects-dummy-primary-key"
+Rails.application.config.active_record.encryption.deterministic_key =
+  "solid-objects-dummy-deterministic-key"
+Rails.application.config.active_record.encryption.key_derivation_salt =
+  "solid-objects-dummy-key-derivation-salt"

test/dummy/config/initializers/solid_objects_connects_to.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+if ENV["SOLID_OBJECTS_DUMMY_CONNECTS_TO"]
+  SolidObjects.configure do |config|
+    config.connects_to = { database: { writing: :primary } }
+  end
+end

test/dummy/connects_to_check.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+ENV["RAILS_ENV"] = "test"
+ENV["SOLID_OBJECTS_DUMMY_CONNECTS_TO"] = "1"
+
+require_relative "config/environment"
+
+Rails.application.eager_load!
+
+puts ActiveRecord::Base.connection_handler.connection_pool_names.sort.join(" ")

test/dummy/encryption_configuration_check.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+ENV["RAILS_ENV"] = "test"
+
+require_relative "config/environment"
+
+puts ActiveRecord::Encryption.config.primary_key