stripe 10.3.0.pre.beta.1 → 10.4.0.pre.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99e6b9749e8b1212d2c4b42f40c49b220ea10132346b5c8a4eb96894bc06247f
-  data.tar.gz: 76680576e92e252db64df9543df2b1befde7dd1bff4c2d4d74fe946af068a60c
+  metadata.gz: f7b70ab060653606fcb0aed81e4323829c6fd49c574ab49c67f2381acbe4d656
+  data.tar.gz: 903c2861ff74cf39b2615a41d490b1cbe854973064ffeb92344d4e48380f66f6
 SHA512:
-  metadata.gz: c65eb672e988647ccb5844d722f57cb82d6d7ac2da7e4ee095678104ae8f2a04c2e2bb65abf34aecfcf235838b18cb4a93f6cd3b7d96075f2e4d8a7308b57efc
-  data.tar.gz: 8225c92b8ee117d57a968bbe13b2f9edc274ffae4fd3fd669a749a1e34a9efa1f34965db93ac435d7f8026ed5a1c40fc373b487e80a30be36a5eb0f2728037b0
+  metadata.gz: 9b374960111dda05764ef8df8b03a11168c69691657258785db4615f99123f2ff7dd449e2b2b7192a32046e1560ce83f2e6d5040638041900c0f0360e80d9074
+  data.tar.gz: dd1b8cd4032de2f537131ee94d6959d36a8043ad723d1924d42ff5051f6f5517c2d0e1ef769aad17cc0774e19432d28b5000058c8782c69a6343d48d0cbb5dba

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 10.4.0-beta.1 - 2023-12-14
+ Updated stable APIs to the latest version
+
+## 10.3.0 - 2023-12-14
+* [#1294](https://github.com/stripe/stripe-ruby/pull/1294) Support sending parameters inside singleton retrieve
+
 ## 10.3.0-beta.1 - 2023-11-30
 * [#1298](https://github.com/stripe/stripe-ruby/pull/1298) Update generated code for beta
 * [#1296](https://github.com/stripe/stripe-ruby/pull/1296) Merge master into beta

data/Makefile

@@ -5,7 +5,7 @@ update-version:
 
 codegen-format:
 	bundle install --quiet
-	bundle exec rubocop -o /dev/null --auto-correct
+	bundle exec rubocop -o /dev/null --autocorrect
 
 ci-test:
 	bundle install && bundle exec rake test

data/OPENAPI_VERSION

@@ -1 +1 @@
-v691
+v715

data/README.md

@@ -291,10 +291,11 @@ Stripe.set_app_info('MyAwesomePlugin', version: '1.2.34', url: 'https://myawesom
 This information is passed along when the library makes calls to the Stripe
 API.
 
-### Request latency telemetry
+### Telemetry
 
-By default, the library sends request latency telemetry to Stripe. These
-numbers help Stripe improve the overall latency of its API for all users.
+By default, the library sends telemetry to Stripe regarding request latency and feature usage. These
+numbers help Stripe improve the overall latency of its API for all users, and
+improve popular features.
 
 You can disable this behavior if you prefer:
 

data/VERSION

@@ -1 +1 @@
-10.3.0-beta.1
+10.4.0-beta.1

data/lib/stripe/api_operations/request.rb

@@ -5,14 +5,14 @@ module Stripe
     module Request
       module ClassMethods
         def execute_resource_request(method, url,
-                                     params = {}, opts = {})
+                                     params = {}, opts = {}, usage = [])
           execute_resource_request_internal(
-            :execute_request, method, url, params, opts
+            :execute_request, method, url, params, opts, usage
           )
         end
 
         def execute_resource_request_stream(method, url,
-                                            params = {}, opts = {},
+                                            params = {}, opts = {}, usage = [],
                                             &read_body_chunk_block)
           execute_resource_request_internal(
             :execute_request_stream,
@@ -20,18 +20,19 @@ module Stripe
             url,
             params,
             opts,
+            usage,
             &read_body_chunk_block
           )
         end
 
-        private def request_stripe_object(method:, path:, params:, opts: {})
-          resp, opts = execute_resource_request(method, path, params, opts)
+        private def request_stripe_object(method:, path:, params:, opts: {}, usage: [])
+          resp, opts = execute_resource_request(method, path, params, opts, usage)
           Util.convert_to_stripe_object_with_params(resp.data, params, opts)
         end
 
         private def execute_resource_request_internal(client_request_method_sym,
                                                       method, url,
-                                                      params, opts,
+                                                      params, opts, usage,
                                                       &read_body_chunk_block)
           params ||= {}
 
@@ -54,8 +55,7 @@ module Stripe
             client_request_method_sym,
             method, url,
             api_base: api_base, api_key: api_key,
-            headers: headers, params: params,
-            api_mode: api_mode,
+            headers: headers, params: params, usage: usage, api_mode: api_mode,
             &read_body_chunk_block
           )
 
@@ -68,6 +68,7 @@ module Stripe
           [resp, opts_to_persist]
         end
 
+        # TODO: (major)
         # This method used to be called `request`, but it's such a short name
         # that it eventually conflicted with the name of a field on an API
         # resource (specifically, `Event#request`), so it was renamed to
@@ -113,9 +114,9 @@ module Stripe
       end
 
       protected def execute_resource_request(method, url,
-                                             params = {}, opts = {})
+                                             params = {}, opts = {}, usage = [])
         opts = @opts.merge(Util.normalize_opts(opts))
-        self.class.execute_resource_request(method, url, params, opts)
+        self.class.execute_resource_request(method, url, params, opts, usage)
       end
 
       protected def execute_resource_request_stream(method, url,
@@ -127,8 +128,8 @@ module Stripe
         )
       end
 
-      private def request_stripe_object(method:, path:, params:, opts: {})
-        resp, opts = execute_resource_request(method, path, params, opts)
+      private def request_stripe_object(method:, path:, params:, opts: {}, usage: [])
+        resp, opts = execute_resource_request(method, path, params, opts, usage)
         Util.convert_to_stripe_object_with_params(resp.data, params, opts)
       end
 

data/lib/stripe/api_operations/save.rb

@@ -66,7 +66,7 @@ module Stripe
         # generated a uri for this object with an identifier baked in
         values.delete(:id)
 
-        resp, opts = execute_resource_request(:post, save_url, values, opts)
+        resp, opts = execute_resource_request(:post, save_url, values, opts, ["save"])
         initialize_from(resp.data, opts)
       end
       extend Gem::Deprecate

data/lib/stripe/api_version.rb

@@ -4,6 +4,6 @@
 module Stripe
   module ApiVersion
     CURRENT = "2023-10-16"
-    PREVIEW = "2023-10-26.preview-v2"
+    PREVIEW = "2023-12-11.preview-v2"
   end
 end

data/lib/stripe/singleton_api_resource.rb

@@ -17,8 +17,25 @@ module Stripe
       self.class.resource_url
     end
 
-    def self.retrieve(opts = {})
-      instance = new(nil, Util.normalize_opts(opts))
+    def self.retrieve(params_or_opts = {}, definitely_opts = nil)
+      opts = nil
+      params = nil
+      if definitely_opts.nil?
+        unrecognized_key = params_or_opts.keys.find { |k| !Util::OPTS_USER_SPECIFIED.include?(k) }
+        if unrecognized_key
+          raise ArgumentError,
+                "Unrecognized request option: #{unrecognized_key}. Did you mean to specify this as retrieve params? " \
+                "If so, you must explicitly pass an opts hash as a second argument. " \
+                "For example: .retrieve({#{unrecognized_key}: 'foo'}, {})"
+        end
+
+        opts = params_or_opts
+      else
+        opts = definitely_opts
+        params = params_or_opts
+      end
+
+      instance = new(params, Util.normalize_opts(opts))
       instance.refresh
       instance
     end

data/lib/stripe/stripe_client.rb

@@ -210,9 +210,9 @@ module Stripe
 
     def execute_request(method, path,
                         api_base: nil, api_key: nil,
-                        headers: {}, params: {}, api_mode: nil)
+                        headers: {}, params: {}, api_mode: nil, usage: [])
       http_resp, api_key = execute_request_internal(
-        method, path, api_base, api_key, headers, params, api_mode
+        method, path, api_base, api_key, headers, params, api_mode, usage
       )
 
       begin
@@ -241,7 +241,7 @@ module Stripe
     # passed, then a StripeStreamResponse is returned containing an IO stream
     # with the response body.
     def execute_request_stream(method, path,
-                               api_base: nil, api_key: nil,
+                               api_base: nil, api_key: nil, usage: [],
                                headers: {}, params: {},
                                api_mode: nil,
                                &read_body_chunk_block)
@@ -252,7 +252,7 @@ module Stripe
 
       http_resp, api_key = execute_request_internal(
         method, path, api_base, api_key,
-        headers, params, api_mode, &read_body_chunk_block
+        headers, params, api_mode, usage, &read_body_chunk_block
       )
 
       # When the read_body_chunk_block is given, we no longer have access to the
@@ -432,7 +432,7 @@ module Stripe
 
     private def execute_request_internal(method, path,
                                          api_base, api_key, headers, params,
-                                         api_mode, &read_body_chunk_block)
+                                         api_mode, usage, &read_body_chunk_block)
       raise ArgumentError, "method should be a symbol" \
       unless method.is_a?(Symbol)
       raise ArgumentError, "path should be a string" \
@@ -498,7 +498,7 @@ module Stripe
         end
 
       http_resp =
-        execute_request_with_rescues(method, api_base, headers, context) do
+        execute_request_with_rescues(method, api_base, headers, usage, context) do
           self.class
               .default_connection_manager(config)
               .execute_request(method, url,
@@ -583,7 +583,7 @@ module Stripe
       http_status >= 400
     end
 
-    private def execute_request_with_rescues(method, api_base, headers, context)
+    private def execute_request_with_rescues(method, api_base, headers, usage, context)
       num_retries = 0
 
       begin
@@ -609,7 +609,7 @@ module Stripe
         if config.enable_telemetry? && context.request_id
           request_duration_ms = (request_duration * 1000).to_i
           @last_request_metrics =
-            StripeRequestMetrics.new(context.request_id, request_duration_ms)
+            StripeRequestMetrics.new(context.request_id, request_duration_ms, usage: usage)
         end
 
       # We rescue all exceptions from a request so that we have an easy spot to
@@ -1072,13 +1072,19 @@ module Stripe
       # Request duration in milliseconds
       attr_accessor :request_duration_ms
 
-      def initialize(request_id, request_duration_ms)
+      # list of names of tracked behaviors associated with this request
+      attr_accessor :usage
+
+      def initialize(request_id, request_duration_ms, usage: [])
         self.request_id = request_id
         self.request_duration_ms = request_duration_ms
+        self.usage = usage
       end
 
       def payload
-        { request_id: request_id, request_duration_ms: request_duration_ms }
+        ret = { request_id: request_id, request_duration_ms: request_duration_ms }
+        ret[:usage] = usage if !usage.nil? && !usage.empty?
+        ret
       end
     end
   end

data/lib/stripe/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 10.3.0.pre.beta.1
+  version: 10.4.0.pre.beta.1
 platform: ruby
 authors:
 - Stripe
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-30 00:00:00.000000000 Z
+date: 2023-12-15 00:00:00.000000000 Z
 dependencies: []
 description: Stripe is the easiest way to accept payments online.  See https://stripe.com
   for details.