straddle 0.1.1 → 0.3.0

data/lib/straddle/resources/payouts.rb

@@ -8,7 +8,7 @@ module Straddle
       #
       # Use payouts to send money to your customers.
       #
-      # @overload create(amount:, currency:, description:, device:, external_id:, paykey:, payment_date:, config: nil, metadata: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload create(amount:, currency:, description:, device:, external_id:, paykey:, payment_date:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param amount [Integer] Body param: The amount of the payout in cents.
       #
@@ -30,6 +30,8 @@ module Straddle
       #
       # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
       #
+      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      #
       # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
       #
       # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
@@ -44,6 +46,7 @@ module Straddle
         header_params =
           {
             correlation_id: "correlation-id",
+            idempotency_key: "idempotency-key",
             request_id: "request-id",
             straddle_account_id: "straddle-account-id"
           }
@@ -63,7 +66,7 @@ module Straddle
       # Update the details of a payout prior to processing. The status of the payout
       # must be `created`, `scheduled`, or `on_hold`.
       #
-      # @overload update(id, amount:, description:, payment_date:, metadata: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload update(id, amount:, description:, payment_date:, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param id [String] Path param:
       #
@@ -77,6 +80,8 @@ module Straddle
       #
       # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
       #
+      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      #
       # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
       #
       # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
@@ -91,6 +96,7 @@ module Straddle
         header_params =
           {
             correlation_id: "correlation-id",
+            idempotency_key: "idempotency-key",
             request_id: "request-id",
             straddle_account_id: "straddle-account-id"
           }
@@ -110,7 +116,7 @@ module Straddle
       # Cancel a payout to prevent it from being processed. The status of the payout
       # must be `created`, `scheduled`, or `on_hold`.
       #
-      # @overload cancel(id, reason:, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload cancel(id, reason:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param id [String] Path param:
       #
@@ -118,6 +124,8 @@ module Straddle
       #
       # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
       #
+      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      #
       # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
       #
       # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
@@ -132,6 +140,7 @@ module Straddle
         header_params =
           {
             correlation_id: "correlation-id",
+            idempotency_key: "idempotency-key",
             request_id: "request-id",
             straddle_account_id: "straddle-account-id"
           }
@@ -184,7 +193,7 @@ module Straddle
       # Hold a payout to prevent it from being processed. The status of the payout must
       # be `created`, `scheduled`, or `on_hold`.
       #
-      # @overload hold(id, reason:, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload hold(id, reason:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param id [String] Path param:
       #
@@ -192,6 +201,8 @@ module Straddle
       #
       # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
       #
+      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      #
       # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
       #
       # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
@@ -206,6 +217,7 @@ module Straddle
         header_params =
           {
             correlation_id: "correlation-id",
+            idempotency_key: "idempotency-key",
             request_id: "request-id",
             straddle_account_id: "straddle-account-id"
           }
@@ -225,7 +237,7 @@ module Straddle
       # Release a payout from a `hold` status to allow it to be rescheduled for
       # processing.
       #
-      # @overload release(id, reason:, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload release(id, reason:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param id [String] Path param:
       #
@@ -233,6 +245,8 @@ module Straddle
       #
       # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
       #
+      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      #
       # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
       #
       # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
@@ -247,6 +261,7 @@ module Straddle
         header_params =
           {
             correlation_id: "correlation-id",
+            idempotency_key: "idempotency-key",
             request_id: "request-id",
             straddle_account_id: "straddle-account-id"
           }

data/lib/straddle/version.rb

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

data/lib/straddle.rb

@@ -9,6 +9,7 @@ require "erb"
 require "etc"
 require "json"
 require "net/http"
+require "openssl"
 require "pathname"
 require "rbconfig"
 require "securerandom"
@@ -74,11 +75,11 @@ require_relative "straddle/models/customer_delete_params"
 require_relative "straddle/models/customer_details_v1"
 require_relative "straddle/models/customer_get_params"
 require_relative "straddle/models/customer_list_params"
-require_relative "straddle/models/customer_refresh_review_params"
 require_relative "straddle/models/customers/customer_review_v1"
 require_relative "straddle/models/customers/identity_verification_breakdown_v1"
 require_relative "straddle/models/customers/review_decision_params"
 require_relative "straddle/models/customers/review_get_params"
+require_relative "straddle/models/customers/review_refresh_review_params"
 require_relative "straddle/models/customer_summary_paged_v1"
 require_relative "straddle/models/customer_unmasked_params"
 require_relative "straddle/models/customer_unmasked_v1"
@@ -101,6 +102,7 @@ require_relative "straddle/models/embed/address_v1"
 require_relative "straddle/models/embed/business_profile_v1"
 require_relative "straddle/models/embed/capability_v1"
 require_relative "straddle/models/embed/industry_v1"
+require_relative "straddle/models/embed/linked_bank_account_cancel_params"
 require_relative "straddle/models/embed/linked_bank_account_create_params"
 require_relative "straddle/models/embed/linked_bank_account_get_params"
 require_relative "straddle/models/embed/linked_bank_account_list_params"
@@ -134,9 +136,14 @@ require_relative "straddle/models/paykey_get_params"
 require_relative "straddle/models/paykey_list_params"
 require_relative "straddle/models/paykey_reveal_params"
 require_relative "straddle/models/paykey_reveal_response"
+require_relative "straddle/models/paykeys/review_decision_params"
+require_relative "straddle/models/paykeys/review_get_params"
+require_relative "straddle/models/paykeys/review_get_response"
+require_relative "straddle/models/paykeys/review_refresh_review_params"
 require_relative "straddle/models/paykey_summary_paged_v1"
 require_relative "straddle/models/paykey_unmasked_params"
 require_relative "straddle/models/paykey_unmasked_v1"
+require_relative "straddle/models/paykey_update_balance_params"
 require_relative "straddle/models/paykey_v1"
 require_relative "straddle/models/payment_list_params"
 require_relative "straddle/models/payment_summary_paged_v1"
@@ -167,6 +174,7 @@ require_relative "straddle/resources/embed/organizations"
 require_relative "straddle/resources/embed/representatives"
 require_relative "straddle/resources/funding_events"
 require_relative "straddle/resources/paykeys"
+require_relative "straddle/resources/paykeys/review"
 require_relative "straddle/resources/payments"
 require_relative "straddle/resources/payouts"
 require_relative "straddle/resources/reports"

data/manifest.yaml

@@ -6,6 +6,7 @@ dependencies:
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/straddle/client.rbi

@@ -13,8 +13,8 @@ module Straddle
     ENVIRONMENTS =
       T.let(
         {
-          sandbox: "https://sandbox.straddle.io",
-          production: "https://production.straddle.io"
+          sandbox: "https://sandbox.straddle.com",
+          production: "https://production.straddle.com"
         },
         T::Hash[Symbol, String]
       )
@@ -76,8 +76,8 @@ module Straddle
       #
       # Each environment maps to a different base URL:
       #
-      # - `sandbox` corresponds to `https://sandbox.straddle.io`
-      # - `production` corresponds to `https://production.straddle.io`
+      # - `sandbox` corresponds to `https://sandbox.straddle.com`
+      # - `production` corresponds to `https://production.straddle.com`
       environment: nil,
       # Override the default base URL for the API, e.g.,
       # `"https://api.example.com/v2/"`. Defaults to `ENV["STRADDLE_BASE_URL"]`

data/rbi/straddle/errors.rbi

@@ -33,6 +33,9 @@ module Straddle
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -41,6 +44,7 @@ module Straddle
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -50,6 +54,7 @@ module Straddle
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -59,10 +64,10 @@ module Straddle
     end
 
     class APIConnectionError < Straddle::Errors::APIError
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :status
 
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :body
 
       # @api private
@@ -70,6 +75,7 @@ module Straddle
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -79,6 +85,7 @@ module Straddle
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -93,6 +100,7 @@ module Straddle
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -102,6 +110,7 @@ module Straddle
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,13 +125,22 @@ module Straddle
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -133,13 +151,22 @@ module Straddle
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/straddle/file_part.rbi

@@ -27,7 +27,7 @@ module Straddle
     sig do
       params(
         content: T.any(Pathname, StringIO, IO, String),
-        filename: T.nilable(String),
+        filename: T.nilable(T.any(Pathname, String)),
         content_type: T.nilable(String)
       ).returns(T.attached_class)
     end

data/rbi/straddle/internal/transport/base_client.rbi

@@ -84,10 +84,9 @@ module Straddle
 
           # @api private
           sig do
-            params(
-              status: Integer,
-              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
-            ).returns(T::Boolean)
+            params(status: Integer, headers: T::Hash[String, String]).returns(
+              T::Boolean
+            )
           end
           def should_retry?(status, headers:)
           end
@@ -97,7 +96,7 @@ module Straddle
             params(
               request: Straddle::Internal::Transport::BaseClient::RequestInput,
               status: Integer,
-              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+              response_headers: T::Hash[String, String]
             ).returns(Straddle::Internal::Transport::BaseClient::RequestInput)
           end
           def follow_redirect(request, status:, response_headers:)
@@ -177,6 +176,11 @@ module Straddle
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key
@@ -213,7 +217,7 @@ module Straddle
             send_retry_header: T::Boolean
           ).returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
         end
-        private def send_request(
+        def send_request(
           request,
           redirect_count:,
           retry_count:,

data/rbi/straddle/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module Straddle
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private

data/rbi/straddle/internal/type/base_model.rbi

@@ -31,7 +31,7 @@ module Straddle
           #
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
-          sig { params(child: T.self_type).void }
+          sig { params(child: Straddle::Internal::Type::BaseModel).void }
           def inherited(child)
           end
 
@@ -274,9 +274,13 @@ module Straddle
 
         # Create a new instance of a model.
         sig do
-          params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(
-            T.attached_class
-          )
+          params(
+            data:
+              T.any(
+                T::Hash[Symbol, T.anything],
+                Straddle::Internal::Type::BaseModel
+              )
+          ).returns(T.attached_class)
         end
         def self.new(data = {})
         end

data/rbi/straddle/internal/type/base_page.rbi

@@ -30,7 +30,7 @@ module Straddle
           params(
             client: Straddle::Internal::Transport::BaseClient,
             req: Straddle::Internal::Transport::BaseClient::RequestComponents,
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             page_data: T.anything
           ).void
         end

data/rbi/straddle/internal/type/converter.rbi

@@ -90,6 +90,60 @@ module Straddle
           def self.type_info(spec)
           end
 
+          # @api private
+          sig do
+            params(
+              type_info:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          Straddle::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          Straddle::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(Straddle::Internal::Type::Converter::Input),
+                  Straddle::Internal::Type::Converter::Input
+                ),
+              spec:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          Straddle::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          Straddle::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(Straddle::Internal::Type::Converter::Input),
+                  Straddle::Internal::Type::Converter::Input
+                )
+            ).returns(Straddle::Internal::AnyHash)
+          end
+          def self.meta_info(type_info, spec)
+          end
+
           # @api private
           sig do
             params(translate_names: T::Boolean).returns(

data/rbi/straddle/internal/type/union.rbi

@@ -16,7 +16,8 @@ module Straddle
             T::Array[
               [
                 T.nilable(Symbol),
-                T.proc.returns(Straddle::Internal::Type::Converter::Input)
+                T.proc.returns(Straddle::Internal::Type::Converter::Input),
+                Straddle::Internal::AnyHash
               ]
             ]
           )
@@ -25,7 +26,13 @@ module Straddle
         end
 
         # @api private
-        sig { returns(T::Array[[T.nilable(Symbol), T.anything]]) }
+        sig do
+          returns(
+            T::Array[
+              [T.nilable(Symbol), T.anything, Straddle::Internal::AnyHash]
+            ]
+          )
+        end
         protected def derefed_variants
         end
 

data/rbi/straddle/internal/util.rbi

@@ -361,7 +361,7 @@ module Straddle
         # Assumes each chunk in stream has `Encoding::BINARY`.
         sig do
           params(
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             stream: T::Enumerable[String],
             suppress_error: T::Boolean
           ).returns(T.anything)