straddle 0.4.0 → 0.5.0

data/lib/straddle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Straddle
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/straddle.rb

@@ -156,6 +156,7 @@ require_relative "straddle/models/payout_release_params"
 require_relative "straddle/models/payout_unmask_params"
 require_relative "straddle/models/payout_unmask_response"
 require_relative "straddle/models/payout_update_params"
+require_relative "straddle/models/payout_upload_authorization_document_params"
 require_relative "straddle/models/payout_v1"
 require_relative "straddle/models/report_create_total_customers_by_status_params"
 require_relative "straddle/models/report_create_total_customers_by_status_response"

data/rbi/straddle/internal/util.rbi

@@ -148,12 +148,20 @@ module Straddle
         end
       end
 
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = T.let(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/, Regexp)
+
       class << self
         # @api private
         sig { params(uri: URI::Generic).returns(String) }
         def uri_origin(uri)
         end
 
+        # @api private
+        sig { params(path: T.any(String, Integer)).returns(String) }
+        def encode_path(path)
+        end
+
         # @api private
         sig { params(path: T.any(String, T::Array[String])).returns(String) }
         def interpolate_path(path)

data/rbi/straddle/models/charge_create_params.rbi

@@ -344,6 +344,16 @@ module Straddle
               :reversed_closed_bank_account,
               Straddle::ChargeCreateParams::Config::SandboxOutcome::TaggedSymbol
             )
+          FAILED_NOT_AUTHORIZED =
+            T.let(
+              :failed_not_authorized,
+              Straddle::ChargeCreateParams::Config::SandboxOutcome::TaggedSymbol
+            )
+          REVERSED_NOT_AUTHORIZED =
+            T.let(
+              :reversed_not_authorized,
+              Straddle::ChargeCreateParams::Config::SandboxOutcome::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/straddle/models/charge_unmask_response.rbi

@@ -144,6 +144,18 @@ module Straddle
         sig { returns(T::Array[String]) }
         attr_accessor :funding_ids
 
+        # Has the charge been refunded by an associated payout.
+        sig { returns(T::Boolean) }
+        attr_accessor :has_refund
+
+        # Has the charge been resubmitted.
+        sig { returns(T::Boolean) }
+        attr_accessor :has_resubmit
+
+        # Is the charge a resubmit of an original charge.
+        sig { returns(T::Boolean) }
+        attr_accessor :is_resubmit
+
         # Paykey.
         sig { returns(String) }
         attr_accessor :paykey
@@ -193,6 +205,17 @@ module Straddle
         end
         attr_writer :customer_details
 
+        # Documents uploaded for this charge (e.g. proof of authorization), in the order
+        # they were uploaded.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[Straddle::Models::ChargeUnmaskResponse::Data::Document]
+            )
+          )
+        end
+        attr_accessor :documents
+
         # Effective at.
         sig { returns(T.nilable(Time)) }
         attr_accessor :effective_at
@@ -233,9 +256,8 @@ module Straddle
         sig do
           returns(
             T.nilable(
-              T::Hash[
-                Symbol,
-                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::TaggedSymbol
+              T::Array[
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment
               ]
             )
           )
@@ -257,6 +279,9 @@ module Straddle
               Straddle::Models::ChargeUnmaskResponse::Data::Device::OrHash,
             external_id: String,
             funding_ids: T::Array[String],
+            has_refund: T::Boolean,
+            has_resubmit: T::Boolean,
+            is_resubmit: T::Boolean,
             paykey: String,
             payment_date: Date,
             status:
@@ -269,6 +294,12 @@ module Straddle
             trace_ids: T::Hash[Symbol, String],
             updated_at: Time,
             customer_details: Straddle::CustomerDetailsV1::OrHash,
+            documents:
+              T.nilable(
+                T::Array[
+                  Straddle::Models::ChargeUnmaskResponse::Data::Document::OrHash
+                ]
+              ),
             effective_at: T.nilable(Time),
             metadata: T.nilable(T::Hash[Symbol, String]),
             paykey_details: Straddle::PaykeyDetailsV1::OrHash,
@@ -277,9 +308,8 @@ module Straddle
             processed_at: T.nilable(Time),
             related_payments:
               T.nilable(
-                T::Hash[
-                  Symbol,
-                  Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::OrSymbol
+                T::Array[
+                  Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::OrHash
                 ]
               )
           ).returns(T.attached_class)
@@ -306,6 +336,12 @@ module Straddle
           external_id:,
           # Funding Ids
           funding_ids:,
+          # Has the charge been refunded by an associated payout.
+          has_refund:,
+          # Has the charge been resubmitted.
+          has_resubmit:,
+          # Is the charge a resubmit of an original charge.
+          is_resubmit:,
           # Paykey.
           paykey:,
           # Payment date.
@@ -321,6 +357,9 @@ module Straddle
           updated_at:,
           # Information about the customer associated with the charge or payout.
           customer_details: nil,
+          # Documents uploaded for this charge (e.g. proof of authorization), in the order
+          # they were uploaded.
+          documents: nil,
           # Effective at.
           effective_at: nil,
           # Metadata.
@@ -349,6 +388,9 @@ module Straddle
               device: Straddle::Models::ChargeUnmaskResponse::Data::Device,
               external_id: String,
               funding_ids: T::Array[String],
+              has_refund: T::Boolean,
+              has_resubmit: T::Boolean,
+              is_resubmit: T::Boolean,
               paykey: String,
               payment_date: Date,
               status:
@@ -361,6 +403,12 @@ module Straddle
               trace_ids: T::Hash[Symbol, String],
               updated_at: Time,
               customer_details: Straddle::CustomerDetailsV1,
+              documents:
+                T.nilable(
+                  T::Array[
+                    Straddle::Models::ChargeUnmaskResponse::Data::Document
+                  ]
+                ),
               effective_at: T.nilable(Time),
               metadata: T.nilable(T::Hash[Symbol, String]),
               paykey_details: Straddle::PaykeyDetailsV1,
@@ -369,9 +417,8 @@ module Straddle
               processed_at: T.nilable(Time),
               related_payments:
                 T.nilable(
-                  T::Hash[
-                    Symbol,
-                    Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::TaggedSymbol
+                  T::Array[
+                    Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment
                   ]
                 )
             }
@@ -568,6 +615,16 @@ module Straddle
                 :reversed_closed_bank_account,
                 Straddle::Models::ChargeUnmaskResponse::Data::Config::SandboxOutcome::TaggedSymbol
               )
+            FAILED_NOT_AUTHORIZED =
+              T.let(
+                :failed_not_authorized,
+                Straddle::Models::ChargeUnmaskResponse::Data::Config::SandboxOutcome::TaggedSymbol
+              )
+            REVERSED_NOT_AUTHORIZED =
+              T.let(
+                :reversed_not_authorized,
+                Straddle::Models::ChargeUnmaskResponse::Data::Config::SandboxOutcome::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -1093,6 +1150,106 @@ module Straddle
           end
         end
 
+        class Document < Straddle::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Straddle::Models::ChargeUnmaskResponse::Data::Document,
+                Straddle::Internal::AnyHash
+              )
+            end
+
+          # Unique identifier for this document.
+          sig { returns(String) }
+          attr_accessor :document_id
+
+          # The file name of this document as uploaded.
+          sig { returns(String) }
+          attr_accessor :document_name
+
+          # The size of this document in bytes.
+          sig { returns(Integer) }
+          attr_accessor :document_size
+
+          sig do
+            returns(
+              Straddle::Models::ChargeUnmaskResponse::Data::Document::DocumentType::TaggedSymbol
+            )
+          end
+          attr_accessor :document_type
+
+          # The UTC timestamp when this document was uploaded.
+          sig { returns(Time) }
+          attr_accessor :uploaded_at
+
+          sig do
+            params(
+              document_id: String,
+              document_name: String,
+              document_size: Integer,
+              document_type:
+                Straddle::Models::ChargeUnmaskResponse::Data::Document::DocumentType::OrSymbol,
+              uploaded_at: Time
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Unique identifier for this document.
+            document_id:,
+            # The file name of this document as uploaded.
+            document_name:,
+            # The size of this document in bytes.
+            document_size:,
+            document_type:,
+            # The UTC timestamp when this document was uploaded.
+            uploaded_at:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                document_id: String,
+                document_name: String,
+                document_size: Integer,
+                document_type:
+                  Straddle::Models::ChargeUnmaskResponse::Data::Document::DocumentType::TaggedSymbol,
+                uploaded_at: Time
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module DocumentType
+            extend Straddle::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Straddle::Models::ChargeUnmaskResponse::Data::Document::DocumentType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            PAYMENT_AUTHORIZATION =
+              T.let(
+                :payment_authorization,
+                Straddle::Models::ChargeUnmaskResponse::Data::Document::DocumentType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::Models::ChargeUnmaskResponse::Data::Document::DocumentType::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         # The payment rail used for the charge or payout.
         module PaymentRail
           extend Straddle::Internal::Type::Enum
@@ -1123,42 +1280,138 @@ module Straddle
           end
         end
 
-        module RelatedPayment
-          extend Straddle::Internal::Type::Enum
-
-          TaggedSymbol =
+        class RelatedPayment < Straddle::Internal::Type::BaseModel
+          OrHash =
             T.type_alias do
-              T.all(
-                Symbol,
-                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment
+              T.any(
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment,
+                Straddle::Internal::AnyHash
               )
             end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-          ORIGINAL =
-            T.let(
-              :original,
-              Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::TaggedSymbol
-            )
-          RESUBMIT =
-            T.let(
-              :resubmit,
-              Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::TaggedSymbol
+          # The ID of the related payment.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The type of payment.
+          sig do
+            returns(
+              Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol
             )
-          REFUND =
-            T.let(
-              :refund,
-              Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::TaggedSymbol
+          end
+          attr_accessor :payment_type
+
+          sig do
+            returns(
+              Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
             )
+          end
+          attr_accessor :relationship
+
+          sig do
+            params(
+              id: String,
+              payment_type:
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType::OrSymbol,
+              relationship:
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The ID of the related payment.
+            id:,
+            # The type of payment.
+            payment_type:,
+            relationship:
+          )
+          end
 
           sig do
             override.returns(
-              T::Array[
-                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::TaggedSymbol
-              ]
+              {
+                id: String,
+                payment_type:
+                  Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol,
+                relationship:
+                  Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+              }
             )
           end
-          def self.values
+          def to_hash
+          end
+
+          # The type of payment.
+          module PaymentType
+            extend Straddle::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            CHARGE =
+              T.let(
+                :charge,
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol
+              )
+            PAYOUT =
+              T.let(
+                :payout,
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          module Relationship
+            extend Straddle::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ORIGINAL =
+              T.let(
+                :original,
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+            RESUBMIT =
+              T.let(
+                :resubmit,
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+            REFUND =
+              T.let(
+                :refund,
+                Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
           end
         end
       end