Merge branch 'beta' into DEVSDK-2822

Author: xavdid-stripe

.rubocop.yml

@@ -78,7 +78,6 @@ Metrics/ModuleLength:
   Enabled: false
 
 Metrics/ParameterLists:
-  # There's 2 methods in `StripeClient` that have long parameter lists.
   Max: 8
   # Optional parameters should be consistent across libraries, we need not be
   # concerned about this. Was introduced with adding `base_address`

.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2023-11-28 01:02:03 UTC using RuboCop version 1.57.2.
+# on 2023-11-29 18:39:02 UTC using RuboCop version 1.57.2.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -11,30 +11,25 @@ Lint/HashCompareByIdentity:
   Exclude:
     - 'lib/stripe/api_requestor.rb'
 
-# Offense count: 26
+# Offense count: 27
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 50
+  Max: 55
 
-# Offense count: 9
+# Offense count: 10
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 592
+  Max: 618
 
 # Offense count: 12
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
   Max: 12
 
 # Offense count: 9
-# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
-Metrics/ParameterLists:
-  Max: 7
-
-# Offense count: 8
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
-  Max: 12
+  Max: 13
 
 # Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
@@ -49,7 +44,7 @@ Style/CombinableLoops:
   Exclude:
     - 'lib/stripe/api_requestor.rb'
 
-# Offense count: 39
+# Offense count: 44
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
   Enabled: false

API_VERSION

@@ -1 +1 @@
-6d15a7f20cb77c2c22091a30e499cb89d7e3248c
+c5d9f47b11fbac901125e0621faadddc6ac6eb1e

CHANGELOG.md

@@ -1 +1 @@
-v2111
+v2104

OPENAPI_VERSION

@@ -1 +1 @@
-17.2.0
+17.2.0-beta.1

VERSION

@@ -112,6 +112,7 @@ class << self
 
     # User configurable options
     def_delegators :@config, :api_key, :api_key=
+    def_delegators :@config, :authenticator, :authenticator=
     def_delegators :@config, :api_version, :api_version=
     def_delegators :@config, :stripe_account, :stripe_account=
     def_delegators :@config, :api_base, :api_base=
@@ -159,6 +160,58 @@ def self.set_app_info(name, partner_id: nil, url: nil, version: nil)
       version: version,
     }
   end
+
+  def self.add_beta_version(beta_name, version)
+    unless version.start_with?("v") && version[1..].to_i.to_s == version[1..]
+      raise ArgumentError, "Version must be in the format 'v' followed by a number (e.g., 'v3')"
+    end
+
+    if (index = api_version.index("; #{beta_name}="))
+      start_index = index + "; #{beta_name}=".length
+      end_index = api_version.index(";", start_index) || api_version.length
+      current_version = api_version[start_index...end_index][1..].to_i
+      new_version = version[1..].to_i
+      return if new_version <= current_version # Keep the higher version, no update needed
+
+      self.api_version = api_version[0...index] + "; #{beta_name}=#{version}" + api_version[end_index..]
+    else
+      self.api_version = "#{api_version}; #{beta_name}=#{version}"
+    end
+  end
+
+  class RawRequest
+    def initialize
+      @opts = {}
+    end
+
+    def execute(method, url, base_address: :api, params: {}, opts: {}, usage: [])
+      opts = Util.normalize_opts(opts)
+      req_opts = RequestOptions.extract_opts_from_hash(opts)
+
+      requestor = APIRequestor.active_requestor
+      resp, = requestor.send(:execute_request_internal, method, url, base_address, params, req_opts,
+                             usage)
+
+      requestor.interpret_response(resp)
+    end
+  end
+
+  # Sends a request to Stripe REST API
+  def self.raw_request(method, url, params = {}, opts = {}, base_address: :api)
+    req = RawRequest.new
+    req.execute(method, url, base_address: base_address, params: params, opts: opts,
+                             usage: ["raw_request"])
+  end
+
+  def self.deserialize(data, api_mode: :v1)
+    data = JSON.parse(data) if data.is_a?(String)
+    Util.convert_to_stripe_object(data, {}, api_mode: api_mode)
+  end
+  class << self
+    extend Gem::Deprecate
+    deprecate :raw_request, "StripeClient#raw_request", 2024, 9
+    deprecate :deserialize, "StripeClient#deserialize", 2024, 9
+  end
 end
 
 Stripe.log_level = ENV["STRIPE_LOG"] unless ENV["STRIPE_LOG"].nil?

lib/stripe.rb

@@ -853,6 +853,40 @@ def self.maybe_gc_connection_managers
       when "idempotency_error"
         IdempotencyError.new(error_data[:message], **opts)
       # switch cases: The beginning of the section generated from our OpenAPI spec
+      when "already_canceled"
+        AlreadyCanceledError.new(error_data[:message], **opts)
+      when "already_exists"
+        AlreadyExistsError.new(error_data[:message], **opts)
+      when "blocked_by_stripe"
+        BlockedByStripeError.new(error_data[:message], **opts)
+      when "controlled_by_dashboard"
+        ControlledByDashboardError.new(error_data[:message], **opts)
+      when "feature_not_enabled"
+        FeatureNotEnabledError.new(error_data[:message], **opts)
+      when "financial_account_not_open"
+        FinancialAccountNotOpenError.new(error_data[:message], **opts)
+      when "insufficient_funds"
+        InsufficientFundsError.new(error_data[:message], **opts)
+      when "invalid_payment_method"
+
+        InvalidPaymentMethodError.new(
+          error_data[:message],
+          **opts,
+          invalid_param: error_data[:invalid_param]
+        )
+
+      when "invalid_payout_method"
+        InvalidPayoutMethodError.new(error_data[:message], **opts)
+      when "non_zero_balance"
+        NonZeroBalanceError.new(error_data[:message], **opts)
+      when "not_cancelable"
+        NotCancelableError.new(error_data[:message], **opts)
+      when "quota_exceeded"
+        QuotaExceededError.new(error_data[:message], **opts)
+      when "rate_limit"
+        RateLimitError.new(error_data[:message], **opts)
+      when "recipient_not_notifiable"
+        RecipientNotNotifiableError.new(error_data[:message], **opts)
       when "temporary_session_expired"
         TemporarySessionExpiredError.new(error_data[:message], **opts)
       # switch cases: The end of the section generated from our OpenAPI spec

lib/stripe/api_requestor.rb

@@ -3,7 +3,6 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2025-10-29.clover"
-    CURRENT_MAJOR = "clover"
+    CURRENT = "2025-10-29.preview"
   end
 end

lib/stripe/api_version.rb

@@ -162,6 +162,69 @@ class UnsupportedResponseTypeError < OAuthError
   end
 
   # class definitions: The beginning of the section generated from our OpenAPI spec
+  class AlreadyCanceledError < StripeError
+  end
+
+  class AlreadyExistsError < StripeError
+  end
+
+  class BlockedByStripeError < StripeError
+  end
+
+  class ControlledByDashboardError < StripeError
+  end
+
+  class FeatureNotEnabledError < StripeError
+  end
+
+  class FinancialAccountNotOpenError < StripeError
+  end
+
+  class InsufficientFundsError < StripeError
+  end
+
+  class InvalidPaymentMethodError < StripeError
+    attr_reader :invalid_param
+
+    def initialize(
+      message = nil,
+      http_body: nil,
+      http_status: nil,
+      json_body: nil,
+      http_headers: nil,
+      code: nil,
+      invalid_param: nil
+    )
+      super(
+        message,
+        http_body: http_body,
+        http_status: http_status,
+        json_body: json_body,
+        http_headers: http_headers,
+        code: code,
+      )
+      @invalid_param = invalid_param
+    end
+  end
+
+  class InvalidPayoutMethodError < StripeError
+  end
+
+  class NonZeroBalanceError < StripeError
+  end
+
+  class NotCancelableError < StripeError
+  end
+
+  class QuotaExceededError < StripeError
+  end
+
+  class RateLimitError < StripeError
+  end
+
+  class RecipientNotNotifiableError < StripeError
+  end
+
   class TemporarySessionExpiredError < StripeError
   end
   # class definitions: The end of the section generated from our OpenAPI spec