stripe 20.2.0.pre.alpha.1 → 20.2.0.pre.alpha.2

data/lib/stripe/resources/v2/extend/object_definition_version.rb

@@ -0,0 +1,168 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Extend
+      # Represents an immutable version of an object definition.
+      # It defines the fields of the object records created from it.
+      class ObjectDefinitionVersion < APIResource
+        OBJECT_NAME = "v2.extend.object_definition_version"
+        def self.object_name
+          "v2.extend.object_definition_version"
+        end
+
+        class ParentDetails < ::Stripe::StripeObject
+          # The plural API name used in this definition's object record API paths.
+          attr_reader :api_name_plural
+          # The singular API name used in this definition's object record tags.
+          attr_reader :api_name_singular
+          # The ID of the parent object definition.
+          attr_reader :id
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Properties < ::Stripe::StripeObject
+          class Items < ::Stripe::StripeObject
+            class Items < ::Stripe::StripeObject
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # A required list of values for enum types.
+            attr_reader :allowed_values
+            # An optional default value for the field.
+            attr_reader :default_value
+            # An optional human-readable description of the field.
+            attr_reader :description
+            # An optional exclusive maximum value for integer or decimal types.
+            attr_reader :exclusive_maximum
+            # An optional exclusive minimum value for integer or decimal types.
+            attr_reader :exclusive_minimum
+            # Whether or not the field is deprecated (default false).
+            attr_reader :is_deprecated
+            # The required scalar schema for each array item. Array values retain their supplied order, and
+            # order is significant. Values are never sorted. Empty arrays are valid unless min_items is positive.
+            attr_reader :items
+            # An optional maximum number of array items. It defaults to and cannot exceed 100.
+            attr_reader :max_items
+            # An optional maximum length validation for string fields.
+            attr_reader :max_length
+            # An optional maximum value for integer or decimal types.
+            attr_reader :maximum
+            # An optional minimum number of array items. Empty arrays are valid when this is absent or zero.
+            attr_reader :min_items
+            # An optional minimum length validation for string fields.
+            attr_reader :min_length
+            # An optional minimum value for integer or decimal types.
+            attr_reader :minimum
+            # The type referenced by object reference fields.
+            attr_reader :referenced_type
+            # Whether or not the field is required (default false).
+            attr_reader :required
+            # An optional human-readable name for the field.
+            attr_reader :title
+            # The data type of the field.
+            attr_reader :type
+            # Whether array item values must be unique (default false). Duplicate values are allowed by default.
+            attr_reader :unique_items
+
+            def self.inner_class_types
+              @inner_class_types = { items: Items }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # A required list of values for enum types.
+          attr_reader :allowed_values
+          # An optional default value for the field.
+          attr_reader :default_value
+          # An optional human-readable description of the field.
+          attr_reader :description
+          # An optional exclusive maximum value for integer or decimal types.
+          attr_reader :exclusive_maximum
+          # An optional exclusive minimum value for integer or decimal types.
+          attr_reader :exclusive_minimum
+          # Whether or not the field is deprecated (default false).
+          attr_reader :is_deprecated
+          # The required scalar schema for each array item. Array values retain their supplied order, and
+          # order is significant. Values are never sorted. Empty arrays are valid unless min_items is positive.
+          attr_reader :items
+          # An optional maximum number of array items. It defaults to and cannot exceed 100.
+          attr_reader :max_items
+          # An optional maximum length validation for string fields.
+          attr_reader :max_length
+          # An optional maximum value for integer or decimal types.
+          attr_reader :maximum
+          # An optional minimum number of array items. Empty arrays are valid when this is absent or zero.
+          attr_reader :min_items
+          # An optional minimum length validation for string fields.
+          attr_reader :min_length
+          # An optional minimum value for integer or decimal types.
+          attr_reader :minimum
+          # The type referenced by object reference fields.
+          attr_reader :referenced_type
+          # Whether or not the field is required (default false).
+          attr_reader :required
+          # An optional human-readable name for the field.
+          attr_reader :title
+          # The data type of the field.
+          attr_reader :type
+          # Whether array item values must be unique (default false). Duplicate values are allowed by default.
+          attr_reader :unique_items
+
+          def self.inner_class_types
+            @inner_class_types = { items: Items }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Time at which the object definition version was created.
+        attr_reader :created
+        # A description of what this version of the object definition represents.
+        attr_reader :description
+        # The human-readable plural name of this version.
+        attr_reader :display_name_plural
+        # The human-readable singular name of this version.
+        attr_reader :display_name_singular
+        # The complete version ID, consisting of the object definition ID, `@`, and a semantic version.
+        attr_reader :id
+        # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+        attr_reader :livemode
+        # String representing the object's type. Objects of the same type share the same value of the object field.
+        attr_reader :object
+        # The ID of the parent object definition.
+        attr_reader :object_definition
+        # The stable identity and API names of the parent object definition.
+        attr_reader :parent_details
+        # The schema of the object record fields defined by this object definition.
+        attr_reader :properties
+        # The semantic version of this object definition version, in `major.minor.patch` format.
+        attr_reader :version
+
+        def self.inner_class_types
+          @inner_class_types = { parent_details: ParentDetails, properties: Properties }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

data/lib/stripe/resources/v2/tax/operations_resolve_address_result.rb

@@ -5,7 +5,7 @@ module Stripe
   module V2
     module Tax
       # The result of resolving an address to its tax precision level.
-      class OperationsResolveAddressResult < SingletonAPIResource
+      class OperationsResolveAddressResult < StripeObject
         OBJECT_NAME = "v2.tax.operations_resolve_address_result"
         def self.object_name
           "v2.tax.operations_resolve_address_result"

data/lib/stripe/resources.rb

@@ -1257,6 +1257,13 @@ module Stripe
     autoload :V2DataReportRunUpdatedEventNotification, "stripe/events/v2_data_report_run_updated_event"
     autoload :V2ExtendExtensionRunFailedEvent, "stripe/events/v2_extend_extension_run_failed_event"
     autoload :V2ExtendExtensionRunFailedEventNotification, "stripe/events/v2_extend_extension_run_failed_event"
+    autoload :V2ExtendObjectDefinitionCreatedEvent, "stripe/events/v2_extend_object_definition_created_event"
+    autoload :V2ExtendObjectDefinitionCreatedEventNotification,
+             "stripe/events/v2_extend_object_definition_created_event"
+    autoload :V2ExtendObjectDefinitionVersionCreatedEvent,
+             "stripe/events/v2_extend_object_definition_version_created_event"
+    autoload :V2ExtendObjectDefinitionVersionCreatedEventNotification,
+             "stripe/events/v2_extend_object_definition_version_created_event"
     autoload :V2ExtendWorkflowRunFailedEvent, "stripe/events/v2_extend_workflow_run_failed_event"
     autoload :V2ExtendWorkflowRunFailedEventNotification, "stripe/events/v2_extend_workflow_run_failed_event"
     autoload :V2ExtendWorkflowRunStartedEvent, "stripe/events/v2_extend_workflow_run_started_event"
@@ -1836,7 +1843,9 @@ module Stripe
     autoload :Association, "stripe/resources/tax/association"
     autoload :Calculation, "stripe/resources/tax/calculation"
     autoload :CalculationLineItem, "stripe/resources/tax/calculation_line_item"
+    autoload :Certificate, "stripe/resources/tax/certificate"
     autoload :Form, "stripe/resources/tax/form"
+    autoload :FormCorrection, "stripe/resources/tax/form_correction"
     autoload :Location, "stripe/resources/tax/location"
     autoload :Registration, "stripe/resources/tax/registration"
     autoload :Settings, "stripe/resources/tax/settings"
@@ -1969,6 +1978,8 @@ module Stripe
     end
 
     module Extend
+      autoload :ObjectDefinition, "stripe/resources/v2/extend/object_definition"
+      autoload :ObjectDefinitionVersion, "stripe/resources/v2/extend/object_definition_version"
       autoload :Workflow, "stripe/resources/v2/extend/workflow"
       autoload :WorkflowRun, "stripe/resources/v2/extend/workflow_run"
     end
@@ -2250,7 +2261,9 @@ module Stripe
     stripe/resources/tax/association
     stripe/resources/tax/calculation
     stripe/resources/tax/calculation_line_item
+    stripe/resources/tax/certificate
     stripe/resources/tax/form
+    stripe/resources/tax/form_correction
     stripe/resources/tax/location
     stripe/resources/tax/registration
     stripe/resources/tax/settings
@@ -2346,6 +2359,8 @@ module Stripe
     stripe/resources/v2/data/schema
     stripe/resources/v2/data/search_result_list
     stripe/resources/v2/deleted_object
+    stripe/resources/v2/extend/object_definition
+    stripe/resources/v2/extend/object_definition_version
     stripe/resources/v2/extend/workflow
     stripe/resources/v2/extend/workflow_run
     stripe/resources/v2/iam/activity_log
@@ -2823,6 +2838,8 @@ module Stripe
     stripe/events/v2_data_reporting_query_run_succeeded_event
     stripe/events/v2_data_reporting_query_run_updated_event
     stripe/events/v2_extend_extension_run_failed_event
+    stripe/events/v2_extend_object_definition_created_event
+    stripe/events/v2_extend_object_definition_version_created_event
     stripe/events/v2_extend_workflow_run_failed_event
     stripe/events/v2_extend_workflow_run_started_event
     stripe/events/v2_extend_workflow_run_succeeded_event

data/lib/stripe/services/apps/install_service.rb

@@ -4,7 +4,7 @@
 module Stripe
   module Apps
     class InstallService < StripeService
-      # Creates an app install. An account installs its own private app with its own key; public and testing installs are made from the Dashboard. An app developer acting on a connected account through Stripe-Account installs or reinstalls its app there, and an embedding platform can do the same once the app's developer approves its request to embed the app. For a private app, creating an install installs the newest completed upload; when that version is already installed with nothing pending, the existing install is returned.
+      # Creates an app install. An account installs its own private app with its own key; public and testing installs are made from the Dashboard. An app developer acting on a connected account through Stripe-Account installs or reinstalls its app there, and an embedding platform can do the same once the app's developer approves its request to embed the app and the platform has accepted the Embedding Platform Terms and Conditions in the Dashboard. For a private app, creating an install installs the newest completed upload; when that version is already installed with nothing pending, the existing install is returned.
       def create(params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/tax/certificate_service.rb

@@ -0,0 +1,52 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    class CertificateService < StripeService
+      # Create a tax certificate associated with a tax exemption.
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/tax/certificates",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Delete a tax certificate associated with a tax exemption.
+      def delete(id, params = {}, opts = {})
+        request(
+          method: :delete,
+          path: format("/v1/tax/certificates/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # List certificates for an existing tax exemption.
+      def list(params = {}, opts = {})
+        request(
+          method: :get,
+          path: "/v1/tax/certificates",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieve a tax certificate associated with a tax exemption.
+      def retrieve(id, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/tax/certificates/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/tax/form_service.rb

@@ -4,6 +4,17 @@
 module Stripe
   module Tax
     class FormService < StripeService
+      # Creates a correction for a filed tax form. Supply either payee details or numerical values for the tax form type. Created correction forms are not filed automatically.
+      def create(id, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/tax/forms/%<id>s/corrections", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
       # Returns a list of tax forms which were previously created. The tax forms are returned in sorted order, with the oldest tax forms appearing first.
       def list(params = {}, opts = {})
         request(method: :get, path: "/v1/tax/forms", params: params, opts: opts, base_address: :api)

data/lib/stripe/services/tax_service.rb

@@ -3,12 +3,13 @@
 
 module Stripe
   class TaxService < StripeService
-    attr_reader :associations, :calculations, :forms, :locations, :registrations, :settings, :transactions
+    attr_reader :associations, :calculations, :certificates, :forms, :locations, :registrations, :settings, :transactions
 
     def initialize(requestor)
       super
       @associations = Stripe::Tax::AssociationService.new(@requestor)
       @calculations = Stripe::Tax::CalculationService.new(@requestor)
+      @certificates = Stripe::Tax::CertificateService.new(@requestor)
       @forms = Stripe::Tax::FormService.new(@requestor)
       @locations = Stripe::Tax::LocationService.new(@requestor)
       @registrations = Stripe::Tax::RegistrationService.new(@requestor)

data/lib/stripe/services/v2/extend/object_definition_service.rb

@@ -0,0 +1,39 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Extend
+      class ObjectDefinitionService < StripeService
+        attr_reader :versions
+
+        def initialize(requestor)
+          super
+          @versions = Stripe::V2::Extend::ObjectDefinitions::VersionService.new(@requestor)
+        end
+
+        # Lists a page of object definitions.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/extend/object_definitions",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves an object definition.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/extend/object_definitions/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/extend/object_definitions/version_service.rb

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Extend
+      module ObjectDefinitions
+        class VersionService < StripeService
+          # Lists a page of object definition versions in descending semantic version order.
+          def list(object_definition_id, params = {}, opts = {})
+            request(
+              method: :get,
+              path: format("/v2/extend/object_definitions/%<object_definition_id>s/versions", { object_definition_id: CGI.escape(object_definition_id) }),
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+
+          # Retrieves an object definition version.
+          def retrieve(object_definition_id, id, params = {}, opts = {})
+            request(
+              method: :get,
+              path: format("/v2/extend/object_definitions/%<object_definition_id>s/versions/%<id>s", { object_definition_id: CGI.escape(object_definition_id), id: CGI.escape(id) }),
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/extend_service.rb

@@ -4,10 +4,11 @@
 module Stripe
   module V2
     class ExtendService < StripeService
-      attr_reader :workflows, :workflow_runs
+      attr_reader :object_definitions, :workflows, :workflow_runs
 
       def initialize(requestor)
         super
+        @object_definitions = Stripe::V2::Extend::ObjectDefinitionService.new(@requestor)
         @workflows = Stripe::V2::Extend::WorkflowService.new(@requestor)
         @workflow_runs = Stripe::V2::Extend::WorkflowRunService.new(@requestor)
       end

data/lib/stripe/services.rb

@@ -279,6 +279,7 @@ module Stripe
     autoload :AssociationService, "stripe/services/tax/association_service"
     autoload :CalculationLineItemService, "stripe/services/tax/calculation_line_item_service"
     autoload :CalculationService, "stripe/services/tax/calculation_service"
+    autoload :CertificateService, "stripe/services/tax/certificate_service"
     autoload :FormService, "stripe/services/tax/form_service"
     autoload :LocationService, "stripe/services/tax/location_service"
     autoload :RegistrationService, "stripe/services/tax/registration_service"
@@ -505,8 +506,13 @@ module Stripe
     end
 
     module Extend
+      autoload :ObjectDefinitionService, "stripe/services/v2/extend/object_definition_service"
       autoload :WorkflowRunService, "stripe/services/v2/extend/workflow_run_service"
       autoload :WorkflowService, "stripe/services/v2/extend/workflow_service"
+
+      module ObjectDefinitions
+        autoload :VersionService, "stripe/services/v2/extend/object_definitions/version_service"
+      end
     end
 
     module Iam
@@ -813,6 +819,7 @@ module Stripe
     stripe/services/tax/association_service
     stripe/services/tax/calculation_line_item_service
     stripe/services/tax/calculation_service
+    stripe/services/tax/certificate_service
     stripe/services/tax/form_service
     stripe/services/tax/location_service
     stripe/services/tax/registration_service
@@ -945,6 +952,8 @@ module Stripe
     stripe/services/v2/data/reporting_service
     stripe/services/v2/data/schema_service
     stripe/services/v2/data_service
+    stripe/services/v2/extend/object_definition_service
+    stripe/services/v2/extend/object_definitions/version_service
     stripe/services/v2/extend/workflow_run_service
     stripe/services/v2/extend/workflow_service
     stripe/services/v2/extend_service

data/lib/stripe/stripe_event_notification_handler.rb

@@ -1746,6 +1746,14 @@ module Stripe
       register("v2.extend.extension_run.failed", &callback)
     end
 
+    def on_v2_extend_object_definition_created(&callback)
+      register("v2.extend.object_definition.created", &callback)
+    end
+
+    def on_v2_extend_object_definition_version_created(&callback)
+      register("v2.extend.object_definition_version.created", &callback)
+    end
+
     def on_v2_extend_workflow_run_failed(&callback)
       register("v2.extend.workflow_run.failed", &callback)
     end

data/lib/stripe/stripe_service.rb

@@ -10,15 +10,6 @@ module Stripe
 
     def request(method:, path:, base_address:, params: {}, opts: {})
       params = params.to_h if params.is_a?(RequestParams)
-      if method == :post &&
-         path.split("?", 2).first.start_with?("/v2/") &&
-         path.split("?", 2).first.end_with?("/search") &&
-         (params.key?(:limit) || params.key?("limit"))
-        params = params.dup
-        limit = params.delete(:limit) || params.delete("limit")
-        separator = path.include?("?") ? "&" : "?"
-        path = "#{path}#{separator}limit=#{URI.encode_www_form_component(limit)}"
-      end
       @requestor.execute_request(
         method,
         path,
@@ -29,6 +20,19 @@ module Stripe
       )
     end
 
+    # V2 search uses POST but sends limit in the URL, not the JSON body. Rebuild
+    # the initial query from params; pagination uses the ordinary request path.
+    def request_v2_search(method:, path:, base_address:, params: {}, opts: {})
+      params = params.to_h if params.is_a?(RequestParams)
+      params = params.dup
+      limit = params.delete(:limit)
+      string_limit = params.delete("limit")
+      limit ||= string_limit
+      path = path.split("?", 2).first
+      path = "#{path}?limit=#{URI.encode_www_form_component(limit)}" unless limit.nil?
+      request(method: method, path: path, base_address: base_address, params: params, opts: opts)
+    end
+
     def request_stream(method:, path:, base_address:, params: {}, opts: {}, &read_body_chunk_block)
       @requestor.execute_request_stream(
         method,

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "20.2.0-alpha.1"
+  VERSION = "20.2.0-alpha.2"
 end

data/lib/stripe/webhook.rb

@@ -44,7 +44,13 @@ module Stripe
     private_class_method :_build_v1_event
 
     def self._maybe_extract_from_cloud_provider_envelope(payload)
-      payload = payload.encode("utf-8") if payload.respond_to?(:encode)
+      if payload.respond_to?(:encode)
+        payload = if payload.encoding == Encoding::BINARY
+                    payload.dup.force_encoding(Encoding::UTF_8)
+                  else
+                    payload.encode(Encoding::UTF_8)
+                  end
+      end
       data = JSON.parse(payload, symbolize_names: true)
 
       # Could add as many checks as we want here, but we'll start simple

data/lib/stripe/workload_identity_exchange.rb

@@ -16,7 +16,7 @@ module Stripe
     TOKEN_PATH = "/wif/oauth2/token"
     TOKEN_URL = "https://#{TOKEN_HOST}#{TOKEN_PATH}".freeze
 
-    SUPPORTED_PROVIDERS = ["gcp"].freeze
+    SUPPORTED_PROVIDERS = %w[gcp aws].freeze
 
     # The exchange endpoint is fixed and deliberately independent of any
     # configurable `api_base`, so a misconfigured or malicious API base can
@@ -28,7 +28,7 @@ module Stripe
 
     # Number of seconds before actual expiry that a cached token is
     # considered stale and eligible for proactive refresh.
-    REFRESH_SAFETY_MARGIN_SEC = 300
+    REFRESH_SAFETY_MARGIN_SEC = 120
 
     def self.validate_provider!(identity_provider)
       unless identity_provider.respond_to?(:provider) && identity_provider.respond_to?(:identity_assertion)