pay 12.3.0 → 12.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f77372d0f6b47b272a614d14cd91183c86b56dd02d2ecea25fd99ebccde3ec7b
-  data.tar.gz: 7c6c0b2196445b486b0519a14c1fe1a1123c81316822af0cc2fea3c891c731dd
+  metadata.gz: 40ac78c02d095d82b2639d4755d68795de86c38bf281e125663268521c295fea
+  data.tar.gz: 7252f8657c37679b590863bc28a901ef6547bfdae139555a9a4d4fd8eb523f90
 SHA512:
-  metadata.gz: e30e10e229a3af4a2dea25d532c209831c9388222226d97b1c576e4ddf3aee7509da290a2fa6f762dd6a687bea07962e5c309c22ce1cca84a337d6edc979057c
-  data.tar.gz: 4878549cc6eb89db69734ae9bbec6d2e9fa4d6027322af4e266e89c5a026ebb19c946a202b63327f55c3b3da8b9384112ace9310effe1c9552a4ede2efef0516
+  metadata.gz: 5bbc88551ef32e78ffe4d4b7ef10ccd03b319e5636157a1c887d235a25ff61bc9db218d305da92eda6c96358f74c575580998d9e63cd7ed0140630b865b874d6
+  data.tar.gz: 508cd0bef62429d94811d151c60a07eadf29b32847795f96c851e69a5fbd42543ca9173c2988335ef3c80a415ab4bcb5acb0458b4c49ae409d16c3e0d74c7105

data/app/mailers/pay/user_mailer.rb

@@ -1,8 +1,11 @@
 module Pay
   class UserMailer < Pay.parent_mailer.constantize
     def receipt
-      if params[:pay_charge].respond_to? :receipt
-        attachments[params[:pay_charge].receipt_filename] = params[:pay_charge].receipt
+      pay_charge = params[:pay_charge]
+
+      if pay_charge.respond_to? :receipt
+        attachments[pay_charge.receipt_filename] = pay_charge.receipt
+        attachments[pay_charge.invoice_filename] = pay_charge.invoice if Pay.attach_invoice_to_receipt
       end
 
       mail mail_arguments
@@ -39,3 +42,5 @@ module Pay
     end
   end
 end
+
+ActiveSupport.run_load_hooks :pay_user_mailer, Pay::UserMailer

data/app/models/pay/charge.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Pay
   class Charge < Pay::ApplicationRecord
     # Associations
@@ -30,11 +32,16 @@ module Pay
 
     # Helpers for payment processors
     %w[braintree stripe paddle_billing paddle_classic lemon_squeezy fake_processor].each do |processor_name|
-      define_method :"#{processor_name}?" do
-        customer.processor == processor_name
-      end
-
-      scope processor_name, -> { joins(:customer).where(pay_customers: {processor: processor_name}) }
+      # Everything is inlined into the generated source so the scope lambda captures no variables,
+      # which lets Rails make it Ractor-shareable, and the predicate is a plain method rather than a
+      # closure, which lets a non-main Ractor call it.
+      class_eval <<~RUBY, __FILE__, __LINE__ + 1
+        scope :#{processor_name}, -> { joins(:customer).where(pay_customers: {processor: "#{processor_name}"}) }
+
+        def #{processor_name}?
+          customer.processor == "#{processor_name}"
+        end
+      RUBY
     end
 
     def self.find_by_processor_and_id(processor, processor_id)

data/app/models/pay/customer.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Pay
   class Customer < Pay::ApplicationRecord
     belongs_to :owner, polymorphic: true
@@ -21,11 +23,16 @@ module Pay
     delegate :email, to: :owner, allow_nil: true
 
     %w[stripe braintree paddle_billing paddle_classic lemon_squeezy fake_processor].each do |processor_name|
-      scope processor_name, -> { where(processor: processor_name) }
-
-      define_method :"#{processor_name}?" do
-        processor == processor_name
-      end
+      # Everything is inlined into the generated source so the scope lambda captures no variables,
+      # which lets Rails make it Ractor-shareable, and the predicate is a plain method rather than a
+      # closure, which lets a non-main Ractor call it.
+      class_eval <<~RUBY, __FILE__, __LINE__ + 1
+        scope :#{processor_name}, -> { where(processor: "#{processor_name}") }
+
+        def #{processor_name}?
+          processor == "#{processor_name}"
+        end
+      RUBY
     end
 
     def update_payment_method(payment_method_id)

data/app/models/pay/lemon_squeezy/subscription.rb

@@ -4,7 +4,7 @@ module Pay
       extend Pay::Sync
 
       # Lemon Squeezy statuses that Pay spells differently
-      STATUSES = {"on_trial" => "trialing", "cancelled" => "canceled"}.freeze
+      STATUSES = Pay.make_shareable({"on_trial" => "trialing", "cancelled" => "canceled"})
 
       def self.sync(subscription_id, object: nil, name: Pay.default_product_name)
         sync_with_retries do

data/app/models/pay/stripe/charge.rb

@@ -3,7 +3,7 @@ module Pay
     class Charge < Pay::Charge
       extend Pay::Sync
 
-      EXPAND = ["balance_transaction", "payment_intent", "refunds.data.balance_transaction"]
+      EXPAND = Pay.make_shareable(["balance_transaction", "payment_intent", "refunds.data.balance_transaction"])
 
       delegate :amount_captured, :payment_intent, to: :stripe_object, allow_nil: true
 

data/app/models/pay/subscription.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Pay
   class Subscription < Pay::ApplicationRecord
     # Associations
@@ -34,11 +36,16 @@ module Pay
 
     # Helper methods for payment processors
     %w[braintree stripe paddle_billing paddle_classic lemon_squeezy fake_processor].each do |processor_name|
-      define_method :"#{processor_name}?" do
-        customer.processor == processor_name
-      end
-
-      scope processor_name, -> { joins(:customer).where(pay_customers: {processor: processor_name}) }
+      # Everything is inlined into the generated source so the scope lambda captures no variables,
+      # which lets Rails make it Ractor-shareable, and the predicate is a plain method rather than a
+      # closure, which lets a non-main Ractor call it.
+      class_eval <<~RUBY, __FILE__, __LINE__ + 1
+        scope :#{processor_name}, -> { joins(:customer).where(pay_customers: {processor: "#{processor_name}"}) }
+
+        def #{processor_name}?
+          customer.processor == "#{processor_name}"
+        end
+      RUBY
     end
 
     delegate :owner, to: :customer

data/lib/pay/attributes.rb

@@ -8,9 +8,7 @@ module Pay
       extend ActiveSupport::Concern
 
       included do
-        cattr_accessor :pay_default_payment_processor
-        cattr_accessor :pay_stripe_customer_attributes
-        cattr_accessor :pay_braintree_customer_attributes
+        class_attribute :pay_default_payment_processor, :pay_stripe_customer_attributes, :pay_braintree_customer_attributes
 
         has_many :pay_customers, class_name: "Pay::Customer", as: :owner, inverse_of: :owner
         has_many :pay_charges, through: :pay_customers, class_name: "Pay::Charge", source: :charges

data/lib/pay/braintree.rb

@@ -38,6 +38,8 @@ module Pay
 
     extend Env
 
+    credential :public_key, :private_key, :merchant_id, :environment
+
     def self.enabled?
       return false unless Pay.enabled_processors.include?(:braintree) && defined?(::Braintree)
 
@@ -53,20 +55,8 @@ module Pay
       )
     end
 
-    def self.public_key
-      find_value_by_name(:braintree, :public_key)
-    end
-
-    def self.private_key
-      find_value_by_name(:braintree, :private_key)
-    end
-
-    def self.merchant_id
-      find_value_by_name(:braintree, :merchant_id)
-    end
-
     def self.environment
-      find_value_by_name(:braintree, :environment) || "sandbox"
+      super || "sandbox"
     end
 
     def self.configure_webhooks

data/lib/pay/engine.rb

@@ -4,11 +4,13 @@ module Pay
   class Engine < ::Rails::Engine
     engine_name "pay"
 
+    # Rails main runs this from Rails::Application#ractorize! before it shares the application with Ractors
+    ActiveSupport.on_load(:before_ractorize) { Pay.make_shareable! }
+
     initializer "pay.processors" do |app|
       if Pay.automount_routes
-        app.routes.append do
-          mount Pay::Engine, at: Pay.routes_path, as: "pay"
-        end
+        # Rails instance_execs this on the route mapper, so it loses its self here: an engine instance can't be shared with Ractors
+        app.routes.append(&Pay.shareable_callable(proc { mount Pay::Engine, at: Pay.routes_path, as: "pay" }))
       end
 
       # Include the pay attributes for ActiveRecord models
@@ -21,7 +23,7 @@ module Pay
       app.deprecators[:pay] = Pay.deprecator if app.respond_to?(:deprecators)
     end
 
-    RECEIPTS_VERSION = [">= 2", "< 4"]
+    RECEIPTS_VERSION = [">= 2", "< 4"].freeze
 
     initializer "pay.receipts" do
       if defined?(::Receipts::VERSION)
@@ -56,7 +58,7 @@ module Pay
 
     # Determines if a gem version matches requirements
     # Used for verifying that dependencies are correct
-    def version_matches?(current:, required:)
+    def self.version_matches?(current:, required:)
       Gem::Dependency.new("gem", required).match? "gem", current
     end
   end

data/lib/pay/env.rb

@@ -1,27 +1,45 @@
 module Pay
   module Env
-    private
-
-    # Search for environment variables
-    #
-    # We must handle a lot of different cases, including the new Rails 6
-    # environment separated credentials files which have no nesting for
-    # the current environment.
-    #
-    # 1. Check environment variable
-    # 2. Check environment scoped credentials
-    # 3. Check unscoped credentials
-    # 4. Check scoped and unscoped secrets (removed in Rails 7.2)
-    #
-    # For example, find_value_by_name("stripe", "private_key") will check the following in order until it finds a value:
+    # Declares the credentials a processor reads. Each gets a reader that looks the value up in this order:
     #
     #   ENV["STRIPE_PRIVATE_KEY"]
     #   Rails.application.credentials.dig(:production, :stripe, :private_key)
     #   Rails.application.credentials.dig(:stripe, :private_key)
-    def find_value_by_name(scope, name)
-      ENV["#{scope.upcase}_#{name.upcase}"] ||
-        credentials&.dig(env, scope, name) ||
-        credentials&.dig(scope, name)
+    #
+    # The readers live in an extended module, so a processor refines one with super (for a default, say).
+    # They are plain methods, not closures, so a Ractor can call them.
+    def credential(*names)
+      credential_names.concat(names)
+
+      readers = Module.new
+      names.each do |name|
+        readers.module_eval <<~RUBY, __FILE__, __LINE__ + 1
+          def #{name}
+            find_value_by_name(:#{name})
+          end
+        RUBY
+      end
+      extend readers
+    end
+
+    # Resolves every declared credential once and serves the frozen values from then on, so a Ractor never has to
+    # read ENV or the Rails credentials. Pay.make_shareable! calls this before Rails shares the application.
+    def freeze_credentials
+      @frozen_credentials = Pay.make_shareable(credential_names.to_h { |name| [name, find_value_by_name(name)] })
+    end
+
+    private
+
+    def credential_names
+      @credential_names ||= []
+    end
+
+    def find_value_by_name(name)
+      return @frozen_credentials.fetch(name) if @frozen_credentials
+
+      ENV["#{credential_scope.upcase}_#{name.upcase}"] ||
+        credentials&.dig(env, credential_scope, name) ||
+        credentials&.dig(credential_scope, name)
     rescue ActiveSupport::MessageEncryptor::InvalidMessage
       Rails.logger.error <<~MESSAGE
         Rails was unable to decrypt credentials. Pay checks the Rails credentials to look for API keys for payment processors.
@@ -32,6 +50,11 @@ module Pay
       MESSAGE
     end
 
+    # Pay::PaddleBilling reads :paddle_billing credentials
+    def credential_scope
+      @credential_scope ||= name.demodulize.underscore.to_sym
+    end
+
     def env
       Rails.env.to_sym
     end

data/lib/pay/lemon_squeezy.rb

@@ -15,6 +15,8 @@ module Pay
 
     extend Env
 
+    credential :api_key, :store_id, :signing_secret
+
     def self.enabled?
       return false unless Pay.enabled_processors.include?(:lemon_squeezy) && defined?(::LemonSqueezy)
 
@@ -25,18 +27,6 @@ module Pay
       ::LemonSqueezy.config.api_key = api_key
     end
 
-    def self.api_key
-      find_value_by_name(:lemon_squeezy, :api_key)
-    end
-
-    def self.store_id
-      find_value_by_name(:lemon_squeezy, :store_id)
-    end
-
-    def self.signing_secret
-      find_value_by_name(:lemon_squeezy, :signing_secret)
-    end
-
     def self.passthrough(owner:, **options)
       owner.to_sgid.to_s
     end

data/lib/pay/paddle_billing.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Pay
   module PaddleBilling
     class Error < Pay::Error
@@ -14,6 +16,8 @@ module Pay
 
     extend Env
 
+    credential :environment, :client_token, :api_key, :signing_secret
+
     REQUIRED_VERSION = "~> 3"
 
     def self.enabled?
@@ -29,19 +33,7 @@ module Pay
     end
 
     def self.environment
-      find_value_by_name(:paddle_billing, :environment) || "production"
-    end
-
-    def self.client_token
-      find_value_by_name(:paddle_billing, :client_token)
-    end
-
-    def self.api_key
-      find_value_by_name(:paddle_billing, :api_key)
-    end
-
-    def self.signing_secret
-      find_value_by_name(:paddle_billing, :signing_secret)
+      super || "production"
     end
 
     def self.configure_webhooks

data/lib/pay/paddle_classic.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Pay
   module PaddleClassic
     class Error < Pay::Error
@@ -18,6 +20,8 @@ module Pay
 
     extend Env
 
+    credential :vendor_id, :vendor_auth_code, :environment, :public_key, :public_key_file, :public_key_base64
+
     REQUIRED_VERSION = "~> 3"
 
     def self.enabled?
@@ -27,36 +31,25 @@ module Pay
         current: ::Paddle::VERSION) || (raise "[Pay] paddle gem must be version #{REQUIRED_VERSION}")
     end
 
+    # The client memoizes a Faraday connection, which can't be shared, so each non-main Ractor builds its own
     def self.client
-      @client ||= Paddle::Classic::Client.new(
+      if ::Ractor.current == ::Ractor.main
+        @client ||= new_client
+      else
+        ::Ractor.current[:pay_paddle_classic_client] ||= new_client
+      end
+    end
+
+    def self.new_client
+      Paddle::Classic::Client.new(
         vendor_id: vendor_id,
         vendor_auth_code: vendor_auth_code,
         sandbox: environment != "production"
       )
     end
 
-    def self.vendor_id
-      find_value_by_name(:paddle_classic, :vendor_id)
-    end
-
-    def self.vendor_auth_code
-      find_value_by_name(:paddle_classic, :vendor_auth_code)
-    end
-
     def self.environment
-      find_value_by_name(:paddle_classic, :environment) || "production"
-    end
-
-    def self.public_key
-      find_value_by_name(:paddle_classic, :public_key)
-    end
-
-    def self.public_key_file
-      find_value_by_name(:paddle_classic, :public_key_file)
-    end
-
-    def self.public_key_base64
-      find_value_by_name(:paddle_classic, :public_key_base64)
+      super || "production"
     end
 
     def self.passthrough(owner:, **options)

data/lib/pay/stripe.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Pay
   module Stripe
     class Error < Pay::Error
@@ -28,11 +30,18 @@ module Pay
 
     extend Env
 
+    # context is optional: the account (acct_...) that API requests act on when private_key is a Stripe
+    # Organizations API key. https://docs.stripe.com/keys/organization-api-keys
+    credential :public_key, :private_key, :context, :signing_secret, :webhook_receive_test_events
+
     REQUIRED_VERSION = "~> 20"
 
     # A list of database model names that include Pay
     # Used for safely looking up models with client_reference_id
-    mattr_accessor :model_names, default: Set.new
+    class << self
+      attr_accessor :model_names
+    end
+    self.model_names = Set.new
 
     def self.enabled?
       return false unless Pay.enabled_processors.include?(:stripe) && defined?(::Stripe)
@@ -61,28 +70,8 @@ module Pay
       ::Stripe.max_network_retries = 2
     end
 
-    def self.public_key
-      find_value_by_name(:stripe, :public_key)
-    end
-
-    def self.private_key
-      find_value_by_name(:stripe, :private_key)
-    end
-
-    # Optional. The account (acct_...) that API requests should act on when
-    # using a Stripe Organizations API key. Resolved like every other Stripe
-    # credential: ENV["STRIPE_CONTEXT"], then env-scoped, then unscoped
-    # Rails credentials.
-    def self.context
-      find_value_by_name(:stripe, :context)
-    end
-
-    def self.signing_secret
-      find_value_by_name(:stripe, :signing_secret)
-    end
-
     def self.webhook_receive_test_events
-      value = find_value_by_name(:stripe, :webhook_receive_test_events)
+      value = super
       value.blank? || ActiveModel::Type::Boolean.new.cast(value)
     end
 

data/lib/pay/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Pay
-  VERSION = "12.3.0"
+  VERSION = "12.4.0"
 end

data/lib/pay.rb

@@ -29,71 +29,67 @@ module Pay
     autoload :SyncCustomer, "pay/billable/sync_customer"
   end
 
-  mattr_accessor :braintree_gateway
-
-  mattr_accessor :model_parent_class
-  @@model_parent_class = "ApplicationRecord"
+  # Configuration is kept in instance variables on this module rather than in class variables (mattr_accessor),
+  # because Ruby forbids reading class variables from a non-main Ractor. Pay.make_shareable! deep-freezes these
+  # values before Rails shares the application with Ractors.
+  class << self
+    attr_accessor :model_parent_class
+
+    # Business details for receipts
+    attr_accessor :application_name, :business_address, :business_name, :business_logo
+    attr_reader :support_email
+
+    attr_accessor :automount_routes, :routes_path
+    attr_accessor :default_product_name, :default_plan_name
+    attr_accessor :enabled_processors
+    attr_accessor :send_emails, :emails, :attach_invoice_to_receipt
+    attr_writer :mailer
+    attr_accessor :braintree_gateway
+    attr_accessor :parent_mailer, :mail_arguments, :mail_to
+  end
 
-  # Business details for receipts
-  mattr_accessor :application_name
-  mattr_accessor :business_address
-  mattr_accessor :business_name
-  mattr_accessor :business_logo
-  mattr_reader :support_email
+  self.model_parent_class = "ApplicationRecord"
 
   def self.support_email=(value)
-    @@support_email = value.is_a?(::Mail::Address) ? value : ::Mail::Address.new(value)
+    address = value.is_a?(::Mail::Address) ? value : ::Mail::Address.new(value)
+    @support_email = address.tap(&:display_name) # memoized now, so the address still works once frozen
   end
 
-  mattr_accessor :automount_routes
-  @@automount_routes = true
-
-  mattr_accessor :default_product_name
-  @@default_product_name = "default"
-
-  mattr_accessor :default_plan_name
-  @@default_plan_name = "default"
-
-  mattr_accessor :routes_path
-  @@routes_path = "/pay"
-
-  mattr_accessor :enabled_processors
-  @@enabled_processors = [:stripe, :braintree, :paddle_billing, :paddle_classic, :lemon_squeezy]
-
-  mattr_accessor :send_emails
-  @@send_emails = true
-
-  mattr_accessor :emails
-  @@emails = ActiveSupport::OrderedOptions.new
-  @@emails.payment_action_required = true
-  @@emails.payment_failed = true
-  @@emails.receipt = true
-  @@emails.refund = true
+  self.automount_routes = true
+  self.default_product_name = "default"
+  self.default_plan_name = "default"
+  self.routes_path = "/pay"
+  self.enabled_processors = [:stripe, :braintree, :paddle_billing, :paddle_classic, :lemon_squeezy]
+  self.send_emails = true
+
+  self.emails = ActiveSupport::OrderedOptions.new
+  emails.payment_action_required = true
+  emails.payment_failed = true
+  emails.receipt = true
+  emails.refund = true
   # This only applies to Stripe, therefor we supply the second argument of price
-  @@emails.subscription_renewing = ->(pay_subscription, price) {
+  emails.subscription_renewing = ->(pay_subscription, price) {
     (price&.type == "recurring") && (price.recurring&.interval == "year")
   }
-  @@emails.subscription_trial_will_end = true
-  @@emails.subscription_trial_ended = true
+  emails.subscription_trial_will_end = true
+  emails.subscription_trial_ended = true
+  self.attach_invoice_to_receipt = true
 
-  mattr_writer :mailer
-  @@mailer = "Pay::UserMailer"
+  self.mailer = "Pay::UserMailer"
 
   # Resolved on every call rather than memoized, so code reloading in development returns the current class
   def self.mailer
-    @@mailer.constantize
+    @mailer.constantize
   end
 
   def self.deprecator
     @deprecator ||= ActiveSupport::Deprecation.new("13.0", "Pay")
   end
 
-  mattr_accessor :parent_mailer
-  @@parent_mailer = "Pay::ApplicationMailer"
+  self.parent_mailer = "Pay::ApplicationMailer"
 
   # Should return a hash of arguments for the `mail` call in UserMailer
-  mattr_accessor :mail_arguments
-  @@mail_arguments = -> {
+  self.mail_arguments = -> {
     {
       to: instance_exec(&Pay.mail_to),
       subject: default_i18n_subject(application: Pay.application_name)
@@ -101,8 +97,7 @@ module Pay
   }
 
   # Should return String or Array of email recipients
-  mattr_accessor :mail_to
-  @@mail_to = -> {
+  self.mail_to = -> {
     if ::ActionMailer::Base.respond_to?(:email_address_with_name)
       ::ActionMailer::Base.email_address_with_name(params[:pay_customer].email, params[:pay_customer].customer_name)
     else
@@ -134,13 +129,71 @@ module Pay
     end
   end
 
-  SYNC_HANDLERS = {
+  # Deep-freezes an object so every Ractor can read it
+  def self.make_shareable(object)
+    ::Ractor.make_shareable(object)
+  end
+
+  # Ruby 4.0 can re-create a proc with a different self. Earlier Rubies have Ractor without that.
+  def self.shareable_procs?
+    ::Ractor.respond_to?(:shareable_proc)
+  end
+  private_class_method :shareable_procs?
+
+  # A proc written in an initializer has the initializer's `main` object as self, which can't be shared, so it is
+  # re-created with nil as self. Procs Pay runs with instance_exec get their self replaced anyway. Anything that
+  # isn't a proc, or any proc on a Ruby that can't do this, is returned as it is.
+  def self.shareable_callable(callable)
+    return callable unless shareable_procs? && callable.is_a?(Proc)
+
+    callable.lambda? ? ::Ractor.shareable_lambda(self: nil, &callable) : ::Ractor.shareable_proc(self: nil, &callable)
+  end
+
+  # Prepares Pay for Rails' experimental Rails.application.ractorize!, which Rails runs from its before_ractorize
+  # load hook (see Pay::Engine). Configuration and credentials can't change afterwards.
+  def self.make_shareable!
+    return unless shareable_procs?
+
+    share_callable_options
+    share_customer_model_options
+    [Stripe, Braintree, PaddleBilling, PaddleClassic, LemonSqueezy].each(&:freeze_credentials)
+    make_shareable shareable_configuration
+  end
+
+  def self.share_callable_options
+    self.send_emails = shareable_callable(send_emails)
+    self.mail_to = shareable_callable(mail_to)
+    self.mail_arguments = shareable_callable(mail_arguments)
+    emails.transform_values! { |option| shareable_callable(option) }
+  end
+
+  def self.share_customer_model_options
+    customer_models = ActiveRecord::Base.descendants.select { |model| model.include?(Pay::Attributes::CustomerExtension) }
+    customer_models.each do |model|
+      model.pay_stripe_customer_attributes = shareable_callable(model.pay_stripe_customer_attributes)
+      model.pay_braintree_customer_attributes = shareable_callable(model.pay_braintree_customer_attributes)
+      make_shareable [model.pay_default_payment_processor, model.pay_stripe_customer_attributes, model.pay_braintree_customer_attributes]
+    end
+  end
+
+  # Everything a Ractor may read
+  def self.shareable_configuration
+    [
+      model_parent_class, application_name, business_address, business_name, business_logo, support_email,
+      automount_routes, routes_path, default_product_name, default_plan_name, enabled_processors,
+      send_emails, emails, attach_invoice_to_receipt, @mailer, parent_mailer, mail_arguments, mail_to,
+      Stripe.model_names, Currency.all, Webhooks.delegator, deprecator
+    ]
+  end
+  private_class_method :share_callable_options, :share_customer_model_options, :shareable_configuration
+
+  SYNC_HANDLERS = make_shareable({
     lemon_squeezy_order_id: ->(param) { Pay::LemonSqueezy.sync_order(param) },
     paddle_billing_transaction_id: ->(param) { Pay::PaddleBilling.sync_transaction(param) },
     stripe_checkout_session_id: ->(param) { Pay::Stripe.sync_checkout_session(param) },
     transaction_id: ->(param) { Pay::PaddleBilling.sync_transaction(param) },
     session_id: ->(param) { Pay::Stripe.sync_checkout_session(param) }
-  }
+  })
 
   def self.sync(params)
     SYNC_HANDLERS.each do |param_name, handler|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pay
 version: !ruby/object:Gem::Version
-  version: 12.3.0
+  version: 12.4.0
 platform: ruby
 authors:
 - Jason Charnes
@@ -184,7 +184,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="