stripe 10.14.0 → 10.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e005b6f71d3104349ec84fd1828b46bd94131b49a746233231654a682da91a1
-  data.tar.gz: c04f1e21e02e4a615a6477cddd1dc11130998ffcc90d2afc66ad73131e435cfa
+  metadata.gz: 2c6299b4afca3ee89da389e6dc45eee600eba9f3dfa66fa7120826e4dc9ce006
+  data.tar.gz: 66073d85adc239428168012cc7585401347ea5ac4384ec910e13aa49c2d44dcb
 SHA512:
-  metadata.gz: 8f56042df34d499b9fb85a4e8fba37a9a048cc9830caad148442fd629d34c943c5c5ea425e066007625a6bb8124de7cd53223a511d09fd495bba068038b2375d
-  data.tar.gz: 175595f2208cfdb6c952d4b163e2e86121e0bd0fe1afc0164368f5cbf72e471a46a0ff721274c1e1fd8de329c71f91029790573a99a4b94a782b22be16fa585e
+  metadata.gz: 8535cb9457a19a0acbf7d3faf0e77efc0b457f36c30adc80196b53d771db7f7170da9517f9f0cbb656ed6701411f34ba981f64e2f5f7256e67f66662d7e3f57a
+  data.tar.gz: 1a8732f5540d740710a136fbe0a3c29f56b6d4ed904411fcec573aa30901d38a84830795c0f03aee4dc6e670fa35ed189c230c361f3e9776b9912af9af7c7892

data/CHANGELOG.md

@@ -1,4 +1,13 @@
 # Changelog
+## 10.15.0 - 2024-04-09
+* [#1377](https://github.com/stripe/stripe-ruby/pull/1377) Add last_response to StripeObject
+  * Users can now retrieve raw response from the returned resource, using the `last_response` property. See [README](https://github.com/stripe/stripe-ruby/blob/master/README.md) for an example.
+* [#1372](https://github.com/stripe/stripe-ruby/pull/1372) Update generated code
+  * Add support for new resources `Entitlements.ActiveEntitlement` and `Entitlements.Feature`
+  * Add support for `list` and `retrieve` methods on resource `ActiveEntitlement`
+  * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `Feature`
+* [#1366](https://github.com/stripe/stripe-ruby/pull/1366) Move executables to `exe` folder
+
 ## 10.14.0 - 2024-03-28
 * [#1369](https://github.com/stripe/stripe-ruby/pull/1369) Update generated code
   * Add support for new resources `Billing.MeterEventAdjustment`, `Billing.MeterEvent`, and `Billing.Meter`

data/OPENAPI_VERSION

@@ -1 +1 @@
-v908
+v938

data/README.md

@@ -150,15 +150,13 @@ puts customer.unknown # raises NoMethodError
 
 ### Accessing a response object
 
-Get access to response objects by initializing a client and using its `request`
-method:
+Get access to response objects by using the `last_response` property of the returned resource:
 
 ```ruby
-client = Stripe::StripeClient.new
-customer, resp = client.request do
-  Stripe::Customer.retrieve('cus_123456789',)
-end
-puts resp.request_id
+customer = Stripe::Customer.retrieve('cus_123456789')
+
+print(customer.last_response.http_status) # to retrieve status code
+print(customer.last_response.http_headers) # to retrieve headers
 ```
 
 ### Configuring a proxy

data/VERSION

@@ -1 +1 @@
-10.14.0
+10.15.0

data/lib/stripe/api_operations/request.rb

@@ -27,7 +27,7 @@ module Stripe
 
         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)
+          Util.convert_to_stripe_object_with_params(resp.data, params, opts, resp)
         end
 
         private def execute_resource_request_internal(client_request_method_sym,
@@ -129,7 +129,7 @@ module Stripe
 
       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)
+        Util.convert_to_stripe_object_with_params(resp.data, params, opts, resp)
       end
 
       # See notes on `alias` above.

data/lib/stripe/api_operations/save.rb

@@ -67,7 +67,7 @@ module Stripe
         values.delete(:id)
 
         resp, opts = execute_resource_request(:post, save_url, values, opts, ["save"])
-        initialize_from(resp.data, opts)
+        initialize_from(resp.data, opts, resp)
       end
       extend Gem::Deprecate
       deprecate :save, "the `update` class method (for examples " \

data/lib/stripe/api_operations/singleton_save.rb

@@ -62,7 +62,7 @@ module Stripe
         values = serialize_params(self).merge(params)
 
         resp, opts = execute_resource_request(:post, resource_url, values, opts, ["save"])
-        initialize_from(resp.data, opts)
+        initialize_from(resp.data, opts, resp)
       end
       extend Gem::Deprecate
       deprecate :save, "the `update` class method (for examples " \

data/lib/stripe/api_resource.rb

@@ -89,7 +89,7 @@ module Stripe
     def refresh
       resp, opts = execute_resource_request(:get, resource_url,
                                             @retrieve_params)
-      initialize_from(resp.data, opts)
+      initialize_from(resp.data, opts, resp)
     end
 
     def self.retrieve(id, opts = {})
@@ -104,9 +104,9 @@ module Stripe
 
       # If we're getting back this thing, update; otherwise, instantiate.
       if Util.object_name_matches_class?(resp.data[:object], self.class)
-        initialize_from(resp.data, opts)
+        initialize_from(resp.data, opts, resp)
       else
-        Util.convert_to_stripe_object_with_params(resp.data, params, opts)
+        Util.convert_to_stripe_object_with_params(resp.data, params, opts, resp)
       end
     end
 

data/lib/stripe/object_types.rb

@@ -48,6 +48,8 @@ module Stripe
         CustomerSession.object_name => CustomerSession,
         Discount.object_name => Discount,
         Dispute.object_name => Dispute,
+        Entitlements::ActiveEntitlement.object_name => Entitlements::ActiveEntitlement,
+        Entitlements::Feature.object_name => Entitlements::Feature,
         EphemeralKey.object_name => EphemeralKey,
         Event.object_name => Event,
         ExchangeRate.object_name => ExchangeRate,
@@ -86,6 +88,7 @@ module Stripe
         Plan.object_name => Plan,
         Price.object_name => Price,
         Product.object_name => Product,
+        ProductFeature.object_name => ProductFeature,
         PromotionCode.object_name => PromotionCode,
         Quote.object_name => Quote,
         Radar::EarlyFraudWarning.object_name => Radar::EarlyFraudWarning,

data/lib/stripe/resources/entitlements/active_entitlement.rb

@@ -0,0 +1,26 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Entitlements
+    # An active entitlement describes access to a feature for a customer.
+    class ActiveEntitlement < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "entitlements.active_entitlement"
+      def self.object_name
+        "entitlements.active_entitlement"
+      end
+
+      # Retrieve a list of active entitlements for a customer
+      def self.list(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/entitlements/active_entitlements",
+          params: filters,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/entitlements/feature.rb

@@ -0,0 +1,49 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Entitlements
+    # A feature represents a monetizable ability or functionality in your system.
+    # Features can be assigned to products, and when those products are purchased, Stripe will create an entitlement to the feature for the purchasing customer.
+    class Feature < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "entitlements.feature"
+      def self.object_name
+        "entitlements.feature"
+      end
+
+      # Creates a feature
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/entitlements/features",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Retrieve a list of features
+      def self.list(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/entitlements/features",
+          params: filters,
+          opts: opts
+        )
+      end
+
+      # Update a feature's metadata or permanently deactivate it.
+      def self.update(id, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/entitlements/features/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts
+        )
+      end
+    end
+  end
+end

data/lib/stripe/resources/invoice.rb

@@ -182,7 +182,7 @@ module Stripe
     #
     # Note that when you are viewing an upcoming invoice, you are simply viewing a preview – the invoice has not yet been created. As such, the upcoming invoice will not show up in invoice listing calls, and you cannot use the API to pay or edit the invoice. If you want to change the amount that your customer will be billed, you can add, remove, or update pending invoice items, or update the customer's discount.
     #
-    # You can preview the effects of updating a subscription, including a preview of what proration will take place. To ensure that the actual proration is calculated exactly the same as the previewed proration, you should pass a proration_date parameter when doing the actual subscription update. The value passed in should be the same as the subscription_proration_date returned on the upcoming invoice resource. The recommended way to get only the prorations being previewed is to consider only proration line items where period[start] is equal to the subscription_proration_date on the upcoming invoice resource.
+    # You can preview the effects of updating a subscription, including a preview of what proration will take place. To ensure that the actual proration is calculated exactly the same as the previewed proration, you should pass the subscription_proration_date parameter when doing the actual subscription update. The recommended way to get only the prorations being previewed is to consider only proration line items where period[start] is equal to the subscription_proration_date value passed in the request.
     def self.upcoming(params = {}, opts = {})
       request_stripe_object(method: :get, path: "/v1/invoices/upcoming", params: params, opts: opts)
     end

data/lib/stripe/resources/product.rb

@@ -14,6 +14,7 @@ module Stripe
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
     extend Stripe::APIOperations::List
+    extend Stripe::APIOperations::NestedResource
     extend Stripe::APIOperations::Search
     include Stripe::APIOperations::Save
 
@@ -22,6 +23,8 @@ module Stripe
       "product"
     end
 
+    nested_resource_class_methods :feature, operations: %i[create retrieve delete list]
+
     # Creates a new product object.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/products", params: params, opts: opts)

data/lib/stripe/resources/product_feature.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A product_feature represents an attachment between a feature and a product.
+  # When a product is purchased that has a feature attached, Stripe will create an entitlement to the feature for the purchasing customer.
+  class ProductFeature < APIResource
+    OBJECT_NAME = "product_feature"
+    def self.object_name
+      "product_feature"
+    end
+  end
+end

data/lib/stripe/resources.rb

@@ -36,6 +36,8 @@ require "stripe/resources/customer_cash_balance_transaction"
 require "stripe/resources/customer_session"
 require "stripe/resources/discount"
 require "stripe/resources/dispute"
+require "stripe/resources/entitlements/active_entitlement"
+require "stripe/resources/entitlements/feature"
 require "stripe/resources/ephemeral_key"
 require "stripe/resources/event"
 require "stripe/resources/exchange_rate"
@@ -74,6 +76,7 @@ require "stripe/resources/person"
 require "stripe/resources/plan"
 require "stripe/resources/price"
 require "stripe/resources/product"
+require "stripe/resources/product_feature"
 require "stripe/resources/promotion_code"
 require "stripe/resources/quote"
 require "stripe/resources/radar/early_fraud_warning"

data/lib/stripe/stripe_object.rb

@@ -4,6 +4,8 @@ module Stripe
   class StripeObject
     include Enumerable
 
+    attr_reader :last_response
+
     @@permanent_attributes = Set.new([:id]) # rubocop:disable Style/ClassVars
 
     # The default :id method is deprecated and isn't useful to us
@@ -80,13 +82,14 @@ module Stripe
       @unsaved_values = Set.new
       @transient_values = Set.new
       @values[:id] = id if id
+      @last_response = nil
     end
 
-    def self.construct_from(values, opts = {})
+    def self.construct_from(values, opts = {}, last_response = nil)
       values = Stripe::Util.symbolize_names(values)
 
       # work around protected #initialize_from for now
-      new(values[:id]).send(:initialize_from, values, opts)
+      new(values[:id]).send(:initialize_from, values, opts, last_response)
     end
 
     # Determines the equality of two Stripe objects. Stripe objects are
@@ -424,7 +427,9 @@ module Stripe
     # * +:opts:+ Options for StripeObject like an API key.
     # * +:partial:+ Indicates that the re-initialization should not attempt to
     #   remove accessors.
-    protected def initialize_from(values, opts)
+    protected def initialize_from(values, opts, last_response = nil)
+      @last_response = last_response
+
       @opts = Util.normalize_opts(opts)
 
       # the `#send` is here so that we can keep this method private

data/lib/stripe/util.rb

@@ -90,7 +90,7 @@ module Stripe
           opts
         )
 
-        Util.convert_to_stripe_object_with_params(resp.data, params, opts)
+        Util.convert_to_stripe_object_with_params(resp.data, params, opts, resp)
       end
     end
 
@@ -124,7 +124,7 @@ module Stripe
     # * +data+ - Hash of fields and values to be converted into a StripeObject.
     # * +opts+ - Options for +StripeObject+ like an API key that will be reused
     #   on subsequent API calls.
-    def self.convert_to_stripe_object_with_params(data, params, opts = {})
+    def self.convert_to_stripe_object_with_params(data, params, opts = {}, last_response = nil)
       opts = normalize_opts(opts)
 
       case data
@@ -135,7 +135,7 @@ module Stripe
         # to generic StripeObject
         object_name = data[:object] || data["object"]
         obj = object_classes.fetch(object_name, StripeObject)
-                            .construct_from(data, opts)
+                            .construct_from(data, opts, last_response)
 
         # set filters so that we can fetch the same limit, expansions, and
         # predicates when accessing the next and previous pages

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "10.14.0"
+  VERSION = "10.15.0"
 end

data/stripe.gemspec

@@ -33,13 +33,12 @@ Gem::Specification.new do |s|
     /\A\.rubocop/,
     /\A\.travis.yml/,
     /\A\.vscode/,
-    %r{\A(bin/tapioca)},
+    /\Abin/,
     /\Asorbet/,
     /\Atest/
   )
-  s.files = `git ls-files`.split("\n").reject { |f| ignored.match(f) }
-  s.executables   = `git ls-files -- bin/*`.split("\n")
-                                           .map { |f| File.basename(f) }
-                                           .reject { |f| f == "tapioca" }
+  s.files = `git ls-files`.split("\n").grep_v(ignored)
+  s.bindir = "exe"
+  s.executables   = `git ls-files -- exe/*`.split("\n").map { |f| File.basename(f) }
   s.require_paths = ["lib"]
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 10.14.0
+  version: 10.15.0
 platform: ruby
 authors:
 - Stripe
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2024-03-28 00:00:00.000000000 Z
+date: 2024-04-09 00:00:00.000000000 Z
 dependencies: []
 description: Stripe is the easiest way to accept payments online.  See https://stripe.com
   for details.
@@ -29,7 +29,7 @@ files:
 - README.md
 - Rakefile
 - VERSION
-- bin/stripe-console
+- exe/stripe-console
 - lib/data/ca-certificates.crt
 - lib/stripe.rb
 - lib/stripe/api_operations/create.rb
@@ -88,6 +88,8 @@ files:
 - lib/stripe/resources/customer_session.rb
 - lib/stripe/resources/discount.rb
 - lib/stripe/resources/dispute.rb
+- lib/stripe/resources/entitlements/active_entitlement.rb
+- lib/stripe/resources/entitlements/feature.rb
 - lib/stripe/resources/ephemeral_key.rb
 - lib/stripe/resources/event.rb
 - lib/stripe/resources/exchange_rate.rb
@@ -126,6 +128,7 @@ files:
 - lib/stripe/resources/plan.rb
 - lib/stripe/resources/price.rb
 - lib/stripe/resources/product.rb
+- lib/stripe/resources/product_feature.rb
 - lib/stripe/resources/promotion_code.rb
 - lib/stripe/resources/quote.rb
 - lib/stripe/resources/radar/early_fraud_warning.rb