stripe 3.2.0 → 5.16.0

data/test/stripe/file_link_test.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
+
+module Stripe
+  class FileLinkTest < Test::Unit::TestCase
+    should "be listable" do
+      file_links = Stripe::FileLink.list
+      assert_requested :get, "#{Stripe.api_base}/v1/file_links"
+      assert file_links.data.is_a?(Array)
+      assert file_links.first.is_a?(Stripe::FileLink)
+    end
+
+    should "be retrievable" do
+      file_link = Stripe::FileLink.retrieve("link_123")
+      assert_requested :get, "#{Stripe.api_base}/v1/file_links/link_123"
+      assert file_link.is_a?(Stripe::FileLink)
+    end
+
+    should "be creatable" do
+      file_link = Stripe::FileLink.create(
+        file: "file_123"
+      )
+      assert_requested :post, "#{Stripe.api_base}/v1/file_links"
+      assert file_link.is_a?(Stripe::FileLink)
+    end
+
+    should "be saveable" do
+      file_link = Stripe::FileLink.retrieve("link_123")
+      file_link.metadata["key"] = "value"
+      file_link.save
+      assert_requested :post, "#{Stripe.api_base}/v1/file_links/#{file_link.id}"
+    end
+
+    should "be updateable" do
+      file_link = Stripe::FileLink.update("link_123", metadata: { key: "value" })
+      assert_requested :post, "#{Stripe.api_base}/v1/file_links/link_123"
+      assert file_link.is_a?(Stripe::FileLink)
+    end
+  end
+end

data/test/stripe/file_test.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
+
+module Stripe
+  class FileTest < Test::Unit::TestCase
+    should "be listable" do
+      files = Stripe::File.list
+      assert_requested :get, "#{Stripe.api_base}/v1/files"
+      assert files.data.is_a?(Array)
+      assert files.data[0].is_a?(Stripe::File)
+    end
+
+    should "be retrievable" do
+      file = Stripe::File.retrieve("file_123")
+      assert_requested :get, "#{Stripe.api_base}/v1/files/file_123"
+      assert file.is_a?(Stripe::File)
+    end
+
+    context ".create" do
+      setup do
+        # We don't point to the same host for the API and uploads in
+        # production, but `stripe-mock` supports both APIs.
+        Stripe.uploads_base = Stripe.api_base
+
+        # Set `api_base` to `nil` to ensure that these requests are _not_ sent
+        # to the default API hostname.
+        Stripe.api_base = nil
+      end
+
+      should "be creatable with a File" do
+        file = Stripe::File.create(
+          purpose: "dispute_evidence",
+          file: ::File.new(__FILE__),
+          file_link_data: { create: true }
+        )
+        assert_requested :post, "#{Stripe.uploads_base}/v1/files"
+        assert file.is_a?(Stripe::File)
+      end
+
+      should "be creatable with a Tempfile" do
+        tempfile = Tempfile.new("foo")
+        tempfile.write("Hello world")
+        tempfile.rewind
+
+        file = Stripe::File.create(
+          purpose: "dispute_evidence",
+          file: tempfile,
+          file_link_data: { create: true }
+        )
+        assert_requested :post, "#{Stripe.uploads_base}/v1/files"
+        assert file.is_a?(Stripe::File)
+      end
+
+      should "be creatable with a string" do
+        file = Stripe::File.create(
+          purpose: "dispute_evidence",
+          file: "my-file-contents",
+          file_link_data: { create: true }
+        )
+        assert_requested :post, "#{Stripe.uploads_base}/v1/files"
+        assert file.is_a?(Stripe::File)
+      end
+
+      should "raise given a file object that doesn't respond to #read" do
+        e = assert_raises(ArgumentError) do
+          Stripe::File.create(
+            purpose: "dispute_evidence",
+            file: Object.new,
+            file_link_data: { create: true }
+          )
+        end
+        assert_equal "file must respond to `#read`", e.message
+      end
+    end
+
+    should "be deserializable when `object=file`" do
+      file = Stripe::Util.convert_to_stripe_object({ object: "file" }, {})
+      assert file.is_a?(Stripe::File)
+    end
+
+    should "be deserializable when `object=file_upload`" do
+      file = Stripe::Util.convert_to_stripe_object({ object: "file_upload" }, {})
+      assert file.is_a?(Stripe::File)
+    end
+  end
+end

data/test/stripe/instrumentation_test.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require_relative "../test_helper"
+
+module Stripe
+  class InstrumentationTest < Test::Unit::TestCase
+    context ".notify" do
+      teardown do
+        Stripe::Instrumentation.send(:subscribers).clear
+      end
+
+      should "notify subscribers for the right topic" do
+        sub1_events = []
+        Stripe::Instrumentation.subscribe(:test1, :sub1) { |event| sub1_events << event }
+        sub2_events = []
+        Stripe::Instrumentation.subscribe(:test2, :sub2) { |event| sub2_events << event }
+
+        Stripe::Instrumentation.notify(:test1, "hello")
+        assert_equal(1, sub1_events.size)
+        assert_equal(0, sub2_events.size)
+      end
+
+      should "notify multiple subscribers of the same topic" do
+        sub1_events = []
+        Stripe::Instrumentation.subscribe(:test, :sub1) { |event| sub1_events << event }
+        sub2_events = []
+        Stripe::Instrumentation.subscribe(:test, :sub2) { |event| sub2_events << event }
+
+        Stripe::Instrumentation.notify(:test, "hello")
+        assert_equal(1, sub1_events.size)
+        assert_equal(1, sub2_events.size)
+      end
+
+      should "not notify a subscriber once it has unsubscribed" do
+        events = []
+        Stripe::Instrumentation.subscribe(:test, :sub) { |event| events << event }
+
+        Stripe::Instrumentation.notify(:test, "hello")
+        assert_equal(1, events.size)
+
+        Stripe::Instrumentation.unsubscribe(:test, :sub)
+        Stripe::Instrumentation.notify(:test, "hello")
+        assert_equal(1, events.size)
+      end
+    end
+
+    context "RequestEventBegin" do
+      should "return a frozen object" do
+        event = Stripe::Instrumentation::RequestBeginEvent.new(
+          method: :get,
+          path: "/v1/test",
+          user_data: nil
+        )
+
+        assert(event.frozen?)
+      end
+    end
+
+    context "RequestEventEnd" do
+      should "return a frozen object" do
+        event = Stripe::Instrumentation::RequestEndEvent.new(
+          duration: 0.1,
+          http_status: 200,
+          method: :get,
+          num_retries: 0,
+          path: "/v1/test",
+          user_data: nil
+        )
+
+        assert(event.frozen?)
+      end
+    end
+  end
+end

data/test/stripe/invoice_item_test.rb

@@ -1,19 +1,21 @@
-require File.expand_path('../../test_helper', __FILE__)
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
 
 module Stripe
   class InvoiceItemTest < Test::Unit::TestCase
     should "be listable" do
       invoiceitems = Stripe::InvoiceItem.list
       assert_requested :get, "#{Stripe.api_base}/v1/invoiceitems"
-      assert invoiceitems.data.kind_of?(Array)
-      assert invoiceitems.first.kind_of?(Stripe::InvoiceItem)
+      assert invoiceitems.data.is_a?(Array)
+      assert invoiceitems.first.is_a?(Stripe::InvoiceItem)
     end
 
     should "be retrievable" do
       item = Stripe::InvoiceItem.retrieve("ii_123")
       assert_requested :get,
-        "#{Stripe.api_base}/v1/invoiceitems/ii_123"
-      assert item.kind_of?(Stripe::InvoiceItem)
+                       "#{Stripe.api_base}/v1/invoiceitems/ii_123"
+      assert item.is_a?(Stripe::InvoiceItem)
     end
 
     should "be creatable" do
@@ -23,31 +25,42 @@ module Stripe
         customer: "cus_123"
       )
       assert_requested :post,
-        "#{Stripe.api_base}/v1/invoiceitems"
-      assert item.kind_of?(Stripe::InvoiceItem)
+                       "#{Stripe.api_base}/v1/invoiceitems"
+      assert item.is_a?(Stripe::InvoiceItem)
     end
 
     should "be saveable" do
       item = Stripe::InvoiceItem.retrieve("ii_123")
-      item.metadata['key'] = 'value'
+      item.metadata["key"] = "value"
       item.save
       assert_requested :post,
-        "#{Stripe.api_base}/v1/invoiceitems/#{item.id}"
+                       "#{Stripe.api_base}/v1/invoiceitems/#{item.id}"
     end
 
     should "be updateable" do
-      item = Stripe::InvoiceItem.update("ii_123", metadata: { key: 'value' })
+      item = Stripe::InvoiceItem.update("ii_123", metadata: { key: "value" })
       assert_requested :post,
-        "#{Stripe.api_base}/v1/invoiceitems/ii_123"
-      assert item.kind_of?(Stripe::InvoiceItem)
+                       "#{Stripe.api_base}/v1/invoiceitems/ii_123"
+      assert item.is_a?(Stripe::InvoiceItem)
     end
 
-    should "be deletable" do
-      item = Stripe::InvoiceItem.retrieve("ii_123")
-      item = item.delete
-      assert_requested :delete,
-        "#{Stripe.api_base}/v1/invoiceitems/#{item.id}"
-      assert item.kind_of?(Stripe::InvoiceItem)
+    context "#delete" do
+      should "be deletable" do
+        item = Stripe::InvoiceItem.retrieve("ii_123")
+        item = item.delete
+        assert_requested :delete,
+                         "#{Stripe.api_base}/v1/invoiceitems/#{item.id}"
+        assert item.is_a?(Stripe::InvoiceItem)
+      end
+    end
+
+    context ".delete" do
+      should "be deletable" do
+        item = Stripe::InvoiceItem.delete("ii_123")
+        assert_requested :delete,
+                         "#{Stripe.api_base}/v1/invoiceitems/ii_123"
+        assert item.is_a?(Stripe::InvoiceItem)
+      end
     end
   end
 end

data/test/stripe/invoice_line_item_test.rb

@@ -1,4 +1,6 @@
-require File.expand_path('../../test_helper', __FILE__)
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
 
 module Stripe
   class InvoiceLineItemTest < Test::Unit::TestCase

data/test/stripe/invoice_test.rb

@@ -1,39 +1,94 @@
-require File.expand_path('../../test_helper', __FILE__)
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
 
 module Stripe
   class InvoiceTest < Test::Unit::TestCase
     should "be listable" do
       invoices = Stripe::Invoice.list
       assert_requested :get, "#{Stripe.api_base}/v1/invoices"
-      assert invoices.data.kind_of?(Array)
-      assert invoices.first.kind_of?(Stripe::Invoice)
+      assert invoices.data.is_a?(Array)
+      assert invoices.first.is_a?(Stripe::Invoice)
     end
 
     should "be retrievable" do
       invoice = Stripe::Invoice.retrieve("in_123")
       assert_requested :get, "#{Stripe.api_base}/v1/invoices/in_123"
-      assert invoice.kind_of?(Stripe::Invoice)
+      assert invoice.is_a?(Stripe::Invoice)
     end
 
     should "be creatable" do
       invoice = Stripe::Invoice.create(
-        :customer => "cus_123"
+        customer: "cus_123"
       )
       assert_requested :post, "#{Stripe.api_base}/v1/invoices"
-      assert invoice.kind_of?(Stripe::Invoice)
+      assert invoice.is_a?(Stripe::Invoice)
     end
 
     should "be saveable" do
       invoice = Stripe::Invoice.retrieve("in_123")
-      invoice.metadata['key'] = 'value'
+      invoice.metadata["key"] = "value"
       invoice.save
       assert_requested :post, "#{Stripe.api_base}/v1/invoices/#{invoice.id}"
     end
 
     should "be updateable" do
-      invoice = Stripe::Invoice.update("in_123", metadata: { key: 'value' })
+      invoice = Stripe::Invoice.update("in_123", metadata: { key: "value" })
       assert_requested :post, "#{Stripe.api_base}/v1/invoices/in_123"
-      assert invoice.kind_of?(Stripe::Invoice)
+      assert invoice.is_a?(Stripe::Invoice)
+    end
+
+    context "#delete" do
+      should "be deletable" do
+        invoice = Stripe::Invoice.retrieve("in_123")
+        invoice = invoice.delete
+        assert_requested :delete, "#{Stripe.api_base}/v1/invoices/#{invoice.id}"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context ".delete" do
+      should "be deletable" do
+        invoice = Stripe::Invoice.delete("in_123")
+        assert_requested :delete, "#{Stripe.api_base}/v1/invoices/in_123"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context "#finalize" do
+      should "finalize invoice" do
+        invoice = Stripe::Invoice.retrieve("in_123")
+        invoice = invoice.finalize_invoice
+        assert_requested :post,
+                         "#{Stripe.api_base}/v1/invoices/#{invoice.id}/finalize"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context ".finalize" do
+      should "finalize invoice" do
+        invoice = Stripe::Invoice.finalize_invoice("in_123")
+        assert_requested :post, "#{Stripe.api_base}/v1/invoices/in_123/finalize"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context "#mark_uncollectible" do
+      should "mark invoice as uncollectible" do
+        invoice = Stripe::Invoice.retrieve("in_123")
+        invoice = invoice.mark_uncollectible
+        assert_requested :post,
+                         "#{Stripe.api_base}/v1/invoices/#{invoice.id}/mark_uncollectible"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context ".mark_uncollectible" do
+      should "mark invoice as uncollectible" do
+        invoice = Stripe::Invoice.mark_uncollectible("in_123")
+        assert_requested :post, "#{Stripe.api_base}/v1/invoices/in_123/mark_uncollectible"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
     end
 
     context "#pay" do
@@ -41,43 +96,71 @@ module Stripe
         invoice = Stripe::Invoice.retrieve("in_123")
         invoice = invoice.pay
         assert_requested :post,
-          "#{Stripe.api_base}/v1/invoices/#{invoice.id}/pay"
-        assert invoice.kind_of?(Stripe::Invoice)
+                         "#{Stripe.api_base}/v1/invoices/#{invoice.id}/pay"
+        assert invoice.is_a?(Stripe::Invoice)
       end
 
       should "pay invoice with a specific source" do
         invoice = Stripe::Invoice.retrieve("in_123")
         invoice = invoice.pay(
-          source: 'src_123',
+          source: "src_123"
         )
         assert_requested :post,
-          "#{Stripe.api_base}/v1/invoices/#{invoice.id}/pay",
-          body: {
-            source: 'src_123',
-          }
-        assert invoice.kind_of?(Stripe::Invoice)
+                         "#{Stripe.api_base}/v1/invoices/#{invoice.id}/pay",
+                         body: {
+                           source: "src_123",
+                         }
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context ".pay" do
+      should "pay invoice" do
+        invoice = Stripe::Invoice.pay("in_123", source: "src_123")
+        assert_requested :post,
+                         "#{Stripe.api_base}/v1/invoices/in_123/pay",
+                         body: { source: "src_123" }
+        assert invoice.is_a?(Stripe::Invoice)
       end
     end
 
-    context "#upcoming" do
+    context "#send_invoice" do
+      should "send invoice" do
+        invoice = Stripe::Invoice.retrieve("in_123")
+        invoice = invoice.send_invoice
+        assert_requested :post,
+                         "#{Stripe.api_base}/v1/invoices/#{invoice.id}/send"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context ".send_invoice" do
+      should "send invoice" do
+        invoice = Stripe::Invoice.send_invoice("in_123")
+        assert_requested :post, "#{Stripe.api_base}/v1/invoices/in_123/send"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context ".upcoming" do
       should "retrieve upcoming invoices" do
         invoice = Stripe::Invoice.upcoming(
           customer: "cus_123",
           subscription: "sub_123"
         )
         assert_requested :get, "#{Stripe.api_base}/v1/invoices/upcoming",
-          query: {
-            customer: "cus_123",
-            subscription: "sub_123"
-          }
-        assert invoice.kind_of?(Stripe::Invoice)
+                         query: {
+                           customer: "cus_123",
+                           subscription: "sub_123",
+                         }
+        assert invoice.is_a?(Stripe::Invoice)
       end
 
       should "retrieve upcoming invoices with items" do
-        items = [{
-          plan: 'gold',
-          quantity: 2
-        }]
+        items = [
+          { plan: "gold", quantity: 2 },
+          { id: "si_123", deleted: true },
+        ]
 
         invoice = Stripe::Invoice.upcoming(
           customer: "cus_123",
@@ -85,25 +168,61 @@ module Stripe
         )
 
         assert_requested :get, "#{Stripe.api_base}/v1/invoices/upcoming",
-          query: {
-            customer: "cus_123",
-            :'subscription_items[][plan]' => 'gold',
-            :'subscription_items[][quantity]' =>  2
-          }
-        assert invoice.kind_of?(Stripe::Invoice)
+                         query: {
+                           customer: "cus_123",
+                           subscription_items: [
+                             { plan: "gold", quantity: "2" },
+                             { id: "si_123", deleted: true },
+                           ],
+                         }
+        assert invoice.is_a?(Stripe::Invoice)
       end
 
       should "be callable with an empty string" do
         invoice = Stripe::Invoice.upcoming(
-          coupon: '',
+          coupon: "",
           customer: "cus_123"
         )
         assert_requested :get, "#{Stripe.api_base}/v1/invoices/upcoming",
-          query: {
-            coupon: '',
-            customer: "cus_123"
-          }
-        assert invoice.kind_of?(Stripe::Invoice)
+                         query: {
+                           coupon: "",
+                           customer: "cus_123",
+                         }
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context ".list_upcoming_line_items" do
+      should "retrieve upcoming invoices" do
+        line_items = Stripe::Invoice.list_upcoming_line_items(
+          customer: "cus_123",
+          subscription: "sub_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/invoices/upcoming/lines",
+                         query: {
+                           customer: "cus_123",
+                           subscription: "sub_123",
+                         }
+        assert line_items.data.is_a?(Array)
+        assert line_items.data[0].is_a?(Stripe::InvoiceLineItem)
+      end
+    end
+
+    context "#void_invoice" do
+      should "void invoice" do
+        invoice = Stripe::Invoice.retrieve("in_123")
+        invoice = invoice.void_invoice
+        assert_requested :post,
+                         "#{Stripe.api_base}/v1/invoices/#{invoice.id}/void"
+        assert invoice.is_a?(Stripe::Invoice)
+      end
+    end
+
+    context ".void_invoice" do
+      should "void invoice" do
+        invoice = Stripe::Invoice.void_invoice("in_123")
+        assert_requested :post, "#{Stripe.api_base}/v1/invoices/in_123/void"
+        assert invoice.is_a?(Stripe::Invoice)
       end
     end
   end

data/test/stripe/issuing/authorization_test.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require ::File.expand_path("../../test_helper", __dir__)
+
+module Stripe
+  module Issuing
+    class AuthorizationTest < Test::Unit::TestCase
+      should "be listable" do
+        authorizations = Stripe::Issuing::Authorization.list
+        assert_requested :get, "#{Stripe.api_base}/v1/issuing/authorizations"
+        assert authorizations.data.is_a?(Array)
+        assert authorizations.data[0].is_a?(Stripe::Issuing::Authorization)
+      end
+
+      should "be retrievable" do
+        authorization = Stripe::Issuing::Authorization.retrieve("iauth_123")
+        assert_requested :get, "#{Stripe.api_base}/v1/issuing/authorizations/iauth_123"
+        assert authorization.is_a?(Stripe::Issuing::Authorization)
+      end
+
+      should "be saveable" do
+        authorization = Stripe::Issuing::Authorization.retrieve("iauth_123")
+        authorization.metadata["key"] = "value"
+        authorization.save
+        assert_requested :post, "#{Stripe.api_base}/v1/issuing/authorizations/#{authorization.id}"
+        assert authorization.is_a?(Stripe::Issuing::Authorization)
+      end
+
+      should "be updateable" do
+        authorization = Stripe::Issuing::Authorization.update("iauth_123", metadata: { foo: "bar" })
+        assert_requested :post, "#{Stripe.api_base}/v1/issuing/authorizations/iauth_123"
+        assert authorization.is_a?(Stripe::Issuing::Authorization)
+      end
+
+      context ".approve" do
+        should "approve an authorization" do
+          payment_intent = Stripe::Issuing::Authorization.approve("iauth_123")
+
+          assert_requested :post, "#{Stripe.api_base}/v1/issuing/authorizations/iauth_123/approve"
+          assert payment_intent.is_a?(Stripe::Issuing::Authorization)
+        end
+      end
+
+      context "#approve" do
+        should "approve an authorization" do
+          authorization = Stripe::Issuing::Authorization.retrieve("iauth_123")
+          authorization.approve
+          assert_requested :post, "#{Stripe.api_base}/v1/issuing/authorizations/iauth_123/approve"
+          assert authorization.is_a?(Stripe::Issuing::Authorization)
+        end
+      end
+
+      context ".decline" do
+        should "decline an authorization" do
+          payment_intent = Stripe::Issuing::Authorization.decline("iauth_123")
+
+          assert_requested :post, "#{Stripe.api_base}/v1/issuing/authorizations/iauth_123/decline"
+          assert payment_intent.is_a?(Stripe::Issuing::Authorization)
+        end
+      end
+
+      context "#decline" do
+        should "decline an authorization" do
+          authorization = Stripe::Issuing::Authorization.retrieve("iauth_123")
+          authorization.decline
+          assert_requested :post, "#{Stripe.api_base}/v1/issuing/authorizations/iauth_123/decline"
+          assert authorization.is_a?(Stripe::Issuing::Authorization)
+        end
+      end
+    end
+  end
+end