stripe 19.2.0 → 19.3.0.pre.beta.1

data/lib/stripe/stripe_configuration.rb

@@ -25,7 +25,8 @@ module Stripe
   # If `.logger` is set, the value of `.log_level` is ignored. The decision on
   # what levels to print is entirely deferred to the logger.
   class StripeConfiguration
-    attr_accessor :api_key, :api_version, :client_id, :enable_telemetry, :logger, :stripe_account, :stripe_context
+    attr_accessor :api_key, :api_version, :authenticator, :client_id, :enable_telemetry, :logger,
+                  :stripe_account, :stripe_context
 
     attr_reader :api_base, :uploads_base, :connect_base, :meter_events_base, :base_addresses, :ca_bundle_path,
                 :log_level, :initial_network_retry_delay, :max_network_retries, :max_network_retry_delay,
@@ -66,6 +67,7 @@ module Stripe
 
     def initialize
       @api_version = ApiVersion::CURRENT
+
       @ca_bundle_path = Stripe::DEFAULT_CA_BUNDLE_PATH
       @enable_telemetry = true
       @verify_ssl_certs = true

data/lib/stripe/stripe_event_notification_handler.rb

@@ -0,0 +1,582 @@
+# File copied from our code generator; changes here will be overwritten.
+# frozen_string_literal: true
+
+module Stripe
+  class UnhandledNotificationDetails
+    attr_reader :is_known_event_type
+
+    def initialize(is_known_event_type)
+      @is_known_event_type = is_known_event_type
+    end
+  end
+
+  class StripeEventNotificationHandler
+    def initialize(client, webhook_secret, &fallback_callback)
+      raise ArgumentError, "You must pass a block to act as a fallback" if fallback_callback.nil?
+
+      @client = client
+      @webhook_secret = webhook_secret
+      @fallback_callback = fallback_callback
+
+      @registered_handlers = {}
+      @has_handled_events = false
+    end
+
+    def handle(webhook_body, sig_header)
+      # we're ok with this not being a thread-safe write since registering
+      # handlers should happen synchronously on startup before any multi-threaded reads happen
+      @has_handled_events = true
+
+      notif = @client.parse_event_notification(
+        webhook_body,
+        sig_header,
+        @webhook_secret
+      )
+
+      # Create a new client with the event's context to ensure thread-safety
+      event_client = new_client_with_context(notif.context)
+
+      handler = @registered_handlers[notif.type]
+      if handler
+        handler.call(notif, event_client)
+      else
+        @fallback_callback.call(notif, event_client,
+                                UnhandledNotificationDetails.new(!notif.is_a?(Stripe::Events::UnknownEventNotification)))
+      end
+    end
+
+    def registered_event_types
+      @registered_handlers.keys.sort
+    end
+
+    private def register(event_type, &handler)
+      raise "Cannot register new event handlers after handling events" if @has_handled_events
+      if @registered_handlers.key?(event_type)
+        raise ArgumentError, "Handler already registered for event type: #{event_type}"
+      end
+
+      @registered_handlers[event_type] = handler
+    end
+
+    private def new_client_with_context(context)
+      config = @client.requestor.config
+      StripeClient.new(
+        config.api_key,
+        stripe_account: config.stripe_account,
+        stripe_context: context,
+        stripe_version: config.api_version,
+        api_base: config.api_base,
+        uploads_base: config.uploads_base,
+        connect_base: config.connect_base,
+        meter_events_base: config.meter_events_base,
+        client_id: config.client_id
+      )
+    end
+
+    # event-handler-methods: The beginning of the section generated from our OpenAPI spec
+    def on_v1_billing_meter_error_report_triggered(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v1.billing.meter.error_report_triggered", &handler)
+    end
+
+    def on_v1_billing_meter_no_meter_found(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v1.billing.meter.no_meter_found", &handler)
+    end
+
+    def on_v2_commerce_product_catalog_imports_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.commerce.product_catalog.imports.failed", &handler)
+    end
+
+    def on_v2_commerce_product_catalog_imports_processing(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.commerce.product_catalog.imports.processing", &handler)
+    end
+
+    def on_v2_commerce_product_catalog_imports_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.commerce.product_catalog.imports.succeeded", &handler)
+    end
+
+    def on_v2_commerce_product_catalog_imports_succeeded_with_errors(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.commerce.product_catalog.imports.succeeded_with_errors", &handler)
+    end
+
+    def on_v2_core_account_closed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account.closed", &handler)
+    end
+
+    def on_v2_core_account_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account.created", &handler)
+    end
+
+    def on_v2_core_account_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account.updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_customer_capability_status_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.customer].capability_status_updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_customer_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.customer].updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_merchant_capability_status_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.merchant].capability_status_updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_merchant_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.merchant].updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_recipient_capability_status_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.recipient].capability_status_updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_recipient_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.recipient].updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_storer_capability_status_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.storer].capability_status_updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_storer_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.storer].updated", &handler)
+    end
+
+    def on_v2_core_account_including_defaults_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[defaults].updated", &handler)
+    end
+
+    def on_v2_core_account_including_future_requirements_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[future_requirements].updated", &handler)
+    end
+
+    def on_v2_core_account_including_identity_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[identity].updated", &handler)
+    end
+
+    def on_v2_core_account_including_requirements_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[requirements].updated", &handler)
+    end
+
+    def on_v2_core_account_link_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account_link.returned", &handler)
+    end
+
+    def on_v2_core_account_person_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account_person.created", &handler)
+    end
+
+    def on_v2_core_account_person_deleted(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account_person.deleted", &handler)
+    end
+
+    def on_v2_core_account_person_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account_person.updated", &handler)
+    end
+
+    def on_v2_core_batch_job_batch_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.batch_failed", &handler)
+    end
+
+    def on_v2_core_batch_job_canceled(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.canceled", &handler)
+    end
+
+    def on_v2_core_batch_job_completed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.completed", &handler)
+    end
+
+    def on_v2_core_batch_job_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.created", &handler)
+    end
+
+    def on_v2_core_batch_job_ready_for_upload(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.ready_for_upload", &handler)
+    end
+
+    def on_v2_core_batch_job_timeout(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.timeout", &handler)
+    end
+
+    def on_v2_core_batch_job_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.updated", &handler)
+    end
+
+    def on_v2_core_batch_job_upload_timeout(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.upload_timeout", &handler)
+    end
+
+    def on_v2_core_batch_job_validating(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.validating", &handler)
+    end
+
+    def on_v2_core_batch_job_validation_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.batch_job.validation_failed", &handler)
+    end
+
+    def on_v2_core_event_destination_ping(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.event_destination.ping", &handler)
+    end
+
+    def on_v2_core_health_event_generation_failure_resolved(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.health.event_generation_failure.resolved", &handler)
+    end
+
+    def on_v2_data_reporting_query_run_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.data.reporting.query_run.created", &handler)
+    end
+
+    def on_v2_data_reporting_query_run_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.data.reporting.query_run.failed", &handler)
+    end
+
+    def on_v2_data_reporting_query_run_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.data.reporting.query_run.succeeded", &handler)
+    end
+
+    def on_v2_data_reporting_query_run_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.data.reporting.query_run.updated", &handler)
+    end
+
+    def on_v2_extend_workflow_run_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.extend.workflow_run.failed", &handler)
+    end
+
+    def on_v2_extend_workflow_run_started(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.extend.workflow_run.started", &handler)
+    end
+
+    def on_v2_extend_workflow_run_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.extend.workflow_run.succeeded", &handler)
+    end
+
+    def on_v2_money_management_adjustment_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.adjustment.created", &handler)
+    end
+
+    def on_v2_money_management_financial_account_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.financial_account.created", &handler)
+    end
+
+    def on_v2_money_management_financial_account_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.financial_account.updated", &handler)
+    end
+
+    def on_v2_money_management_financial_address_activated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.financial_address.activated", &handler)
+    end
+
+    def on_v2_money_management_financial_address_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.financial_address.failed", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_available(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.available", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_failed", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_processing(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_processing", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_queued(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_queued", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_returned", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_succeeded", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_canceled(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.canceled", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.created", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.failed", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_posted(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.posted", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.returned", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.updated", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_canceled(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.canceled", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.created", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.failed", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_posted(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.posted", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.returned", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.updated", &handler)
+    end
+
+    def on_v2_money_management_payout_method_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.payout_method.created", &handler)
+    end
+
+    def on_v2_money_management_payout_method_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.payout_method.updated", &handler)
+    end
+
+    def on_v2_money_management_received_credit_available(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_credit.available", &handler)
+    end
+
+    def on_v2_money_management_received_credit_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_credit.failed", &handler)
+    end
+
+    def on_v2_money_management_received_credit_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_credit.returned", &handler)
+    end
+
+    def on_v2_money_management_received_credit_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_credit.succeeded", &handler)
+    end
+
+    def on_v2_money_management_received_debit_canceled(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.canceled", &handler)
+    end
+
+    def on_v2_money_management_received_debit_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.failed", &handler)
+    end
+
+    def on_v2_money_management_received_debit_pending(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.pending", &handler)
+    end
+
+    def on_v2_money_management_received_debit_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.succeeded", &handler)
+    end
+
+    def on_v2_money_management_received_debit_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.updated", &handler)
+    end
+
+    def on_v2_money_management_transaction_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.transaction.created", &handler)
+    end
+
+    def on_v2_money_management_transaction_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.transaction.updated", &handler)
+    end
+
+    def on_v2_orchestrated_commerce_agreement_confirmed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.orchestrated_commerce.agreement.confirmed", &handler)
+    end
+
+    def on_v2_orchestrated_commerce_agreement_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.orchestrated_commerce.agreement.created", &handler)
+    end
+
+    def on_v2_orchestrated_commerce_agreement_partially_confirmed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.orchestrated_commerce.agreement.partially_confirmed", &handler)
+    end
+
+    def on_v2_orchestrated_commerce_agreement_terminated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.orchestrated_commerce.agreement.terminated", &handler)
+    end
+    # event-handler-methods: The end of the section generated from our OpenAPI spec
+  end
+end

data/lib/stripe/stripe_object.rb

@@ -369,7 +369,7 @@ module Stripe
       end
     end
 
-    protected def add_accessors(keys, values) # rubocop:todo Metrics/PerceivedComplexity
+    protected def add_accessors(keys, values)
       # not available in the #instance_eval below
       protected_fields = self.class.protected_fields
 

data/lib/stripe/util.rb

@@ -314,7 +314,13 @@ module Stripe
       when String
         { api_key: opts }
       when Hash
-        check_api_key!(opts.fetch(:api_key)) if opts.key?(:api_key)
+        # If the user is using request signing for authentication,
+        # no need to check the api_key per request.
+        if !(opts.key?(:client) &&
+           opts.fetch(:client).config.authenticator) &&
+           opts.key?(:api_key)
+          check_api_key!(opts.fetch(:api_key))
+        end
         # Explicitly use dup here instead of clone to avoid preserving freeze
         # state on input params.
         opts.dup

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "19.2.0"
+  VERSION = "19.3.0-beta.1"
 end