Use autoload instead of eager require for generated resource, service, and param files (stripe#1855)

* Convert eager require to autoload for resources, services, and params

Replace ~985 eager require calls with Ruby's autoload in the three
generated barrel files (resources.rb, services.rb, params.rb). This
defers loading of resource classes, service classes, and param classes
until they are first referenced, rather than loading all of them on
require 'stripe'.

Add Stripe.eager_load! for production use — it walks the same file
list in the same order as the old require calls, so there are no
load-order surprises. A Railtie registers Stripe in
config.eager_load_namespaces so Rails calls eager_load! automatically
when config.eager_load is true (the production default).

On Ruby 4.0.2 / Apple M1:
- Boot time: 214ms -> 61ms (-71%)
- Object allocations: 193k -> 35k (-82%)
- Retained memory: 9.0 MB -> 1.4 MB (-85%)

Ref stripe#1432

Co-authored-by: Claude <noreply@anthropic.com>

* Fix lint and typecheck CI failures

- Run rubocop autocorrect to fix line length, trailing whitespace, and
  argument alignment in autoload statements
- Exclude lib/stripe/params.rb from CollectionLiteralLength (generated
  list, same as existing event_types.rb exclusion)
- Add typed: ignore to railtie files since Rails isn't a Sorbet-visible
  dependency

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

* Regenerate resources, services, and params from updated codegen

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

* Remove redundant rubocop.yml exclusion for params.rb

The codegen now emits an inline rubocop:disable comment around the
PARAM_FILES array, making the .rubocop.yml file-level exclusion
unnecessary.

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

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Michael Broshi <mbroshi@stripe.com>

Author: 3 people

lib/stripe.rb

@@ -52,11 +52,11 @@
 require "stripe/singleton_api_resource"
 require "stripe/webhook"
 require "stripe/stripe_configuration"
-require "stripe/resources/v2/amount"
-require "stripe/resources/v2/deleted_object"
-require "stripe/resources/v2/core/event_notification"
 
-# Named API resources
+# Named API resources — autoloaded on first use to reduce boot time.
+# Call Stripe.eager_load! to load everything upfront (recommended
+# before forking in production). In Rails, this happens automatically
+# when config.eager_load is true.
 require "stripe/resources"
 require "stripe/services"
 require "stripe/params"
@@ -65,6 +65,10 @@
 require "stripe/oauth"
 require "stripe/services/oauth_service"
 
+# Rails integration — registers Stripe in config.eager_load_namespaces
+# so Stripe.eager_load! is called automatically when config.eager_load is true.
+require "stripe/railtie" if defined?(Rails::Railtie)
+
 module Stripe
   DEFAULT_CA_BUNDLE_PATH = __dir__ + "/data/ca-certificates.crt"
 
@@ -136,6 +140,23 @@ class << self
     def_delegators :@config, :ca_store
   end
 
+  # Eagerly loads all autoloaded Stripe constants (resources, services,
+  # params) using the same file list and load order as previous versions
+  # of this gem that used eager require.
+  #
+  # Call this before forking in production (Puma, Unicorn, etc.) to
+  # avoid autoload in multi-threaded request handling. In Rails apps
+  # this is called automatically when config.eager_load is true.
+  #
+  #   # Non-Rails production / pre-fork hook:
+  #   Stripe.eager_load!
+  #
+  def self.eager_load!
+    (RESOURCE_FILES + SERVICE_FILES + PARAM_FILES).each do |path|
+      require path
+    end
+  end
+
   # Gets the application for a plugin that's identified some. See
   # #set_app_info.
   def self.app_info

lib/stripe/params.rb

@@ -0,0 +1,8 @@
+# typed: ignore
+# frozen_string_literal: true
+
+module Stripe
+  class Railtie < ::Rails::Railtie
+    config.eager_load_namespaces << Stripe
+  end
+end

lib/stripe/railtie.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require File.expand_path("../test_helper", __dir__)
+
+module Stripe
+  class AutoloadTest < Test::Unit::TestCase
+    context "autoloaded constants" do
+      should "resolve all v1 object type classes" do
+        Stripe::ObjectTypes.object_names_to_classes.each do |name, klass|
+          assert_kind_of Class, klass, "#{name} did not resolve to a class"
+        end
+      end
+
+      should "resolve all v2 object type classes" do
+        Stripe::ObjectTypes.v2_object_names_to_classes.each do |name, klass|
+          assert_kind_of Class, klass, "#{name} did not resolve to a class"
+        end
+      end
+
+      should "resolve all v2 event type classes" do
+        Stripe::EventTypes.v2_event_types_to_classes.each do |type, klass|
+          assert_kind_of Class, klass, "#{type} did not resolve to a class"
+        end
+      end
+
+      should "resolve all event notification type classes" do
+        Stripe::EventTypes.event_notification_types_to_classes.each do |type, klass|
+          assert_kind_of Class, klass, "#{type} did not resolve to a class"
+        end
+      end
+
+      should "define EventNotification constants from event files" do
+        # Each event file defines both *Event and *EventNotification.
+        # Verify the *EventNotification constants are accessible.
+        assert_kind_of Class, Stripe::Events::V2CoreAccountClosedEventNotification
+        assert_kind_of Class, Stripe::Events::V1BillingMeterErrorReportTriggeredEventNotification
+      end
+    end
+
+    context ".eager_load!" do
+      should "load all registered files without error" do
+        assert_nothing_raised { Stripe.eager_load! }
+      end
+
+      should "make all resource constants available" do
+        Stripe.eager_load!
+
+        # Spot-check a sample of resources across namespaces
+        assert_equal "customer", Stripe::Customer::OBJECT_NAME
+        assert_equal "billing.alert", Stripe::Billing::Alert::OBJECT_NAME
+        assert_equal "checkout.session", Stripe::Checkout::Session::OBJECT_NAME
+        assert_equal "issuing.card", Stripe::Issuing::Card::OBJECT_NAME
+        assert_equal "treasury.financial_account", Stripe::Treasury::FinancialAccount::OBJECT_NAME
+      end
+    end
+  end
+end

lib/stripe/resources.rb

@@ -0,0 +1,28 @@
+# typed: ignore
+# frozen_string_literal: true
+
+require "test/unit"
+
+begin
+  require "rails"
+rescue LoadError
+  # Rails is not a dependency of stripe-ruby; skip these tests when unavailable.
+end
+
+if defined?(Rails::Railtie)
+  require "stripe"
+
+  class RailtieTest < Test::Unit::TestCase
+    test "Railtie is defined and is a Rails::Railtie" do
+      assert_operator Stripe::Railtie, :<, ::Rails::Railtie
+    end
+
+    test "Stripe is registered in eager_load_namespaces" do
+      app = Class.new(Rails::Application) do
+        config.eager_load = false
+        config.active_support.to_time_preserves_timezone = :zone
+      end
+      assert_includes app.config.eager_load_namespaces, Stripe
+    end
+  end
+end